MCP Server

Yandex Direct MCP Server

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

io.github.gistrec/mcp-yandex-direct

Repository Registry

What is the Yandex Direct MCP server?

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

How to install Yandex Direct

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