# Tavily

> Web search and page extraction via Tavily.

Default web research stack for agents: fresh search, article reading,
broader source discovery.

## What it can do

| Method | What it does |
| --- | --- |
| `tavily_search` | Tavily web search. Provide a natural-language query; returns a list of results with title, url, and snippet. Use this for fresh web research and to gather external sources with links. |
| `tavily_search_advanced` | Tavily advanced web search. Same as tavily_search, but always uses search_depth='advanced' for deeper, higher-quality results. Use this when doing important research where quality matters more than speed. |
| `tavily_search_with_images` | Tavily web search preferring results with images. Same as tavily_search but with include_images=true. Use this when you specifically need pages with rich visual content or illustrations. |
| `tavily_site_search` | Tavily site-specific search. Restricts results to a given domain using a site:example.com style query. Use this when you want to search only within one website (docs, blog, vendor site, and similar). |
| `tavily_extract` | Extract and clean the main text content from a single web page by URL. Returns plain text limited by max_chars. Use this to read articles or documentation pages in detail. |
| `tavily_crawl` | Lightweight Tavily-based crawl: performs a broader search (optionally restricted to a single site) and aggregates multiple results. Use this to collect many URLs and snippets for a topic, then summarize yourself. |

## How to get credentials

1. Sign up at [tavily.com](https://tavily.com).
2. Open the dashboard and copy your **API key**.
3. Paste it in FlyMyAI when configuring the MCP.

Free tier covers small agent workloads. For production, upgrade on the
pricing page.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `Tavily API key` | tavily.com → Dashboard → API keys |

## Troubleshooting

- **401** - key is wrong or disabled. Rotate it from the dashboard.
- **429** - monthly quota exhausted. Wait for reset or upgrade plan.

## Links

- [Tavily dashboard](https://app.tavily.com/)
- [API reference](https://docs.tavily.com/docs/rest-api/api-reference)