@stegyan/yandex-mcp

MCP server for Yandex Direct, Yandex Metrika, and Yandex Wordstat APIs. Use with Claude, Cursor, or any MCP-compatible AI assistant to manage advertising campaigns and analyze web analytics.

Tools

Yandex Direct (18 modules): campaigns, ad groups, ads, keywords, stats, sitelinks, vcards, bid modifiers, retargeting, dictionaries, negative keywords, clients, ad extensions, ad videos, creatives, feeds, images, smart ad targets

Yandex Metrika (8 modules): counters, goals, reports, segments, filters, grants, labels, offline conversions

Yandex Wordstat (1 module): keyword demand and search volume

Installation

{
  "mcpServers": {
    "yandex": {
      "command": "npx",
      "args": ["-y", "@stegyan/yandex-mcp"],
      "env": {
        "YANDEX_TOKEN": "your_oauth_token",
        "YANDEX_CLIENT_LOGIN": "client_login_if_agency",
        "YANDEX_USE_SANDBOX": "false"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | YANDEX_TOKEN | Yes | Yandex OAuth token | | YANDEX_CLIENT_LOGIN | No | Client login (for agency accounts) | | YANDEX_USE_SANDBOX | No | Use sandbox API (true/false, default false) |

Getting a Yandex OAuth Token

1. Go to Yandex OAuth
2. Create an app with permissions for Direct API and Metrika API
3. Get an access token via the OAuth flow

Requirements

• Node.js >= 18.0.0

License

MIT