Yandex Wordstat MCP Server

by askadsio.github.askads/mcp-yandex-wordstatv2.3.0

Read-only Yandex Wordstat keyword demand data: top and related queries, demand dynamics and regional distribution.

7Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active6d ago

Install Yandex Wordstat MCP server

claude mcp add yandex-wordstat -e WORDSTAT_API_KEY='<wordstat-api-key>' -e WORDSTAT_FOLDER_ID='<wordstat-folder-id>' -- npx -y mcp-yandex-wordstat

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat"
      ],
      "env": {
        "WORDSTAT_API_KEY": "<wordstat-api-key>",
        "WORDSTAT_FOLDER_ID": "<wordstat-folder-id>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat"
      ],
      "env": {
        "WORDSTAT_API_KEY": "<wordstat-api-key>",
        "WORDSTAT_FOLDER_ID": "<wordstat-folder-id>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "yandex-wordstat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat"
      ],
      "env": {
        "WORDSTAT_API_KEY": "<wordstat-api-key>",
        "WORDSTAT_FOLDER_ID": "<wordstat-folder-id>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat"
      ],
      "env": {
        "WORDSTAT_API_KEY": "<wordstat-api-key>",
        "WORDSTAT_FOLDER_ID": "<wordstat-folder-id>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
WORDSTAT_API_KEY	yes	yes	Yandex Cloud API key for the Search API (sent as Api-Key). Treat it as a secret.
WORDSTAT_FOLDER_ID	yes	—	Yandex Cloud folder id, injected into every request body.
WORDSTAT_LANG	—	—	Language for API responses (ru, en, ...).
WORDSTAT_API_BASE	—	—	API root host override.
WORDSTAT_TIMEOUT_MS	—	—	Per-request timeout in milliseconds.
WORDSTAT_MAX_RETRIES	—	—	Retries on transient errors (429, 5xx, network).

Freshness

Active — last maintenance signal 6d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-04 · 6d ago · GitHub
Latest release
2026-08-18 · 52d ago · GitHub · v2.3.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-18 · 52d ago · official registry · v2.3.0

FAQ

›How do I install the Yandex Wordstat MCP server in Claude Code?

Run: claude mcp add yandex-wordstat -e WORDSTAT_API_KEY='<wordstat-api-key>' -e WORDSTAT_FOLDER_ID='<wordstat-folder-id>' -- npx -y mcp-yandex-wordstat. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Yandex Wordstat require an API key?

Yes. It expects WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID, of which 1 is a secret.

›Can I use Yandex Wordstat as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Yandex Wordstat in the official MCP registry?

Yes, as io.github.askads/mcp-yandex-wordstat.