Skip to main content
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.
  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.