Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Create a Tavily account: Go to https://app.tavily.com and sign up - the free plan includes monthly API credits, enough for testing.
  2. Copy your API key: Your default API key is shown on the dashboard home (https://app.tavily.com/home); create additional keys per project if needed.
  3. Store the key: Add it to your .env file as TAVILY_API_KEY=tvly-…
  4. Verify access: Run the Search tool with a simple query. A 401 means the key is invalid; a 432 means you exceeded your plan limit.

Provider notes

  • All endpoints consume API credits per request; advanced search/extract depth costs more than basic
  • Crawl runs synchronously and can take a while on large sites - keep max_depth and limit small
Provider API reference.

Tools

Verify the connection

Call a read tool such as tavily__search with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.