Tavily MCP server
Tavily is a search and extraction API for pulling current information from the web, used by agents and research tools that need fresh answers rather than a static index. Connect through Arc0 to use the actions your identity is allowed to call.
Agent workflows for Tavily.
Search the web
Search the web, news or finance via Tavily: up to 20 ranked results with snippets, optional page text and short answer. Use when sources are unknown or current facts are needed. 1 credit (2 advanced). A timed-out or lost call may still be charged; a retry spends again.
Extract page content
Extract markdown or text from up to 20 known URLs, optionally reranked to query-relevant chunks; failed URLs are listed. Use when the URLs are known. 1 credit per 5 extracted URLs (2 advanced). A timed-out or lost call may still be charged; a retry spends again.
Map a website
List up to 200 URLs of a website by following its links, optionally focused by instructions or path patterns, without reading pages. Use when a site structure is needed first. 1 credit per 10 pages (2 with instructions). A timed-out or lost call may still be charged; a retry spends again.
8 Tavily actions, graded by risk.
These actions come from the Arc0 registry. Your identity, provider permissions and Arc0 policies determine which actions can run.
read
7Look things up, subject to your permissions.
- tavily.searchSearch the web
Search the web, news or finance via Tavily: up to 20 ranked results with snippets, optional page text and short answer. Use when sources are unknown or current facts are needed. 1 credit (2 advanced). A timed-out or lost call may still be charged; a retry spends again.
- tavily.extractExtract page content
Extract markdown or text from up to 20 known URLs, optionally reranked to query-relevant chunks; failed URLs are listed. Use when the URLs are known. 1 credit per 5 extracted URLs (2 advanced). A timed-out or lost call may still be charged; a retry spends again.
- tavily.map_siteMap a website
List up to 200 URLs of a website by following its links, optionally focused by instructions or path patterns, without reading pages. Use when a site structure is needed first. 1 credit per 10 pages (2 with instructions). A timed-out or lost call may still be charged; a retry spends again.
- tavily.crawl_siteCrawl a website
Crawl a site from a root URL and return up to 20 pages of content, optionally focused by instructions or paths. Use when many pages of one site must be read. Credits: map (1/10 pages) plus extract (1/5 pages, 2 advanced). A timed-out or lost call may still be charged; a retry spends again.
- tavily.get_researchGet a research task
Get the status of a Tavily research task by request_id and, once completed, its report and sources. Use when polling a task started with create_research; pending or in_progress means try again later. Free.
- tavily.get_usageGet credit usage
Get this Tavily key's and account's credits used and limits in the current billing cycle, per endpoint, plus the plan name. Use when the user asks how many credits are left or before a costly crawl or research task. Free; limited to 10 calls per 10 minutes.
- tavily.list_request_logsList request logs
List this key's recent Tavily requests, newest first, with endpoint, depth, credits and response time (never inputs or outputs). Use when the user asks what spent their credits. Paid plans only; free.
write
1Create and change things. Allow, or ask the user first.
- tavily.create_researchStart a research task
Start an async research task that writes a cited report (optionally JSON-schema shaped); poll its request_id with get_research. Use when a cited synthesis is wanted. 4-250 credits. A lost or timed-out call may have created a charged task: check get_usage before any retry.
destructive
0Delete, cancel or archive. Ask first, or deny outright.
- No destructive actions.
Control access to Tavily.
Connect the intended Tavily account, authorize your AI client and set policies for its tools.
Provider permissions and Arc0 policy both apply. Allow reads, require approval for selected writes, or deny destructive actions. The audit log records execution decisions.
Configure policies and approvalsExample policy choices
- Read actions: allow where authorized
- tavily.create_research: require approval
Arc0 MCP endpoint: https://api.arc0.ai/mcp
How Tavily connects.
Connect Tavily using API key. OAuth grants the provider scopes shown during consent; API keys and other credentials retain the permissions configured at the provider. Arc0 stores credentials in its encrypted vault and does not pass them to the model. Disconnect to remove access through Arc0; revoke a key at the provider to invalidate it there. Token refresh and provider-side revocation depend on the authentication lane and provider.
The connection serves authorized calls through Arc0 MCP and REST. How Arc0 handles credentials →
- AUTH
- API key
- CREDENTIALS
- Per-tenant encrypted vault
- MODEL SEES
- Results only, never credentials
- AUDIT LOG
- Every call, on every plan
Use Tavily with your AI client.
Sign in to Arc0 and connect Tavily in My apps. Then authorize your AI client separately. It only receives tools and accounts allowed for that identity.
Tavily with Claude
Claude Desktop + Claude Code
- In Claude Desktop, add Arc0 through the remote MCP settings and use OAuth. Follow the generic remote-client steps if your account’s interface differs.
- For Claude Code, run the command below. Open /mcp, select Arc0, and authenticate in your browser. Select your workspace and review access.
- Check the connection with claude mcp get arc0.
claude mcp add --transport http --scope user arc0 https://api.arc0.ai/mcpFull MCP setup and troubleshootingTavily with ChatGPT
ChatGPT on the web
- Open Plugins in ChatGPT, select the plus button, then Add custom MCP server.
- Name it Arc0, enter the server URL below, and choose OAuth. Use dynamic client registration if asked; no Arc0 API key is needed.
- Review the notice and select Create as a plugin. Complete Arc0 sign-in, workspace selection and consent, then install and select the plugin in your conversation. Labels and access vary by account; managed workspaces may require administrator approval.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingTavily with OpenAI Codex
Codex app + CLI
- Run the registration command below. The app and CLI share ~/.codex/config.toml.
- Complete browser OAuth, choose your Arc0 workspace, and review access. If authentication does not start, run codex mcp login arc0.
- Check codex mcp list, then open a new Codex chat. Inspect an existing arc0 entry before changing it.
codex mcp add arc0 --url https://api.arc0.ai/mcpFull MCP setup and troubleshootingTavily with Cursor
Remote MCP setup
- Add Arc0 in your client’s remote MCP settings using the server URL below.
- Choose OAuth, sign in to Arc0, select the intended workspace and review access.
- Confirm the server is connected and start with an allowed read. These are generic remote-MCP steps; consult your client’s settings for its current interface.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingTavily with VS Code
Remote MCP setup
- Add a remote HTTP MCP server named Arc0 using the URL below.
- Use OAuth and finish Arc0 sign-in, workspace selection and consent.
- Confirm discovery succeeds before requesting a read. These are generic remote-MCP steps; client UI and availability may differ.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingTavily with Any MCP client
Streamable HTTP
- Use a client that supports remote MCP over Streamable HTTP. Add the server URL below and choose OAuth.
- For a client without OAuth, use a self-bound API key with execute permission in the X-API-Key header. Store it in secret storage or an environment variable, outside source control. Never send both an API key and an OAuth bearer token.
- Use the MCP clients guide for the SDK transport example and Embedded identity for business-managed end users.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingAfter setup, ask your agent to find an allowed read action, load its schema, and execute it on the intended account. Check Activity for the receipt. A connected MCP client alone does not confirm a successful provider call.
Tavily and Arc0, answered.
Does Tavily work with Claude Desktop and Claude Code?
Yes, after connecting the account and authorizing the client. Use Arc0’s remote MCP endpoint with OAuth. Claude Code has a documented registration command; Desktop uses the generic remote-client setup.
Can I use Tavily with OpenAI Codex, ChatGPT and Cursor?
Yes, after connecting the account and authorizing the client. Codex and ChatGPT have setup instructions in Arc0’s MCP clients guide. Cursor uses the generic remote-MCP steps. Tool access remains scoped to the authorized identity.
Is this the official Tavily MCP server?
This is Arc0’s integration page, not a claim of an official Tavily server. Arc0 adds a shared connection, policy and audit experience across apps. Consult Tavily for its own current MCP offerings.
Which Tavily actions are supported?
8 registry-defined actions: 7 read, 1 write and 0 destructive. Provider permissions, access enablement and Arc0 policy determine what can execute.
Which permissions does Tavily need?
Connect Tavily using API key. OAuth grants the provider scopes shown during consent; API keys and other credentials retain the permissions configured at the provider. Arc0 stores credentials in its encrypted vault and does not pass them to the model. Disconnect to remove access through Arc0; revoke a key at the provider to invalidate it there. Token refresh and provider-side revocation depend on the authentication lane and provider.
Can I restrict writes in Tavily?
You can deny write and destructive actions or require approval. Provider scopes and Arc0 action policies are separate controls; a policy does not grant additional provider permissions.
What does Tavily through Arc0 cost?
See Arc0 pricing for current connectivity plans. The provider may require its own subscription or charge per request. Arc0 plan allowances do not make third-party data or paid actions free.
Plug Tavily into your agent.
Tavily MCP server: 8 actions including search the web, extract page content, map a website. Connect through Arc0.
Free to build · MCP + REST · Audit log on every plan
Tavily and its logo are trademarks of their respective owners. Arc0 is not affiliated with or endorsed by Tavily.