Yandex Direct MCP MCP Server

Name: Yandex Direct MCP MCP Server
Author: io.github.askads

io.github.askads/mcp-yandex-direct

Repository Registry

What is the Yandex Direct MCP MCP server?

MCP server for Yandex Direct API v5: manage PPC campaigns, ads, keywords, and statistics.

How to install Yandex Direct MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

YANDEX_DIRECT_TOKEN
required
secret
Yandex Direct OAuth token — full account access (can spend budget). Treat it as a secret.
YANDEX_DIRECT_LOGIN
Client login to target a specific account on agency tokens.
YANDEX_DIRECT_SANDBOX
Set to true to call the Yandex Direct sandbox API instead of production.
YANDEX_DIRECT_LANG
Language for API responses and error messages (ru, en, ...).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<YOUR_YANDEX_DIRECT_TOKEN>",
        "YANDEX_DIRECT_LOGIN": "<YOUR_YANDEX_DIRECT_LOGIN>",
        "YANDEX_DIRECT_SANDBOX": "<YOUR_YANDEX_DIRECT_SANDBOX>",
        "YANDEX_DIRECT_LANG": "<YOUR_YANDEX_DIRECT_LANG>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<YOUR_YANDEX_DIRECT_TOKEN>",
        "YANDEX_DIRECT_LOGIN": "<YOUR_YANDEX_DIRECT_LOGIN>",
        "YANDEX_DIRECT_SANDBOX": "<YOUR_YANDEX_DIRECT_SANDBOX>",
        "YANDEX_DIRECT_LANG": "<YOUR_YANDEX_DIRECT_LANG>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<YOUR_YANDEX_DIRECT_TOKEN>",
        "YANDEX_DIRECT_LOGIN": "<YOUR_YANDEX_DIRECT_LOGIN>",
        "YANDEX_DIRECT_SANDBOX": "<YOUR_YANDEX_DIRECT_SANDBOX>",
        "YANDEX_DIRECT_LANG": "<YOUR_YANDEX_DIRECT_LANG>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-yandex-direct": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<YOUR_YANDEX_DIRECT_TOKEN>",
        "YANDEX_DIRECT_LOGIN": "<YOUR_YANDEX_DIRECT_LOGIN>",
        "YANDEX_DIRECT_SANDBOX": "<YOUR_YANDEX_DIRECT_SANDBOX>",
        "YANDEX_DIRECT_LANG": "<YOUR_YANDEX_DIRECT_LANG>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-yandex-direct --env YANDEX_DIRECT_TOKEN=<YOUR_YANDEX_DIRECT_TOKEN> --env YANDEX_DIRECT_LOGIN=<YOUR_YANDEX_DIRECT_LOGIN> --env YANDEX_DIRECT_SANDBOX=<YOUR_YANDEX_DIRECT_SANDBOX> --env YANDEX_DIRECT_LANG=<YOUR_YANDEX_DIRECT_LANG> -- npx -y mcp-yandex-direct

Related MCP servers

VK Ads MCP

Active

MCP server for VK Ads (VK Реклама) API: manage ad plans, ad groups, banners, and statistics.

TypeScript

MIT

View repository →

Yandex Metrica MCP

Active

MCP server for Yandex Metrica API: list counters, goals and pull web-analytics statistics.

TypeScript

MIT

View repository →

Yandex Wordstat MCP

Active

MCP server for Yandex Wordstat API: top & related queries, demand dynamics and regions.

TypeScript

MIT

View repository →