`tavily_web_search` $0.02 per call

Search the open web. Search the web with semantic ranking, optional answers, domain and date filters, images, and page content. (Tavily · Open web & SEO data)

For AI agents: call tavily_web_search

POST https://toll402.dev/v1/p/tavily.web.search
{
 "query": "recent changes to the EU AI Act guidance",
 "search_depth": "basic",
 "max_results": 3,
 "include_usage": true
}

Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "examples": [
    "recent changes to the EU AI Act guidance"
   ]
  },
  "search_depth": {
   "type": "string",
   "description": "Basic, fast and ultra-fast cost 1 credit; advanced costs 2. auto_parameters can raise a basic request to the advanced price.",
   "default": "basic",
   "enum": [
    "basic",
    "advanced",
    "fast",
    "ultra-fast"
   ],
   "examples": [
    "basic"
   ]
  },
  "chunks_per_source": {
   "type": "integer",
   "default": 3
  },
  "max_results": {
   "type": "integer",
   "default": 10,
   "examples": [
    5
   ]
  },
  "topic": {
   "type": "string",
   "default": "general",
   "enum": [
    "general",
    "news",
    "finance"
   ]
  },
  "time_range": {
   "type": "string",
   "enum": [
    "day",
    "week",
    "month",
    "year",
    "d",
    "w",
    "m",
    "y"
   ]
  },
  "start_date": {
   "type": "string",
   "description": "YYYY-MM-DD; must precede end_date."
  },
  "end_date": {
   "type": "string",
   "description": "YYYY-MM-DD; must follow start_date."
  },
  "include_published_date": {
   "type": "boolean",
   "default": false
  },
  "filter_by_published_date": {
   "type": "boolean",
   "default": false
  },
  "include_answer": {
   "type": "string",
   "description": "false, true, basic, or advanced",
   "default": false
  },
  "include_raw_content": {
   "type": "string",
   "description": "false, true, markdown, or text",
   "default": false
  },
  "include_images": {
   "type": "boolean",
   "default": false
  },
  "include_image_descriptions": {
   "type": "boolean",
   "default": false
  },
  "include_favicon": {
   "type": "boolean",
   "default": false
  },
  "include_domains": {
   "type": "string"
  },
  "exclude_domains": {
   "type": "string"
  },
  "include_domains_mode": {
   "type": "string",
   "enum": [
    "restrict",
    "prefer"
   ]
  },
  "country": {
   "type": "string",
   "description": "Country name accepted by Tavily; available for general search."
  },
  "language": {
   "type": "string",
   "default": "en"
  },
  "filter_by_language": {
   "type": "boolean",
   "default": false
  },
  "auto_parameters": {
   "type": "boolean",
   "default": false
  },
  "exact_match": {
   "type": "boolean",
   "default": false
  },
  "include_usage": {
   "type": "boolean",
   "description": "Optional with your own key; platform Search requires true so treg can settle from this request's reported usage.",
   "enum": [
    true
   ],
   "examples": [
    true
   ]
  },
  "safe_search": {
   "type": "boolean",
   "default": false
  }
 },
 "additionalProperties": true,
 "required": [
  "query"
 ],
 "description": "Results are ranked web pages with title, URL, content, score and optional raw content, publication date, favicon and images. HTTP 432 is the plan cap; 433 is the PAYGO cap."
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI

tavily_web_search $0.02 per call

Input schema

MCP

`tavily_web_search` $0.02 per call