Agent Web Search

MCP server · by JerryLiu369

AI Agents Python v0.8.1

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

View source ↗ Website ↗ Generate config for multiple servers More servers

Install

Pin version registry version 0.8.1

Python
uvx agent-web-search-mcp

Python
uvx agent-web-search-mcp@0.8.1

Setup by client

Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.

claude_desktop_config.json

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "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_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp@0.8.1"
      ],
      "env": {
        "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_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>"
      }
    }
  }
}

Format verified against the official Claude Desktop docs ↗.

terminal

claude mcp add --env ARK_API_KEY=<YOUR_ARK_API_KEY> --env GEMINI_API_KEY=<YOUR_GEMINI_API_KEY> --env XAI_API_KEY=<YOUR_XAI_API_KEY> --env DEEPSEEK_API_KEY=<YOUR_DEEPSEEK_API_KEY> --env AGENT_WEB_SEARCH_RESPONSES_API_KEY=<YOUR_AGENT_WEB_SEARCH_RESPONSES_API_KEY> --env AGENT_WEB_SEARCH_MESSAGES_API_KEY=<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY> agent-web-search -- uvx agent-web-search-mcp

claude mcp add --env ARK_API_KEY=<YOUR_ARK_API_KEY> --env GEMINI_API_KEY=<YOUR_GEMINI_API_KEY> --env XAI_API_KEY=<YOUR_XAI_API_KEY> --env DEEPSEEK_API_KEY=<YOUR_DEEPSEEK_API_KEY> --env AGENT_WEB_SEARCH_RESPONSES_API_KEY=<YOUR_AGENT_WEB_SEARCH_RESPONSES_API_KEY> --env AGENT_WEB_SEARCH_MESSAGES_API_KEY=<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY> agent-web-search -- uvx agent-web-search-mcp@0.8.1

Format verified against the official Claude Code docs ↗.

.cursor/mcp.json

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "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_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp@0.8.1"
      ],
      "env": {
        "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_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>"
      }
    }
  }
}

Format verified against the official Cursor docs ↗.

.vscode/mcp.json

{
  "servers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "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_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>"
      }
    }
  }
}

{
  "servers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp@0.8.1"
      ],
      "env": {
        "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_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>"
      }
    }
  }
}

Format verified against the official VS Code docs ↗.

mcp_config.json

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp"
      ],
      "env": {
        "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_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "agent-web-search": {
      "command": "uvx",
      "args": [
        "agent-web-search-mcp@0.8.1"
      ],
      "env": {
        "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_MESSAGES_API_KEY": "<YOUR_AGENT_WEB_SEARCH_MESSAGES_API_KEY>"
      }
    }
  }
}

Format verified against the official Windsurf docs ↗.

Environment variables

Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.

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
AGENT_WEB_SEARCH_RESPONSES_API_KEY secret — 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 secret — Generic Anthropic Messages API key for web search grounding

GitHub

⭐ 11 stars · 最近更新于 27 天前 · MIT license

About this server

Distributed as Python, listed under AI Agents. Review our MCP security guide before granting access to real data.

Frequently asked questions

How do I install Agent Web Search?

Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.

Is Agent Web Search free to use?

The MCP server itself is free to install. The source is public on https://github.com/JerryLiu369/agent-web-search. Any third-party service it calls may require its own API key and account.

Which clients support Agent Web Search?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.

Add this badge

Publish this server? Link back with a badge on your README or site — copy either snippet.

Markdown

[![Listed on MCPNav](https://mcpnav.net/badge/agent-web-search.svg)](https://mcpnav.net/server/agent-web-search/)

HTML

<a href="https://mcpnav.net/server/agent-web-search/"><img src="https://mcpnav.net/badge/agent-web-search.svg" alt="Listed on MCPNav" height="20"></a>