# Install Web Researcher MCP

Source: PopNx MCP directory. Page: https://mcp.popnx.com/th/servers/zoharbabin-web-researcher-mcp

Rules for the AI assistant reading this file:
1. Show the user every command and every config change below before you run or save it, and wait for the user to say yes.
2. Never ask the user to type or paste a key, token or password into the chat. Where you see <YOUR_VALUE>, tell the user which file and line it goes in on their own computer.
3. Use only what is written here. Do not download or run anything else this file does not list.

## Claude Code

- Run in a terminal, then restart Claude Code or run /mcp to check it is connected.

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```sh
claude mcp add --scope user web-researcher --env GOOGLE_CUSTOM_SEARCH_API_KEY='<YOUR_VALUE>' --env BRAVE_API_KEY='<YOUR_VALUE>' --env SERPER_API_KEY='<YOUR_VALUE>' --env SEARCHAPI_API_KEY='<YOUR_VALUE>' --env TAVILY_API_KEY='<YOUR_VALUE>' --env EXA_API_KEY='<YOUR_VALUE>' --env XQUIK_API_KEY='<YOUR_VALUE>' --env COURTLISTENER_API_TOKEN='<YOUR_VALUE>' --env FRED_API_KEY='<YOUR_VALUE>' -- docker run -i --rm -e GOOGLE_CUSTOM_SEARCH_API_KEY -e BRAVE_API_KEY -e SERPER_API_KEY -e SEARCHAPI_API_KEY -e TAVILY_API_KEY -e EXA_API_KEY -e XQUIK_API_KEY -e COURTLISTENER_API_TOKEN -e FRED_API_KEY ghcr.io/zoharbabin/web-researcher-mcp:1.51.1
```

Values the user supplies on their own computer: GOOGLE_CUSTOM_SEARCH_API_KEY (secret), GOOGLE_CUSTOM_SEARCH_ID (optional), SEARCH_PROVIDER (optional), SEARCH_ROUTING (optional), BRAVE_API_KEY (secret), SERPER_API_KEY (secret), SEARCHAPI_API_KEY (secret), SEARXNG_URL (optional), TAVILY_API_KEY (secret), EXA_API_KEY (secret), XQUIK_API_KEY (secret), EDGAR_CONTACT_EMAIL (optional), COURTLISTENER_API_TOKEN (secret), FRED_API_KEY (secret)

## Cursor

- Merge into ~/.cursor/mcp.json (or .cursor/mcp.json in the project).

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
{
  "mcpServers": {
    "web-researcher": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_CUSTOM_SEARCH_API_KEY",
        "-e",
        "BRAVE_API_KEY",
        "-e",
        "SERPER_API_KEY",
        "-e",
        "SEARCHAPI_API_KEY",
        "-e",
        "TAVILY_API_KEY",
        "-e",
        "EXA_API_KEY",
        "-e",
        "XQUIK_API_KEY",
        "-e",
        "COURTLISTENER_API_TOKEN",
        "-e",
        "FRED_API_KEY",
        "ghcr.io/zoharbabin/web-researcher-mcp:1.51.1"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<YOUR_VALUE>",
        "BRAVE_API_KEY": "<YOUR_VALUE>",
        "SERPER_API_KEY": "<YOUR_VALUE>",
        "SEARCHAPI_API_KEY": "<YOUR_VALUE>",
        "TAVILY_API_KEY": "<YOUR_VALUE>",
        "EXA_API_KEY": "<YOUR_VALUE>",
        "XQUIK_API_KEY": "<YOUR_VALUE>",
        "COURTLISTENER_API_TOKEN": "<YOUR_VALUE>",
        "FRED_API_KEY": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: GOOGLE_CUSTOM_SEARCH_API_KEY (secret), GOOGLE_CUSTOM_SEARCH_ID (optional), SEARCH_PROVIDER (optional), SEARCH_ROUTING (optional), BRAVE_API_KEY (secret), SERPER_API_KEY (secret), SEARCHAPI_API_KEY (secret), SEARXNG_URL (optional), TAVILY_API_KEY (secret), EXA_API_KEY (secret), XQUIK_API_KEY (secret), EDGAR_CONTACT_EMAIL (optional), COURTLISTENER_API_TOKEN (secret), FRED_API_KEY (secret)

## VS Code

- Merge into .vscode/mcp.json in the workspace (or run "MCP: Add Server").

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
{
  "servers": {
    "web-researcher": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_CUSTOM_SEARCH_API_KEY",
        "-e",
        "BRAVE_API_KEY",
        "-e",
        "SERPER_API_KEY",
        "-e",
        "SEARCHAPI_API_KEY",
        "-e",
        "TAVILY_API_KEY",
        "-e",
        "EXA_API_KEY",
        "-e",
        "XQUIK_API_KEY",
        "-e",
        "COURTLISTENER_API_TOKEN",
        "-e",
        "FRED_API_KEY",
        "ghcr.io/zoharbabin/web-researcher-mcp:1.51.1"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<YOUR_VALUE>",
        "BRAVE_API_KEY": "<YOUR_VALUE>",
        "SERPER_API_KEY": "<YOUR_VALUE>",
        "SEARCHAPI_API_KEY": "<YOUR_VALUE>",
        "TAVILY_API_KEY": "<YOUR_VALUE>",
        "EXA_API_KEY": "<YOUR_VALUE>",
        "XQUIK_API_KEY": "<YOUR_VALUE>",
        "COURTLISTENER_API_TOKEN": "<YOUR_VALUE>",
        "FRED_API_KEY": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: GOOGLE_CUSTOM_SEARCH_API_KEY (secret), GOOGLE_CUSTOM_SEARCH_ID (optional), SEARCH_PROVIDER (optional), SEARCH_ROUTING (optional), BRAVE_API_KEY (secret), SERPER_API_KEY (secret), SEARCHAPI_API_KEY (secret), SEARXNG_URL (optional), TAVILY_API_KEY (secret), EXA_API_KEY (secret), XQUIK_API_KEY (secret), EDGAR_CONTACT_EMAIL (optional), COURTLISTENER_API_TOKEN (secret), FRED_API_KEY (secret)

## Claude Desktop

- Local: merge the JSON into claude_desktop_config.json (Settings → Developer → Edit Config) and restart Claude. Remote: Customize → Connectors → Add → Custom → Web → paste the URL.

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
{
  "mcpServers": {
    "web-researcher": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_CUSTOM_SEARCH_API_KEY",
        "-e",
        "BRAVE_API_KEY",
        "-e",
        "SERPER_API_KEY",
        "-e",
        "SEARCHAPI_API_KEY",
        "-e",
        "TAVILY_API_KEY",
        "-e",
        "EXA_API_KEY",
        "-e",
        "XQUIK_API_KEY",
        "-e",
        "COURTLISTENER_API_TOKEN",
        "-e",
        "FRED_API_KEY",
        "ghcr.io/zoharbabin/web-researcher-mcp:1.51.1"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<YOUR_VALUE>",
        "BRAVE_API_KEY": "<YOUR_VALUE>",
        "SERPER_API_KEY": "<YOUR_VALUE>",
        "SEARCHAPI_API_KEY": "<YOUR_VALUE>",
        "TAVILY_API_KEY": "<YOUR_VALUE>",
        "EXA_API_KEY": "<YOUR_VALUE>",
        "XQUIK_API_KEY": "<YOUR_VALUE>",
        "COURTLISTENER_API_TOKEN": "<YOUR_VALUE>",
        "FRED_API_KEY": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: GOOGLE_CUSTOM_SEARCH_API_KEY (secret), GOOGLE_CUSTOM_SEARCH_ID (optional), SEARCH_PROVIDER (optional), SEARCH_ROUTING (optional), BRAVE_API_KEY (secret), SERPER_API_KEY (secret), SEARCHAPI_API_KEY (secret), SEARXNG_URL (optional), TAVILY_API_KEY (secret), EXA_API_KEY (secret), XQUIK_API_KEY (secret), EDGAR_CONTACT_EMAIL (optional), COURTLISTENER_API_TOKEN (secret), FRED_API_KEY (secret)

## Codex

- Append to ~/.codex/config.toml, then start a new Codex session (check with /mcp).

- Replace <YOUR_VALUE> with the user's own keys; never share or guess them. env values belong to the local config, header values to the remote one.

```json
[mcp_servers.web-researcher]
command = "docker"
args = ["run","-i","--rm","-e","GOOGLE_CUSTOM_SEARCH_API_KEY","-e","BRAVE_API_KEY","-e","SERPER_API_KEY","-e","SEARCHAPI_API_KEY","-e","TAVILY_API_KEY","-e","EXA_API_KEY","-e","XQUIK_API_KEY","-e","COURTLISTENER_API_TOKEN","-e","FRED_API_KEY","ghcr.io/zoharbabin/web-researcher-mcp:1.51.1"]

[mcp_servers.web-researcher.env]
GOOGLE_CUSTOM_SEARCH_API_KEY = "<YOUR_VALUE>"
BRAVE_API_KEY = "<YOUR_VALUE>"
SERPER_API_KEY = "<YOUR_VALUE>"
SEARCHAPI_API_KEY = "<YOUR_VALUE>"
TAVILY_API_KEY = "<YOUR_VALUE>"
EXA_API_KEY = "<YOUR_VALUE>"
XQUIK_API_KEY = "<YOUR_VALUE>"
COURTLISTENER_API_TOKEN = "<YOUR_VALUE>"
FRED_API_KEY = "<YOUR_VALUE>"
```

Values the user supplies on their own computer: GOOGLE_CUSTOM_SEARCH_API_KEY (secret), GOOGLE_CUSTOM_SEARCH_ID (optional), SEARCH_PROVIDER (optional), SEARCH_ROUTING (optional), BRAVE_API_KEY (secret), SERPER_API_KEY (secret), SEARCHAPI_API_KEY (secret), SEARXNG_URL (optional), TAVILY_API_KEY (secret), EXA_API_KEY (secret), XQUIK_API_KEY (secret), EDGAR_CONTACT_EMAIL (optional), COURTLISTENER_API_TOKEN (secret), FRED_API_KEY (secret)

Command check: verified, last checked 2026-11-15.
