> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sonar Web Search

> Add Sonar Web Search to an agent and control its search context size and location

Sonar Web Search gives your agent built-in web search when using a Perplexity agent model in the Fetch Hive editor.

## What it does

This tool helps a Perplexity-powered agent search the web when you explicitly add **Sonar Web Search** to the agent. Unlike legacy Sonar prompt runs, agents do not search automatically — web search only runs when this tool is enabled.

The separate **Perplexity Search** tool uses the standalone Search API for
cross-provider structured results; this page covers only the native Sonar
agent search path.

## Adding the tool to an agent

1. Open an agent that uses a Perplexity model.
2. Click the button with the tooltip **Add MCP Tool or Sub Agent**.
3. In **MCP Tools**, click **Sonar Web Search**.

After you add the tool, select the **Sonar Web Search** node to open its settings sheet.

## Configuration

Sonar Web Search exposes two configuration fields in the settings sheet.

| Option               | Description                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------- |
| **Context Size**     | Controls how much search context Fetch Hive returns to the agent. The default is **Medium**.      |
| **Location Country** | Targets the search to a supported country in the settings list. The default is **United States**. |

1. Select the **Sonar Web Search** node in the editor.
2. Set **Context Size** to **Low**, **Medium**, or **High**.
3. Set **Location Country** to the country you want to target.

## Billing

Sonar Web Search is billed as a hosted LLM tool completion (similar to Anthropic Web Search), not against the provider-tool daily cap used by SERP API or Google Search.

## Related

* [Overview](./overview) — model compatibility matrix
* [GPT Search](./gpt-search) — OpenAI-native web search tool
* [Perplexity Search](./perplexity-search-api) — standalone Search API tool available across model providers