# Install geoseo-mcp

Source: PopNx MCP directory. Page: https://mcp.popnx.com/th/servers/rachit8484-geoseo-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 geoseo --env GEOSEO_OPENAI_API_KEY='<YOUR_VALUE>' --env GEOSEO_ANTHROPIC_API_KEY='<YOUR_VALUE>' --env GEOSEO_GEMINI_API_KEY='<YOUR_VALUE>' --env GEOSEO_PERPLEXITY_API_KEY='<YOUR_VALUE>' --env GEOSEO_XAI_API_KEY='<YOUR_VALUE>' --env GEOSEO_BRAVE_API_KEY='<YOUR_VALUE>' --env GEOSEO_SERPAPI_API_KEY='<YOUR_VALUE>' --env GEOSEO_BING_WEBMASTER_API_KEY='<YOUR_VALUE>' --env GEOSEO_YANDEX_OAUTH_TOKEN='<YOUR_VALUE>' --env GEOSEO_INDEXNOW_KEY='<YOUR_VALUE>' --env GEOSEO_GOOGLE_CLIENT_SECRET='<YOUR_VALUE>' -- uvx geoseo-mcp
```

Values the user supplies on their own computer: GEOSEO_OPENAI_API_KEY (secret), GEOSEO_ANTHROPIC_API_KEY (secret), GEOSEO_GEMINI_API_KEY (secret), GEOSEO_PERPLEXITY_API_KEY (secret), GEOSEO_XAI_API_KEY (secret), GEOSEO_BRAVE_API_KEY (secret), GEOSEO_SERPAPI_API_KEY (secret), GEOSEO_BING_WEBMASTER_API_KEY (secret), GEOSEO_YANDEX_OAUTH_TOKEN (secret), GEOSEO_INDEXNOW_KEY (secret), GEOSEO_GOOGLE_CLIENT_SECRET (secret), GEOSEO_TOOLSETS (optional)

## 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": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ],
      "env": {
        "GEOSEO_OPENAI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_ANTHROPIC_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_GEMINI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_PERPLEXITY_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_XAI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_BRAVE_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_SERPAPI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_BING_WEBMASTER_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_YANDEX_OAUTH_TOKEN": "<YOUR_VALUE>",
        "GEOSEO_INDEXNOW_KEY": "<YOUR_VALUE>",
        "GEOSEO_GOOGLE_CLIENT_SECRET": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: GEOSEO_OPENAI_API_KEY (secret), GEOSEO_ANTHROPIC_API_KEY (secret), GEOSEO_GEMINI_API_KEY (secret), GEOSEO_PERPLEXITY_API_KEY (secret), GEOSEO_XAI_API_KEY (secret), GEOSEO_BRAVE_API_KEY (secret), GEOSEO_SERPAPI_API_KEY (secret), GEOSEO_BING_WEBMASTER_API_KEY (secret), GEOSEO_YANDEX_OAUTH_TOKEN (secret), GEOSEO_INDEXNOW_KEY (secret), GEOSEO_GOOGLE_CLIENT_SECRET (secret), GEOSEO_TOOLSETS (optional)

## 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": {
    "geoseo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ],
      "env": {
        "GEOSEO_OPENAI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_ANTHROPIC_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_GEMINI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_PERPLEXITY_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_XAI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_BRAVE_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_SERPAPI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_BING_WEBMASTER_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_YANDEX_OAUTH_TOKEN": "<YOUR_VALUE>",
        "GEOSEO_INDEXNOW_KEY": "<YOUR_VALUE>",
        "GEOSEO_GOOGLE_CLIENT_SECRET": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: GEOSEO_OPENAI_API_KEY (secret), GEOSEO_ANTHROPIC_API_KEY (secret), GEOSEO_GEMINI_API_KEY (secret), GEOSEO_PERPLEXITY_API_KEY (secret), GEOSEO_XAI_API_KEY (secret), GEOSEO_BRAVE_API_KEY (secret), GEOSEO_SERPAPI_API_KEY (secret), GEOSEO_BING_WEBMASTER_API_KEY (secret), GEOSEO_YANDEX_OAUTH_TOKEN (secret), GEOSEO_INDEXNOW_KEY (secret), GEOSEO_GOOGLE_CLIENT_SECRET (secret), GEOSEO_TOOLSETS (optional)

## 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": {
    "geoseo": {
      "command": "uvx",
      "args": [
        "geoseo-mcp"
      ],
      "env": {
        "GEOSEO_OPENAI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_ANTHROPIC_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_GEMINI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_PERPLEXITY_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_XAI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_BRAVE_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_SERPAPI_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_BING_WEBMASTER_API_KEY": "<YOUR_VALUE>",
        "GEOSEO_YANDEX_OAUTH_TOKEN": "<YOUR_VALUE>",
        "GEOSEO_INDEXNOW_KEY": "<YOUR_VALUE>",
        "GEOSEO_GOOGLE_CLIENT_SECRET": "<YOUR_VALUE>"
      }
    }
  }
}
```

Values the user supplies on their own computer: GEOSEO_OPENAI_API_KEY (secret), GEOSEO_ANTHROPIC_API_KEY (secret), GEOSEO_GEMINI_API_KEY (secret), GEOSEO_PERPLEXITY_API_KEY (secret), GEOSEO_XAI_API_KEY (secret), GEOSEO_BRAVE_API_KEY (secret), GEOSEO_SERPAPI_API_KEY (secret), GEOSEO_BING_WEBMASTER_API_KEY (secret), GEOSEO_YANDEX_OAUTH_TOKEN (secret), GEOSEO_INDEXNOW_KEY (secret), GEOSEO_GOOGLE_CLIENT_SECRET (secret), GEOSEO_TOOLSETS (optional)

## 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.geoseo]
command = "uvx"
args = ["geoseo-mcp"]

[mcp_servers.geoseo.env]
GEOSEO_OPENAI_API_KEY = "<YOUR_VALUE>"
GEOSEO_ANTHROPIC_API_KEY = "<YOUR_VALUE>"
GEOSEO_GEMINI_API_KEY = "<YOUR_VALUE>"
GEOSEO_PERPLEXITY_API_KEY = "<YOUR_VALUE>"
GEOSEO_XAI_API_KEY = "<YOUR_VALUE>"
GEOSEO_BRAVE_API_KEY = "<YOUR_VALUE>"
GEOSEO_SERPAPI_API_KEY = "<YOUR_VALUE>"
GEOSEO_BING_WEBMASTER_API_KEY = "<YOUR_VALUE>"
GEOSEO_YANDEX_OAUTH_TOKEN = "<YOUR_VALUE>"
GEOSEO_INDEXNOW_KEY = "<YOUR_VALUE>"
GEOSEO_GOOGLE_CLIENT_SECRET = "<YOUR_VALUE>"
```

Values the user supplies on their own computer: GEOSEO_OPENAI_API_KEY (secret), GEOSEO_ANTHROPIC_API_KEY (secret), GEOSEO_GEMINI_API_KEY (secret), GEOSEO_PERPLEXITY_API_KEY (secret), GEOSEO_XAI_API_KEY (secret), GEOSEO_BRAVE_API_KEY (secret), GEOSEO_SERPAPI_API_KEY (secret), GEOSEO_BING_WEBMASTER_API_KEY (secret), GEOSEO_YANDEX_OAUTH_TOKEN (secret), GEOSEO_INDEXNOW_KEY (secret), GEOSEO_GOOGLE_CLIENT_SECRET (secret), GEOSEO_TOOLSETS (optional)

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