---
name: x402.tavily.com
description: x402.tavily.com exposes a single web search skill powered by Tavily that returns ranked results, an AI-generated answer summary, and source URLs for a given query. It is designed to give agents access to current, publicly indexed web content that falls outside a model's training data.
host: x402.tavily.com
---

# x402.tavily.com

This host is a thin, pay-per-call wrapper around the Tavily search API. It serves agents that need real-time web search with a synthesized answer and traceable sources. It does one thing: take a natural-language query and return ranked web results plus an optional AI-generated summary. There is no multi-step orchestration, no domain-specific data (finance, on-chain, etc.), and no private-content access.

## When to use this host

Use this host when an agent needs up-to-date information from the public web that is not available in the model's training data, including recent news, current events, or factual lookups requiring source citations. Do not use it for structured data queries such as stock prices, cryptocurrency data, or on-chain metrics — use a dedicated financial or blockchain API instead. Do not use it for content behind logins, intranets, or paywalls not indexed by the public web. If the query can be answered from the model's existing knowledge without a recency requirement, calling this host is unnecessary cost.

## Capabilities

### Web Search and Answer Synthesis

Accepts a natural-language query and returns ranked web results, an AI-generated answer summary, follow-up questions, and source URLs. Supports depth, recency, and domain-exclusion controls.

- **`search-web-tavily`** — Performs a web search using Tavily and returns ranked results, an AI-generated answer summary, and source URLs for a given query.

## Skill reference

### `search-web-tavily`

**Tavily Web Search** — Performs a web search using Tavily and returns ranked results, an AI-generated answer summary, and source URLs for a given query.

*Use when:* Use when an agent needs current web search results, a synthesized answer from multiple sources, or source URLs for a factual query that requires up-to-date information beyond the model's training data.

*Not for:* Do not use for structured data lookups (e.g. stock prices, on-chain data) where a dedicated API exists. Not suitable for private or intranet content not indexed by the web.

**Inputs:**

- `query` (string, required) — The search query string to submit to Tavily.
- `search_depth` (string) — Depth of search: 'basic' for fast results or 'advanced' for deeper retrieval.
- `max_results` (integer) — Maximum number of search result items to return.
- `time_range` (string) — Restrict results to a time window: e.g. 'day', 'week', 'month', 'year'.
- `include_answer` (boolean) — If true, Tavily returns an AI-generated answer string synthesized from the top results.
- `include_raw_content` (boolean) — If true, raw page content is included in each result object.
- `exclude_domains` (array) — List of domains to exclude from search results.

**Returns:** Returns a query echo, an AI-generated answer string, and a results array of ranked web pages each with url, title, content snippet, and relevance score.

**Example:** `{"query":"2024 FIFA Club World Cup official match schedule for Real Madrid (dates, venues)","time_range":"year","max_results":8,"search_depth":"advanced","include_answer":true,"exclude_domains":[],"include_raw_content":false}`

---