Agent Web Search MCP
An open-source, provider-neutral web search MCP server that aggregates model-native grounding and agent-oriented search APIs. It allows AI agents to perform semantic search and grounding using providers like Exa, Parallel, and DDGS, supporting integration with Claude Code, Hermes, DeepSeek Harness, and other agents via MCP, CLI, or plugins.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 13 GitHub stars
What you can do with it
- Perform semantic web search for AI agents
- Ground model responses using provider APIs
- Integrate web search into Claude Code or Hermes
- Execute keyless default searches via CLI
Source and maintenance
- Last repository push
- Latest release
- v0.8.1
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
agent-web-search-mcp 0.8.1
{
"version": "0.8.1",
"transport": "stdio",
"identifier": "agent-web-search-mcp",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"environmentVariables": [
{
"name": "AGENT_WEB_SEARCH_PROVIDERS",
"description": "Comma-separated startup-enabled provider set; defaults to ddgs,exa,parallel (all keyless)"
},
{
"name": "ARK_API_KEY",
"description": "Volcengine Ark API key for Doubao grounding"
},
{
"name": "GEMINI_API_KEY",
"description": "Google Gemini API key for Google Search grounding"
},
{
"name": "XAI_API_KEY",
"description": "xAI API key for Grok web/X search"
},
{
"name": "DEEPSEEK_API_KEY",
"description": "DeepSeek API key for native web search"
},
{
"name": "AGENT_WEB_SEARCH_RESPONSES_API_KEY",
"description": "Generic Responses API key for web search grounding (falls back to OPENAI_API_KEY)"
},
{
"name": "AGENT_WEB_SEARCH_RESPONSES_BASE_URL",
"description": "Generic Responses API base URL; defaults to https://api.openai.com/v1"
},
{
"name": "AGENT_WEB_SEARCH_MESSAGES_API_KEY",
"description": "Generic Anthropic Messages API key for web search grounding"
},
{
"name": "AGENT_WEB_SEARCH_MESSAGES_BASE_URL",
"description": "Generic Anthropic Messages API base URL; defaults to https://api.anthropic.com"
},
{
"name": "TAVILY_API_KEY",
"description": "Tavily API key for agent-oriented search"
},
{
"name": "BRAVE_SEARCH_API_KEY",
"description": "Brave Search API key"
},
{
"name": "PERPLEXITY_API_KEY",
"description": "Perplexity API key for structured search"
},
{
"name": "YDC_API_KEY",
"description": "You.com API key"
},
{
"name": "EXA_API_KEY",
"description": "Optional Exa key; free MCP fallback without it"
},
{
"name": "PARALLEL_API_KEY",
"description": "Optional Parallel key; free MCP fallback without it"
},
{
"name": "ZHIPU_WEB_SEARCH_API_KEY",
"description": "Zhipu standalone Web Search API key"
},
{
"name": "ZHIPU_CHAT_SEARCH_API_KEY",
"description": "Zhipu Chat Completions native web search key"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"agent-web-search-mcp": {
"command": "uvx",
"args": [
"agent-web-search-mcp==0.8.1"
],
"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>",
"AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
"AGENT_WEB_SEARCH_RESPONSES_BASE_URL": "<YOUR_AGENT_WEB_SEARCH_RESPONSES_BASE_URL>",
"AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
"AGENT_WEB_SEARCH_MESSAGES_BASE_URL": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_BASE_URL>",
"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>"
}
}
}
}Cline
{
"mcpServers": {
"agent-web-search-mcp": {
"command": "uvx",
"args": [
"agent-web-search-mcp==0.8.1"
],
"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>",
"AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
"AGENT_WEB_SEARCH_RESPONSES_BASE_URL": "<YOUR_AGENT_WEB_SEARCH_RESPONSES_BASE_URL>",
"AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
"AGENT_WEB_SEARCH_MESSAGES_BASE_URL": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_BASE_URL>",
"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>"
}
}
}
}VS Code
{
"servers": {
"agent-web-search-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"agent-web-search-mcp==0.8.1"
],
"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>",
"AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
"AGENT_WEB_SEARCH_RESPONSES_BASE_URL": "<YOUR_AGENT_WEB_SEARCH_RESPONSES_BASE_URL>",
"AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
"AGENT_WEB_SEARCH_MESSAGES_BASE_URL": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_BASE_URL>",
"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>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"agent-web-search-mcp": {
"command": "uvx",
"args": [
"agent-web-search-mcp==0.8.1"
],
"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>",
"AGENT_WEB_SEARCH_RESPONSES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_RESPONSES_API_KEY>",
"AGENT_WEB_SEARCH_RESPONSES_BASE_URL": "<YOUR_AGENT_WEB_SEARCH_RESPONSES_BASE_URL>",
"AGENT_WEB_SEARCH_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>",
"AGENT_WEB_SEARCH_MESSAGES_BASE_URL": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_BASE_URL>",
"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>"
}
}
}
}Let your agent find its tools
Find servers like Agent Web Search MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.