Yandex Direct MCP
An MCP server that connects AI applications to the Yandex Direct advertising API. It allows users to manage PPC campaigns, ads, keywords, bids, and view statistics. It supports two connection methods: a remote read-only server via URL and a local server via npx for full access. It integrates with tools like Claude, Cursor, and Codex, enabling natural language queries for budget analysis and campaign management.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Show campaigns and spending for the past week
- Manage PPC campaigns, ads, and keywords
- Adjust bids and bid modifiers
- View account balance and statistics
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
mcp-yandex-direct 1.12.0
{
"version": "1.12.0",
"transport": "stdio",
"identifier": "mcp-yandex-direct",
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"environmentVariables": [
{
"name": "YANDEX_DIRECT_TOKEN",
"isRequired": true,
"description": "Yandex Direct OAuth token — full account access (can spend budget). Treat it as a secret."
},
{
"name": "YANDEX_DIRECT_LOGIN",
"description": "Default client login on agency tokens; any tool can override it with client_login."
},
{
"name": "YANDEX_DIRECT_CLIENTS",
"description": "Comma-separated logins of managed (non-agency) accounts, shown by list_clients."
},
{
"name": "YANDEX_DIRECT_SANDBOX",
"default": "false",
"description": "Set to true to call the Yandex Direct sandbox API instead of production."
},
{
"name": "YANDEX_DIRECT_LANG",
"default": "ru",
"description": "Language for API responses and error messages (ru, en, ...)."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"yandex-direct-mcp-mcp-yandex-direct": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-direct@1.12.0"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YOUR_YANDEX_DIRECT_TOKEN>",
"YANDEX_DIRECT_LOGIN": "<YOUR_YANDEX_DIRECT_LOGIN>",
"YANDEX_DIRECT_CLIENTS": "<YOUR_YANDEX_DIRECT_CLIENTS>",
"YANDEX_DIRECT_SANDBOX": "<YOUR_YANDEX_DIRECT_SANDBOX>",
"YANDEX_DIRECT_LANG": "<YOUR_YANDEX_DIRECT_LANG>"
}
}
}
}Cline
{
"mcpServers": {
"yandex-direct-mcp-mcp-yandex-direct": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-direct@1.12.0"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YOUR_YANDEX_DIRECT_TOKEN>",
"YANDEX_DIRECT_LOGIN": "<YOUR_YANDEX_DIRECT_LOGIN>",
"YANDEX_DIRECT_CLIENTS": "<YOUR_YANDEX_DIRECT_CLIENTS>",
"YANDEX_DIRECT_SANDBOX": "<YOUR_YANDEX_DIRECT_SANDBOX>",
"YANDEX_DIRECT_LANG": "<YOUR_YANDEX_DIRECT_LANG>"
}
}
}
}VS Code
{
"servers": {
"yandex-direct-mcp-mcp-yandex-direct": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-yandex-direct@1.12.0"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YOUR_YANDEX_DIRECT_TOKEN>",
"YANDEX_DIRECT_LOGIN": "<YOUR_YANDEX_DIRECT_LOGIN>",
"YANDEX_DIRECT_CLIENTS": "<YOUR_YANDEX_DIRECT_CLIENTS>",
"YANDEX_DIRECT_SANDBOX": "<YOUR_YANDEX_DIRECT_SANDBOX>",
"YANDEX_DIRECT_LANG": "<YOUR_YANDEX_DIRECT_LANG>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"yandex-direct-mcp-mcp-yandex-direct": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-direct@1.12.0"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YOUR_YANDEX_DIRECT_TOKEN>",
"YANDEX_DIRECT_LOGIN": "<YOUR_YANDEX_DIRECT_LOGIN>",
"YANDEX_DIRECT_CLIENTS": "<YOUR_YANDEX_DIRECT_CLIENTS>",
"YANDEX_DIRECT_SANDBOX": "<YOUR_YANDEX_DIRECT_SANDBOX>",
"YANDEX_DIRECT_LANG": "<YOUR_YANDEX_DIRECT_LANG>"
}
}
}
}Let your agent find its tools
Find servers like Yandex Direct MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.