# Agent Web Search Gives your agent a single search call: ask a question in plain language, get citations or structured evidence back. Setup takes a minute. - MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 - Author: JerryLiu369 - License: MIT · policy=link-only · description only; the file stays with the author - Source: https://github.com/JerryLiu369/agent-web-search - Updated: 2026-10-23 - HTML: https://affpapa.org/en/nevibecode/mcp/agent-web-search ## What it does Agent Web Search is an MIT-licensed MCP server, CLI and Python library. One search core sits behind three routes: an MCP tool, a native plugin, or a CLI described by an Agent Skill. Python 3.10+ is required. DDGS, Exa and Parallel come as default providers and need no API key, so you can try search right after install. Other providers are wired through `AGENT_WEB_SEARCH_PROVIDERS`, `ARK_API_KEY`, `GEMINI_API_KEY`, `XAI_API_KEY` and `DEEPSEEK_API_KEY`. A provider without its key will not come up. Want to look before you install? `uvx --from agent-web-search-mcp agent-web-search ""` runs a search and leaves your environment alone. The normal install is `pipx install agent-web-search-mcp`. For shell-capable agents the author recommends the CLI + Skill route: no MCP JSON to debug, no transport lifecycle in the background. ## Requirements - Needs: Python and uv (commands run via uvx) - Environment variables: `AGENT_WEB_SEARCH_PROVIDERS`, `ARK_API_KEY`, `GEMINI_API_KEY`, `XAI_API_KEY`, `DEEPSEEK_API_KEY`, `AGENT_WEB_SEARCH_RESPONSES_API_KEY`, `AGENT_WEB_SEARCH_RESPONSES_BASE_URL`, `AGENT_WEB_SEARCH_MESSAGES_API_KEY`, `AGENT_WEB_SEARCH_MESSAGES_BASE_URL`, `TAVILY_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files. ## Install ### Claude Code (native platform) **Platform CLI** ```bash claude mcp add --env AGENT_WEB_SEARCH_PROVIDERS= --env ARK_API_KEY= --env GEMINI_API_KEY= --env XAI_API_KEY= --env DEEPSEEK_API_KEY= --transport stdio agent-web-search -- uvx agent-web-search-mcp ``` Replace <…> with your own values. 12 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from agent-web-search-mcp ### Codex **Platform CLI** ```bash codex mcp add agent-web-search --env AGENT_WEB_SEARCH_PROVIDERS= --env ARK_API_KEY= --env GEMINI_API_KEY= --env XAI_API_KEY= --env DEEPSEEK_API_KEY= -- uvx agent-web-search-mcp ``` Replace <…> with your own values. 12 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from agent-web-search-mcp ### Cursor **Config file** File `.cursor/mcp.json`: ```json { "mcpServers": { "agent-web-search": { "command": "uvx", "args": [ "agent-web-search-mcp" ], "env": { "AGENT_WEB_SEARCH_PROVIDERS": "", "ARK_API_KEY": "", "GEMINI_API_KEY": "", "XAI_API_KEY": "", "DEEPSEEK_API_KEY": "" } } } } ``` Replace <…> with your own values. 12 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from agent-web-search-mcp ### GitHub Copilot **Config file** File `.vscode/mcp.json`: ```json { "servers": { "agent-web-search": { "type": "stdio", "command": "uvx", "args": [ "agent-web-search-mcp" ], "env": { "AGENT_WEB_SEARCH_PROVIDERS": "", "ARK_API_KEY": "", "GEMINI_API_KEY": "", "XAI_API_KEY": "", "DEEPSEEK_API_KEY": "" } } } } ``` Replace <…> with your own values. 12 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from agent-web-search-mcp ### Gemini CLI **Platform CLI** ```bash gemini mcp add -e AGENT_WEB_SEARCH_PROVIDERS= -e ARK_API_KEY= -e GEMINI_API_KEY= -e XAI_API_KEY= -e DEEPSEEK_API_KEY= agent-web-search uvx agent-web-search-mcp ``` Replace <…> with your own values. 12 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from agent-web-search-mcp ## When to use it - look up current information from the terminal - give an agent web search access with no provider signup - get citations and structured evidence instead of bare links - test search through `uvx` without installing anything - call search from a Python script as a library ## Example prompts - Use agent-web-search to find what changed in the latest Anthropic Claude CLI release - \`agent-web-search "how to configure MCP in Codex"` - Install agent-web-search-mcp and check that the tool answers a query ## Similar - [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989 - [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918 - [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115 - [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160 - [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392 - [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872 --- NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md