# Agent Web Search

> Agent Web Search is an open-source MCP server for web search and scraping. One web_search tool over grounding APIs and agent search services, keyless by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/jerryliu369/agent-web-search
- **MCP Registry name:** io.github.JerryLiu369/agent-web-search
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [machine_internet](https://ai-powered.com/mcp/machine-internet): machine_internet is an open-source MCP server for web search and scraping.
- [acrawl](https://ai-powered.com/mcp/acrawl): acrawl is an open-source MCP server for browser automation.
- [Countries](https://ai-powered.com/mcp/countries): Countries is a freemium MCP server for web search and scraping.
- [Listen Notes](https://ai-powered.com/mcp/listen-notes): Listen Notes is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/agent-web-search
