Agent Web Search MCP Server
by jerryliu369io.github.JerryLiu369/agent-web-searchv0.8.0
Provider-neutral web search aggregating model grounding (Gemini, Grok, DeepSeek and others) and search APIs such as Exa, Brave, Perplexity and Tavily.
context tax
queued
security
queued
cold start
queued
freshness
Active7d ago
Install Agent Web Search MCP server
Install in Claude Code
claude mcp add agent-web-search -e ARK_API_KEY='<ark-api-key>' -e GEMINI_API_KEY='<gemini-api-key>' -e XAI_API_KEY='<xai-api-key>' -e DEEPSEEK_API_KEY='<deepseek-api-key>' -e AGENT_WEB_SEARCH_RESPONSES_API_KEY='<agent-web-search-responses-api-key>' -e AGENT_WEB_SEARCH_MESSAGES_API_KEY='<agent-web-search-messages-api-key>' -e TAVILY_API_KEY='<tavily-api-key>' -e BRAVE_SEARCH_API_KEY='<brave-search-api-key>' -e PERPLEXITY_API_KEY='<perplexity-api-key>' -e YDC_API_KEY='<ydc-api-key>' -e EXA_API_KEY='<exa-api-key>' -e PARALLEL_API_KEY='<parallel-api-key>' -e ZHIPU_WEB_SEARCH_API_KEY='<zhipu-web-search-api-key>' -e ZHIPU_CHAT_SEARCH_API_KEY='<zhipu-chat-search-api-key>' -- uvx agent-web-search-mcpInstall in Cursor
{
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"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>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"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 .vscode/mcp.json in your workspace.
Install in Windsurf
{
"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 ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| AGENT_WEB_SEARCH_PROVIDERS | — | — | Comma-separated startup-enabled provider set; defaults to ddgs,exa,parallel (all keyless) |
| ARK_API_KEY | — | yes | Volcengine Ark API key for Doubao grounding |
| GEMINI_API_KEY | — | yes | Google Gemini API key for Google Search grounding |
| XAI_API_KEY | — | yes | xAI API key for Grok web/X search |
| DEEPSEEK_API_KEY | — | yes | DeepSeek API key for native web search |
| AGENT_WEB_SEARCH_RESPONSES_API_KEY | — | yes | Generic Responses API key for web search grounding (falls back to OPENAI_API_KEY) |
| AGENT_WEB_SEARCH_RESPONSES_BASE_URL | — | — | Generic Responses API base URL; defaults to https://api.openai.com/v1 |
| AGENT_WEB_SEARCH_MESSAGES_API_KEY | — | yes | Generic Anthropic Messages API key for web search grounding |
| AGENT_WEB_SEARCH_MESSAGES_BASE_URL | — | — | Generic Anthropic Messages API base URL; defaults to https://api.anthropic.com |
| TAVILY_API_KEY | — | yes | Tavily API key for agent-oriented search |
| BRAVE_SEARCH_API_KEY | — | yes | Brave Search API key |
| PERPLEXITY_API_KEY | — | yes | Perplexity API key for structured search |
| YDC_API_KEY | — | yes | You.com API key |
| EXA_API_KEY | — | yes | Optional Exa key; free MCP fallback without it |
| PARALLEL_API_KEY | — | yes | Optional Parallel key; free MCP fallback without it |
| ZHIPU_WEB_SEARCH_API_KEY | — | yes | Zhipu standalone Web Search API key |
| ZHIPU_CHAT_SEARCH_API_KEY | — | yes | Zhipu Chat Completions native web search key |
Freshness
Active — last maintenance signal 7d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-02 · 7d ago · GitHub
Latest release
2026-10-01 · 9d ago · GitHub · v0.8.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-01 · 9d ago · official registry · v0.8.0
FAQ
›How do I install the Agent Web Search MCP server in Claude Code?
Run: claude mcp add agent-web-search -e ARK_API_KEY='<ark-api-key>' -e GEMINI_API_KEY='<gemini-api-key>' -e XAI_API_KEY='<xai-api-key>' -e DEEPSEEK_API_KEY='<deepseek-api-key>' -e AGENT_WEB_SEARCH_RESPONSES_API_KEY='<agent-web-search-responses-api-key>' -e AGENT_WEB_SEARCH_MESSAGES_API_KEY='<agent-web-search-messages-api-key>' -e TAVILY_API_KEY='<tavily-api-key>' -e BRAVE_SEARCH_API_KEY='<brave-search-api-key>' -e PERPLEXITY_API_KEY='<perplexity-api-key>' -e YDC_API_KEY='<ydc-api-key>' -e EXA_API_KEY='<exa-api-key>' -e PARALLEL_API_KEY='<parallel-api-key>' -e ZHIPU_WEB_SEARCH_API_KEY='<zhipu-web-search-api-key>' -e ZHIPU_CHAT_SEARCH_API_KEY='<zhipu-chat-search-api-key>' -- uvx agent-web-search-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Agent Web Search require an API key?
Yes. It expects ARK_API_KEY, GEMINI_API_KEY, XAI_API_KEY, DEEPSEEK_API_KEY, AGENT_WEB_SEARCH_RESPONSES_API_KEY, AGENT_WEB_SEARCH_MESSAGES_API_KEY, TAVILY_API_KEY, BRAVE_SEARCH_API_KEY, PERPLEXITY_API_KEY, YDC_API_KEY, EXA_API_KEY, PARALLEL_API_KEY, ZHIPU_WEB_SEARCH_API_KEY, ZHIPU_CHAT_SEARCH_API_KEY, of which 14 are secrets.
›Can I use Agent Web Search as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Agent Web Search in the official MCP registry?
Yes, as io.github.JerryLiu369/agent-web-search.
Alternatives to Agent Web Search
Other web search MCP servers.
FetchActiveWeb content fetching and conversion for efficient LLM usage
Claude FlowActiveAI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.
Serena AgentActiveA powerful toolkit for coding, providing semantic retrieval and editing capabilities.
TrycuaActiveMCP server for the Computer-Use Agent (CUA), allowing you to run CUA through Claude Desktop or other MCP clients.
Claude Task MasterSlowingTask management for AI-driven development: PRD parsing, task expansion, multi-provider support and selective tool loading to save context.
CorsairdevActiveMCP server and framework adapters for Corsair. Expose 200+ integrations to any agent framework (Mastra, LangChain, LlamaIndex, OpenAI, Vercel AI, Claude) as tools.