Yandex Direct MCP Server

by askadsio.github.askads/mcp-yandex-directv1.5.1

Yandex Direct API: manage PPC campaigns, ad groups, ads, keywords, bid modifiers, sitelinks, callouts and vCards, and pull statistics.

3Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active6d ago

Install Yandex Direct MCP server

claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN='<yandex-direct-token>' -- npx -y mcp-yandex-direct

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<yandex-direct-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<yandex-direct-token>"
      }
    }
  }
}

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

{
  "servers": {
    "yandex-direct": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<yandex-direct-token>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<yandex-direct-token>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
YANDEX_DIRECT_TOKEN	yes	yes	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, ...).

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 · v1.5.1
Package published
no data · npm/PyPI
Registry entry updated
2026-08-18 · 52d ago · official registry · v1.5.1

FAQ

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

Run: claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN='<yandex-direct-token>' -- npx -y mcp-yandex-direct. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Yandex Direct require an API key?

Yes. It expects YANDEX_DIRECT_TOKEN, of which 1 is a secret.

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

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

›Is Yandex Direct in the official MCP registry?

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