# Yandex Wordstat MCP

> Yandex Wordstat MCP is an open-source MCP server for marketing and seo. Yandex Wordstat search-demand data: top queries, trends and regions for AI apps. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/askads/mcp-yandex-wordstat
- **MCP Registry name:** io.github.askads/mcp-yandex-wordstat
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

The server reads Yandex's search-demand statistics through the Yandex Cloud Search API, so it works without access to a Yandex Direct advertising account or the old OAuth-based Wordstat API. You need a Yandex Cloud API key for the Search API (WORDSTAT_API_KEY) and a folder ID (WORDSTAT_FOLDER_ID), and Node.js 20 or newer.

There are five read-only tools. Top and related queries and regional breakdowns cover the last 30 days, while the dynamics report returns date, count and share series by day, week or month, and can be narrowed by region or by device (computer, phone, tablet). In the regions report an affinity index above 100% means interest above average. Each call handles a single phrase, and the Yandex Cloud quota is shared per key, so long keyword lists should be trimmed first.

Requests time out after 60 seconds and are retried up to three times on 429, 5xx or network errors. The README is written in Russian.

## Features

- **Top and related queries:** Shows popular queries containing a phrase plus semantically close ones.
- **Demand dynamics:** Daily, weekly or monthly time series for seasonality.
- **Regional breakdown:** Spreads demand across regions with an affinity index.
- **Region and device filters:** Narrow reports to a region or compare computers, phones and tablets.
- **Read-only access:** Nothing in Wordstat can be created or changed.
- **Retry handling:** Retries transient errors and respects Retry-After.

## Good for

- Estimate monthly search volume for a Russian-language phrase
- Spot seasonal peaks in demand for a product
- Compare interest in Moscow and Saint Petersburg
- Build a keyword list around a topic with frequencies

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-yandex-wordstat --env WORDSTAT_API_KEY='<WORDSTAT_API_KEY>' --env WORDSTAT_FOLDER_ID='<WORDSTAT_FOLDER_ID>' -- npx -y mcp-yandex-wordstat
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-yandex-wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat"
      ],
      "env": {
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-yandex-wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat"
      ],
      "env": {
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-yandex-wordstat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat"
      ],
      "env": {
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-yandex-wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat"
      ],
      "env": {
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-yandex-wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-wordstat"
      ],
      "env": {
        "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
      }
    }
  }
}
```

## Tools

- `top_requests`: Returns popular and related queries for a phrase.
- `dynamics`: Returns demand over time by day, week or month.
- `regions`: Returns demand distribution by region.
- `raw_request`: Sends a technical request to the API.

## FAQ

### What credentials does it need?

A Yandex Cloud API key for the Search API and a Yandex Cloud folder ID.

### Does it need a Yandex Direct account?

No. It uses the Yandex Cloud Search API instead.

### Can it change anything?

No. All five tools, including raw_request, are read-only.

### What time period do top queries cover?

The last 30 days.

### Is Yandex Wordstat MCP free?

Yes. Yandex Wordstat MCP is open source, so you can use and self-host it for free.

### How do I add Yandex Wordstat MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-yandex-wordstat --env WORDSTAT_API_KEY='<WORDSTAT_API_KEY>' --env WORDSTAT_FOLDER_ID='<WORDSTAT_FOLDER_ID>' -- npx -y mcp-yandex-wordstat

### What are the best alternatives to Yandex Wordstat MCP?

The closest alternatives to Yandex Wordstat MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Customer Io, Google_search_console and Ads AI Creator MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Customer Io](https://ai-powered.com/mcp/customer-io): Customer Io is a freemium MCP server for marketing and seo.
- [Google_search_console](https://ai-powered.com/mcp/google-search-console-8): Google_search_console is a freemium MCP server for web search and scraping.
- [Ads AI Creator MCP](https://ai-powered.com/mcp/ads-ai-creator-mcp): Ads AI Creator MCP is a paid MCP server for marketing and seo.
- [Zovo QR Code Maker](https://ai-powered.com/mcp/zovo-qr-code-maker): Zovo QR Code Maker is an MCP server for marketing and seo.
- [Agentzia](https://ai-powered.com/mcp/agentzia): Agentzia is a freemium MCP server for marketing and seo.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.

---
Source: https://ai-powered.com/mcp/yandex-wordstat-mcp-2
