Agent Web Search
One web_search tool over grounding APIs and agent search services, keyless by default
- 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-mcpAdd 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 groundingGEMINI_API_KEYGoogle Gemini API key for Google Search groundingXAI_API_KEYxAI API key for Grok web/X searchDEEPSEEK_API_KEYDeepSeek API key for native web searchAGENT_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/v1AGENT_WEB_SEARCH_MESSAGES_API_KEYGeneric Anthropic Messages API key for web search groundingAGENT_WEB_SEARCH_MESSAGES_BASE_URLGeneric Anthropic Messages API base URL; defaults to https://api.anthropic.comTAVILY_API_KEYTavily API key for agent-oriented searchBRAVE_SEARCH_API_KEYBrave Search API keyPERPLEXITY_API_KEYPerplexity API key for structured searchYDC_API_KEYYou.com API keyEXA_API_KEYOptional Exa key; free MCP fallback without itPARALLEL_API_KEYOptional Parallel key; free MCP fallback without itZHIPU_WEB_SEARCH_API_KEYZhipu standalone Web Search API keyZHIPU_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.



