Agent Web Search MCP Server

io.github.JerryLiu369/agent-web-search

Repository Registry

What is the Agent Web Search MCP server?

Provider-neutral web_search for AI agents. Grounding + agent search APIs, keyless defaults.

How to install Agent Web Search

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

AGENT_WEB_SEARCH_PROVIDERS
Comma-separated startup-enabled provider set; defaults to ddgs,exa,parallel (all keyless)
ARK_API_KEY
secret
Volcengine Ark API key for Doubao grounding
GEMINI_API_KEY
secret
Google Gemini API key for Google Search grounding
XAI_API_KEY
secret
xAI API key for Grok web/X search
DEEPSEEK_API_KEY
secret
DeepSeek API key for native web search
TAVILY_API_KEY
secret
Tavily API key for agent-oriented search
BRAVE_SEARCH_API_KEY
secret
Brave Search API key
PERPLEXITY_API_KEY
secret
Perplexity API key for structured search
YDC_API_KEY
secret
You.com API key
EXA_API_KEY
secret
Optional Exa key; free MCP fallback without it
PARALLEL_API_KEY
secret
Optional Parallel key; free MCP fallback without it
ZHIPU_WEB_SEARCH_API_KEY
secret
Zhipu standalone Web Search API key
ZHIPU_CHAT_SEARCH_API_KEY
secret
Zhipu Chat Completions native web search key

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "AGENT_WEB_SEARCH_PROVIDERS": "<YOUR_AGENT_WEB_SEARCH_PROVIDERS>",
        "ARK_API_KEY": "<YOUR_ARK_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "XAI_API_KEY": "<YOUR_XAI_API_KEY>",
        "DEEPSEEK_API_KEY": "<YOUR_DEEPSEEK_API_KEY>",
        "TAVILY_API_KEY": "<YOUR_TAVILY_API_KEY>",
        "BRAVE_SEARCH_API_KEY": "<YOUR_BRAVE_SEARCH_API_KEY>",
        "PERPLEXITY_API_KEY": "<YOUR_PERPLEXITY_API_KEY>",
        "YDC_API_KEY": "<YOUR_YDC_API_KEY>",
        "EXA_API_KEY": "<YOUR_EXA_API_KEY>",
        "PARALLEL_API_KEY": "<YOUR_PARALLEL_API_KEY>",
        "ZHIPU_WEB_SEARCH_API_KEY": "<YOUR_ZHIPU_WEB_SEARCH_API_KEY>",
        "ZHIPU_CHAT_SEARCH_API_KEY": "<YOUR_ZHIPU_CHAT_SEARCH_API_KEY>"
      }
    }
  }
}