Tavily Web Search

Active

by Faro

1 tool

upstream: https://mcp.tavily.com/mcp/

Access fresh web information for research, fact-finding, and up-to-date answers beyond a model's knowledge cutoff. This suite helps agents retrieve relevant sources, filter results by time or site, and gather current context for grounded responses.

Searchweb-searchresearchcurrent-data

Tools (1)

▶tavily_search

Search the live web for any current information — general lookups, research, fact-checks, or the latest news and headlines — returning relevant snippets with source links, structured for direct use by agents and RAG pipelines. Refine results with time range or exact dates, country boosting, domain include/exclude filters, result count, search depth, and optional raw page content or related images.

10 credits/call ($0.01) · Charged only on successful responses.

Example prompts

“Search the web for current information on quantum computing breakthroughs”
“Find recent documentation on the OpenAI Realtime API”
“Get the latest news on the US elections”
“Pull news about Nvidia earnings from the last 7 days”
“Research the current state of EU AI Act enforcement”
“Search reuters.com and bloomberg.com for FOMC coverage this week”
“Find the official changelog for Next.js 15”
“Get today's top headlines on AI regulation”

Parameters

querystringrequired

Search query

topicstringoptionaldefault: "general"

The category of the search. This will determine which of our agents will be used for the search

countrystringoptionaldefault: ""

Boost search results from a specific country. Must be a full country name (e.g., 'United States', 'Japan', 'Germany'). ISO country codes (e.g., 'us', 'jp') are not supported. Available only if topic is general. See https://docs.tavily.com/documentation/api-reference/search for the full list of supported countries.

end_datestringoptionaldefault: ""

Will return all results before the specified end date. Required to be written in the format YYYY-MM-DD

start_datestringoptionaldefault: ""

Will return all results after the specified start date. Required to be written in the format YYYY-MM-DD.

time_rangeoptionaldefault: null

The time range back from the current date to include in the search results

exact_matchoptionaldefault: null

Only return results containing the exact phrase(s) in quotes in your query

max_resultsintegeroptionaldefault: 5

The maximum number of search results to return

search_depthstringoptionaldefault: "basic"

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_imagesbooleanoptionaldefault: false

Include a list of query-related images in the response

exclude_domainsarrayoptionaldefault: []

List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site

include_domainsarrayoptionaldefault: []

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_faviconbooleanoptionaldefault: false

Whether to include the favicon URL for each result

include_raw_contentbooleanoptionaldefault: false

Include the cleaned and parsed HTML content of each search result

include_image_descriptionsbooleanoptionaldefault: false

Include a list of query-related images and their descriptions in the response

API Usage

curl -X POST "https://api.askfaro.com/invoke/tavily/tavily_search" \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "arguments": {
    "query": "<query>"
  }
}'

CLI Usage

faro invoke tavily/tavily_search --params '{"query":"<query>"}'

Install pip install askfaro-cli, then faro auth login.

▶README

Tavily Web Search

Fresh web search built for agent workflows — returns relevant snippets with source URLs, optional time/site filters, and a synthesized short answer. Useful for grounding LLM responses in current information beyond the model's knowledge cutoff.

`tavily_search`

{
  "query": "latest battery breakthroughs from solid-state startups",
  "search_depth": "advanced",
  "max_results": 10,
  "include_answer": true,
  "time_range": "month",
  "include_domains": ["techcrunch.com", "theverge.com"]
}

Useful options

query — natural-language query.
search_depth — basic (faster, cheaper) or advanced (deeper retrieval).
max_results — number of source results to return (1–20).
include_answer — set true to get a one-paragraph synthesized answer alongside the sources.
time_range — day, week, month, year.
include_domains / exclude_domains — narrow or filter the source set.

Pricing

10 credits (≈ $0.01) per call, charged only on a successful response. advanced depth uses the same per-call cost.

Auth

A Tavily API key on the publisher's Faro connection — no user-side configuration required.