# Tavily MCP

AI-powered search API for real-time web search, extraction, and crawling optimized for AI agents.

- **Category:** model context protocol
- **Auth:** DCR_OAUTH
- **Composio Managed App Available?** No
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `TAVILY_MCP`
- **Version:** 20260303_09

## Tools

### Tavily crawl

**Slug:** `TAVILY_MCP_TAVILY_CRAWL`

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The root URL to begin the crawl |
| `limit` | integer | No | Total number of links the crawler will process before stopping |
| `format` | string ("markdown" | "text") | No | The format of the extracted web page content. markdown returns content in markdown format. text returns plain text and may increase latency. |
| `max_depth` | integer | No | Max depth of the crawl. Defines how far from the base URL the crawler can explore. |
| `max_breadth` | integer | No | Max number of links to follow per level of the tree (i.e., per page) |
| `instructions` | string | No | Natural language instructions for the crawler. Instructions specify which types of pages the crawler should return. |
| `select_paths` | array | No | Regex patterns to select only URLs with specific path patterns (e.g., /docs/.*, /api/v1.*) |
| `extract_depth` | string ("basic" | "advanced") | No | Advanced extraction retrieves more data, including tables and embedded content, with higher success but may increase latency |
| `allow_external` | boolean | No | Whether to return external links in the final response |
| `select_domains` | array | No | Regex patterns to restrict crawling to specific domains or subdomains (e.g., ^docs\.example\.com$) |
| `include_favicon` | boolean | No | Whether to include the favicon URL for each result |

### Tavily extract

**Slug:** `TAVILY_MCP_TAVILY_EXTRACT`

Extract content from URLs. Returns raw page content in markdown or text format.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `urls` | array | Yes | List of URLs to extract content from |
| `query` | string | No | Query to rerank content chunks by relevance |
| `format` | string ("markdown" | "text") | No | Output format |
| `extract_depth` | string ("basic" | "advanced") | No | Use 'advanced' for LinkedIn, protected sites, or tables/embedded content |
| `include_images` | boolean | No | Include images from pages |
| `include_favicon` | boolean | No | Include favicon URLs |

### Tavily map

**Slug:** `TAVILY_MCP_TAVILY_MAP`

Map a website's structure. Returns a list of URLs found starting from the base URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The root URL to begin the mapping |
| `limit` | integer | No | Total number of links the crawler will process before stopping |
| `max_depth` | integer | No | Max depth of the mapping. Defines how far from the base URL the crawler can explore |
| `max_breadth` | integer | No | Max number of links to follow per level of the tree (i.e., per page) |
| `instructions` | string | No | Natural language instructions for the crawler |
| `select_paths` | array | No | Regex patterns to select only URLs with specific path patterns (e.g., /docs/.*, /api/v1.*) |
| `allow_external` | boolean | No | Whether to return external links in the final response |
| `select_domains` | array | No | Regex patterns to restrict crawling to specific domains or subdomains (e.g., ^docs\.example\.com$) |

### Tavily research

**Slug:** `TAVILY_MCP_TAVILY_RESEARCH`

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources, including web pages, documents, and other resources, to answer a question or complete a task. Returns a detailed response based on the research findings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | A comprehensive description of the research task |
| `model` | string ("mini" | "pro" | "auto") | No | Defines the degree of depth of the research. 'mini' is good for narrow tasks with few subtopics. 'pro' is good for broad tasks with many subtopics |

### Tavily search

**Slug:** `TAVILY_MCP_TAVILY_SEARCH`

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Search query |
| `topic` | string | No | The category of the search. This will determine which of our agents will be used for the search |
| `country` | string | No | Boost search results from a specific country. This will prioritize content from the selected country in the search results. Available only if topic is general. |
| `end_date` | string | No | Will return all results before the specified end date. Required to be written in the format YYYY-MM-DD |
| `start_date` | string | No | Will return all results after the specified start date. Required to be written in the format YYYY-MM-DD. |
| `time_range` | string | No | The time range back from the current date to include in the search results |
| `max_results` | integer | No | The maximum number of search results to return |
| `search_depth` | string ("basic" | "advanced" | "fast" | "ultra-fast") | No | The depth of the search. 'basic' for generic results, 'advanced' for more thorough search, 'fast' for optimized low latency with high relevance, 'ultra-fast' for prioritizing latency above all else |
| `include_images` | boolean | No | Include a list of query-related images in the response |
| `exclude_domains` | array | No | List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site |
| `include_domains` | array | No | A list of domains to specifically include in the search results, if the user asks to search on specific sites set this to the domain of the site |
| `include_favicon` | boolean | No | Whether to include the favicon URL for each result |
| `include_raw_content` | boolean | No | Include the cleaned and parsed HTML content of each search result |
| `include_image_descriptions` | boolean | No | Include a list of query-related images and their descriptions in the response |