Tavily MCP connects to a Nagent workspace. Once it is connected, agents can call 5 Tavily MCP actions, such as "Tavily crawl", "Tavily extract" and "Tavily map". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Tavily MCP, with input parameters and output schema.
TAVILY_MCP_TAVILY_CRAWLCrawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.
Input parameters
The root URL to begin the crawl
Total number of links the crawler will process before stopping
The format of the extracted web page content. markdown returns content in markdown format. text returns plain text and may increase latency.
Max depth of the crawl. Defines how far from the base URL the crawler can explore.
Max number of links to follow per level of the tree (i.e., per page)
Natural language instructions for the crawler. Instructions specify which types of pages the crawler should return.
Regex patterns to select only URLs with specific path patterns (e.g., /docs/.*, /api/v1.*)
Advanced extraction retrieves more data, including tables and embedded content, with higher success but may increase latency
Whether to return external links in the final response
Regex patterns to restrict crawling to specific domains or subdomains (e.g., ^docs\\.example\\.com$)
Whether to include the favicon URL for each result
TAVILY_MCP_TAVILY_EXTRACTExtract content from URLs. Returns raw page content in markdown or text format.
Input parameters
List of URLs to extract content from
Query to rerank content chunks by relevance
Output format
Use 'advanced' for LinkedIn, protected sites, or tables/embedded content
Include images from pages
Include favicon URLs
TAVILY_MCP_TAVILY_MAPMap a website's structure. Returns a list of URLs found starting from the base URL.
Input parameters
The root URL to begin the mapping
Total number of links the crawler will process before stopping
Max depth of the mapping. Defines how far from the base URL the crawler can explore
Max number of links to follow per level of the tree (i.e., per page)
Natural language instructions for the crawler
Regex patterns to select only URLs with specific path patterns (e.g., /docs/.*, /api/v1.*)
Whether to return external links in the final response
Regex patterns to restrict crawling to specific domains or subdomains (e.g., ^docs\\.example\\.com$)
TAVILY_MCP_TAVILY_RESEARCHPerform 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
A comprehensive description of the research task
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_MCP_TAVILY_SEARCHSearch 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
Search query
The category of the search. This will determine which of our agents will be used for the search
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.
Will return all results before the specified end date. Required to be written in the format YYYY-MM-DD
Will return all results after the specified start date. Required to be written in the format YYYY-MM-DD.
The time range back from the current date to include in the search results
The maximum number of search results to return
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 a list of query-related images in the response
List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site
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
Whether to include the favicon URL for each result
Include the cleaned and parsed HTML content of each search result
Include a list of query-related images and their descriptions in the response
Agents can call 5 Tavily MCP actions on Nagent, including "Tavily crawl", "Tavily extract" and "Tavily map". Tavily crawl: Crawl a website starting from a URL. Each action is listed on this page with its input parameters and its output.
Tavily crawl takes 1 required input: url. It also takes 10 optional inputs: limit, format, max_depth, max_breadth, instructions, select_paths, extract_depth, allow_external, select_domains and include_favicon.