Skip to content
MCP server

Yandex Direct

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.5
Listing updated
5 days ago

About Yandex Direct

Yandex Direct is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • YANDEX_DIRECT_TOKENYandex Direct OAuth token — full account access (can spend budget). Treat it as a secret.Required
  • YANDEX_DIRECT_LOGINClient login to target a specific account on agency tokens.
  • YANDEX_DIRECT_SANDBOXSet to true to call the Yandex Direct sandbox API instead of production.
  • YANDEX_DIRECT_LANGLanguage for API responses and error messages (ru, en, ...).

Pricing

Open source

Yandex Direct FAQ

Is Yandex Direct free?

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

How do I add Yandex Direct to Claude Code?

Run this command in your terminal: claude mcp add mcp-yandex-direct --env YANDEX_DIRECT_TOKEN='<YANDEX_DIRECT_TOKEN>' -- npx -y mcp-yandex-direct

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers