Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Tavily in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Give your AI live web search built for agents with Tavily: search the web or the news with a short answer and sources, read pages as clean text, map and crawl websites, run longer research jobs and check your credits.
Try asking
Example prompts for Tavily
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Tavily, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Tavily + ChatGPT
Give your AI live web search built for agents with Tavily: search the web or the news with a short answer and sources, read pages as clean text, map and crawl websites, run longer research jobs and check your credits.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
TAVILY_API_KEY
Step 1 — Get credentials
- Sign in at
https://app.tavily.com. The free plan includes 1,000 credits a month and needs no card. - Copy the API key from the overview page (it starts with
tvly-), or create a new one. - Paste it into
TAVILY_API_KEYas Tavily shows it, without the word Bearer, and install the connector. The key is sent only to Tavily. - Start with
tavily_get_usage: it shows the credits your key and your plan have used and what is left.
Billed to your own Tavily credits: searches, extractions, maps, crawls and research reports spend credits from your Tavily account, and every answer reports what it used. The connector keeps the cheap defaults unless you ask for more:
- Search: 1 credit for a basic search, 2 for an advanced one.
- Extraction: 1 credit per 5 pages, 2 with advanced extraction.
- Map: 1 credit per 10 pages found.
- Crawl: the map plus the extraction of the pages it reads.
- Research report: 4 to 110 credits with the mini model, 15 to 250 with pro.
What it does: web, news and finance search with ranked sources and an optional short answer, limited by date or to the domains you choose; the content of up to 20 pages as clean markdown, or just the passages that answer a question; the list of a website's pages (map), or map and extraction in one go (crawl); and research reports that Tavily's research agent writes from many searches, which take from about 30 seconds to a few minutes.
Time limit: a call through the connector stops after 30 seconds, so crawls and maps use small limits by default. Research runs in the background: the AI starts it and checks back until the report is ready.
Untrusted content: search results and pages come from the open web. The AI treats instructions it finds inside them as data, not as orders.
Common errors: 401 means the key is wrong, revoked or missing. 432: the key or the plan has used up its credits; upgrade the plan or raise the key's limit in the Tavily dashboard. 433: the pay-as-you-go limit of the account is reached; raise it in the dashboard. 429: too many requests in a short time. 400 or 422: a parameter is invalid, for example a date not written as YYYY-MM-DD.
The connector does not stream research reports, read the request logs or manage organisation usage and keys.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in ChatGPT
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.
- Go to chatgpt.com/plugins, click +, then Add custom MCP server.
- Enter a name, e.g. Name:
Tavily. - Under Connection, enter the Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDand keep Authentication on OAuth. - Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
- Install the new plugin from your personal plugins, then type @ in a chat and pick it.
Available tools
| Tool | What it does |
|---|---|
tavily_search | Search the web with Tavily and get ranked sources with a relevant snippet each, and optionally a short answer written from them |
tavily_extract | Read up to 20 web pages with Tavily and get their content as clean markdown or text |
tavily_map | List the URLs of a website with Tavily, starting from one address, to find the right pages before extracting them |
tavily_crawl | Crawl a website with Tavily from one address and get the content of each page found, as markdown |
tavily_start_research | Start a Tavily research job: an agent runs many searches and writes a report with sources |
tavily_get_research | Get the status and, once completed, the report and sources of a Tavily research job started with tavily_start_research. status is pending… |
tavily_get_usage | Show how many Tavily credits this API key and the account's plan have used in the current billing cycle and their limits, split by search… |
Example prompts
- "Search the news from the past week about EU AI Act enforcement and give me a short summary with sources."
- "Read these three pricing pages and put the plans side by side in a table."
- "Map the docs section of our website and list every page about authentication."
- "Run a research report on heat pump subsidies in Germany in 2026 and tell me how many credits it used."
FAQ
Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.
Next steps
Was this guide helpful?