At a glance
- Availability: Experimental (how to enable).
- Authentication: API key.
- Connection: The key comes from
TAVILY_API_KEY. - Provider documentation: Authentication reference.
Credentials
Set these per environment. See Connect an integration.Setup
- Create a Tavily account: Go to https://app.tavily.com and sign up - the free plan includes monthly API credits, enough for testing.
- 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.
- Store the key: Add it to your .env file as TAVILY_API_KEY=tvly-…
- 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
Tools
Verify the connection
Call a read tool such astavily__search with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.