Яндекс Директ API v5 MCP Server
by artgas1io.github.artgas1/yandex-direct-api-mcpv1.1.1
MCP-сервер к API Яндекс Директа v5: инструменты порождены из машиночитаемой спеки, деньги в рублях, 64-битные идентификаторы без потери точности
context tax
queued
security
queued
cold start
queued
freshness
Active30d ago
Install Яндекс Директ API v5 MCP server
Install in Claude Code
claude mcp add yandex-direct-api -e YANDEX_DIRECT_TOKEN='<yandex-direct-token>' -- npx -y yandex-direct-api-mcpInstall in Cursor
{
"mcpServers": {
"yandex-direct-api": {
"command": "npx",
"args": [
"-y",
"yandex-direct-api-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<yandex-direct-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"yandex-direct-api": {
"command": "npx",
"args": [
"-y",
"yandex-direct-api-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<yandex-direct-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"yandex-direct-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"yandex-direct-api-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<yandex-direct-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"yandex-direct-api": {
"command": "npx",
"args": [
"-y",
"yandex-direct-api-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<yandex-direct-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| YANDEX_DIRECT_TOKEN | yes | yes | OAuth-токен Яндекса со scope direct:api (https://oauth.yandex.ru/) |
| YANDEX_DIRECT_LOGIN | — | — | Логин кабинета для заголовка Client-Login. Нужен агентствам и представителям; для собственного кабинета не задаётся |
| DIRECT_PROFILE | — | — | Набор объявляемых инструментов: core — узкий набор по умолчанию, read — все читающие, all — вся поверхность |
| DIRECT_TOOLS | — | — | Явный список инструментов или служб через запятую. Побеждает DIRECT_PROFILE |
| DIRECT_ALLOW_WRITES | — | — | Разрешить изменяющие методы (add/update/delete). Пока выключено, они не объявляются вовсе. Значения: 1, true, yes |
| DIRECT_API_VERSION | — | — | Версия пути API. Разные версии отдают разные наборы полей одной и той же кампании |
| DIRECT_SANDBOX | — | — | Отправлять запросы в песочницу Директа вместо боевого кабинета. Значения: 1, true, yes |
| DIRECT_MAX_OUTPUT_CHARS | — | — | Потолок размера ответа инструмента в символах; сверх него ответ усекается с пометкой |
Freshness
Active — last maintenance signal 30d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-09 · 30d ago · GitHub
Latest release
2026-09-09 · 30d ago · GitHub · v1.0.1
Package published
no data · npm/PyPI
Registry entry updated
2026-09-09 · 30d ago · official registry · v1.1.1
FAQ
›How do I install the Яндекс Директ API v5 MCP server in Claude Code?
Run: claude mcp add yandex-direct-api -e YANDEX_DIRECT_TOKEN='<yandex-direct-token>' -- npx -y yandex-direct-api-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Яндекс Директ API v5 require an API key?
Yes. It expects YANDEX_DIRECT_TOKEN, of which 1 is a secret.
›Can I use Яндекс Директ API v5 as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Яндекс Директ API v5 in the official MCP registry?
Yes, as io.github.artgas1/yandex-direct-api-mcp.