Skip to content
MCP server

Agent Web Search

One web_search tool over grounding APIs and agent search services, keyless by default

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.8.2
Listing updated
today

Similar MCP servers

About Agent Web Search

Agent Web Search is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

The README is explicit that this is not a Google, Bing or Baidu metasearch wrapper. Instead of fanning keywords out to result pages, it aggregates search capabilities built for agents: model-native grounding (Responses, ARK, Grok, Gemini, DeepSeek, Messages, Zhipu) and agent search APIs such as Exa, Parallel, Brave, Perplexity, Tavily and You.com. DDGS is the only conventional backend.

DDGS, Exa and Parallel work with no API key; Exa and Parallel fall back to free MCP transports until you provide a key. Selected providers run concurrently, and one provider failing does not discard another's result. Model-backed providers can return a synthesised answer with citations alongside normalised results.

It installs from PyPI as agent-web-search-mcp, and the README recommends a CLI plus Agent Skill route for shell-capable agents, with stdio MCP, Hermes and DeepSeek Harness plugins as alternatives. The project says it has no telemetry and no shared key service.

Install

Run in a terminal

claude mcp add agent-web-search --env ARK_API_KEY='<ARK_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env XAI_API_KEY='<XAI_API_KEY>' --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' --env AGENT_WEB_SEARCH_RESPONSES_API_KEY='<AGENT_WEB_SEARCH_RESPONSES_API_KEY>' --env AGENT_WEB_SEARCH_MESSAGES_API_KEY='<AGENT_WEB_SEARCH_MESSAGES_API_KEY>' --env TAVILY_API_KEY='<TAVILY_API_KEY>' --env BRAVE_SEARCH_API_KEY='<BRAVE_SEARCH_API_KEY>' --env PERPLEXITY_API_KEY='<PERPLEXITY_API_KEY>' --env YDC_API_KEY='<YDC_API_KEY>' --env EXA_API_KEY='<EXA_API_KEY>' --env PARALLEL_API_KEY='<PARALLEL_API_KEY>' --env ZHIPU_WEB_SEARCH_API_KEY='<ZHIPU_WEB_SEARCH_API_KEY>' --env ZHIPU_CHAT_SEARCH_API_KEY='<ZHIPU_CHAT_SEARCH_API_KEY>' -- uvx agent-web-search-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "ARK_API_KEY": "<ARK_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
        "AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
        "TAVILY_API_KEY": "<TAVILY_API_KEY>",
        "BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "PARALLEL_API_KEY": "<PARALLEL_API_KEY>",
        "ZHIPU_WEB_SEARCH_API_KEY": "<ZHIPU_WEB_SEARCH_API_KEY>",
        "ZHIPU_CHAT_SEARCH_API_KEY": "<ZHIPU_CHAT_SEARCH_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "ARK_API_KEY": "<ARK_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
        "AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
        "TAVILY_API_KEY": "<TAVILY_API_KEY>",
        "BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "PARALLEL_API_KEY": "<PARALLEL_API_KEY>",
        "ZHIPU_WEB_SEARCH_API_KEY": "<ZHIPU_WEB_SEARCH_API_KEY>",
        "ZHIPU_CHAT_SEARCH_API_KEY": "<ZHIPU_CHAT_SEARCH_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "agent-web-search": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "ARK_API_KEY": "<ARK_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
        "AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
        "TAVILY_API_KEY": "<TAVILY_API_KEY>",
        "BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "PARALLEL_API_KEY": "<PARALLEL_API_KEY>",
        "ZHIPU_WEB_SEARCH_API_KEY": "<ZHIPU_WEB_SEARCH_API_KEY>",
        "ZHIPU_CHAT_SEARCH_API_KEY": "<ZHIPU_CHAT_SEARCH_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "ARK_API_KEY": "<ARK_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
        "AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
        "TAVILY_API_KEY": "<TAVILY_API_KEY>",
        "BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "PARALLEL_API_KEY": "<PARALLEL_API_KEY>",
        "ZHIPU_WEB_SEARCH_API_KEY": "<ZHIPU_WEB_SEARCH_API_KEY>",
        "ZHIPU_CHAT_SEARCH_API_KEY": "<ZHIPU_CHAT_SEARCH_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "ARK_API_KEY": "<ARK_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>",
        "AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
        "AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
        "TAVILY_API_KEY": "<TAVILY_API_KEY>",
        "BRAVE_SEARCH_API_KEY": "<BRAVE_SEARCH_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "YDC_API_KEY": "<YDC_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "PARALLEL_API_KEY": "<PARALLEL_API_KEY>",
        "ZHIPU_WEB_SEARCH_API_KEY": "<ZHIPU_WEB_SEARCH_API_KEY>",
        "ZHIPU_CHAT_SEARCH_API_KEY": "<ZHIPU_CHAT_SEARCH_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • AGENT_WEB_SEARCH_PROVIDERSComma-separated startup-enabled provider set; defaults to ddgs,exa,parallel (all keyless)
  • ARK_API_KEYVolcengine Ark API key for Doubao grounding
  • GEMINI_API_KEYGoogle Gemini API key for Google Search grounding
  • XAI_API_KEYxAI API key for Grok web/X search
  • DEEPSEEK_API_KEYDeepSeek API key for native web search
  • AGENT_WEB_SEARCH_RESPONSES_API_KEYGeneric Responses API key for web search grounding (falls back to OPENAI_API_KEY)
  • AGENT_WEB_SEARCH_RESPONSES_BASE_URLGeneric Responses API base URL; defaults to https://api.openai.com/v1
  • AGENT_WEB_SEARCH_MESSAGES_API_KEYGeneric Anthropic Messages API key for web search grounding
  • AGENT_WEB_SEARCH_MESSAGES_BASE_URLGeneric Anthropic Messages API base URL; defaults to https://api.anthropic.com
  • TAVILY_API_KEYTavily API key for agent-oriented search
  • BRAVE_SEARCH_API_KEYBrave Search API key
  • PERPLEXITY_API_KEYPerplexity API key for structured search
  • YDC_API_KEYYou.com API key
  • EXA_API_KEYOptional Exa key; free MCP fallback without it
  • PARALLEL_API_KEYOptional Parallel key; free MCP fallback without it
  • ZHIPU_WEB_SEARCH_API_KEYZhipu standalone Web Search API key
  • ZHIPU_CHAT_SEARCH_API_KEYZhipu Chat Completions native web search key

What it does

Provider-neutral contract
MCP tool, CLI and Python API share one request and response shape.
Keyless defaults
DDGS, Exa and Parallel run without credentials.
Model-native grounding
Providers like Gemini, Grok and ARK can return answers with citations.
Concurrent providers
Failure of one backend never discards another's results.
Several integration routes
CLI with Agent Skill, stdio MCP, Hermes plugin and DeepSeek Harness plugin.
No telemetry
Keys stay in environment variables; no shared key service exists.

Good for

  • Give a coding agent web search without paying for an API
  • Get cited answers from several search backends at once
  • Search in Chinese using Chinese model providers
  • Add search to Codex CLI, Claude Code or OpenCode

Pricing

Open source

MIT licence; some providers need their own paid API keys

Agent Web Search FAQ

Do I need API keys?

Not for the defaults: DDGS, Exa and Parallel are keyless.

What does it require?

Python 3.10 or newer; install with `pipx install agent-web-search-mcp`.

Which licence?

The README describes it as open source and MIT-licensed.

How do I try it without installing?

Use `uvx --from agent-web-search-mcp agent-web-search "<question>"`.

Is Agent Web Search free?

Yes. Agent Web Search is open source, so you can use and self-host it for free.

How do I add Agent Web Search to Claude Code?

Run this command in your terminal: claude mcp add agent-web-search --env ARK_API_KEY='<ARK_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env XAI_API_KEY='<XAI_API_KEY>' --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' --env AGENT_WEB_SEARCH_RESPONSES_API_KEY='<AGENT_WEB_SEARCH_RESPONSES_API_KEY>' --env AGENT_WEB_SEARCH_MESSAGES_API_KEY='<AGENT_WEB_SEARCH_MESSAGES_API_KEY>' --env TAVILY_API_KEY='<TAVILY_API_KEY>' --env BRAVE_SEARCH_API_KEY='<BRAVE_SEARCH_API_KEY>' --env PERPLEXITY_API_KEY='<PERPLEXITY_API_KEY>' --env YDC_API_KEY='<YDC_API_KEY>' --env EXA_API_KEY='<EXA_API_KEY>' --env PARALLEL_API_KEY='<PARALLEL_API_KEY>' --env ZHIPU_WEB_SEARCH_API_KEY='<ZHIPU_WEB_SEARCH_API_KEY>' --env ZHIPU_CHAT_SEARCH_API_KEY='<ZHIPU_CHAT_SEARCH_API_KEY>' -- uvx agent-web-search-mcp

What are the best alternatives to Agent Web Search?

The closest alternatives to Agent Web Search are Scrapling MCP Server, Firecrawl MCP Server, Douyin_TikTok_Download_API, SearXNG Search and machine_internet.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers