MCP.Market

Яндекс Директ API v5 MCP server

by artgas1·io.github.artgas1/yandex-direct-api-mcp·v1.1.1·1 stars
No reviews yet

MCP server for Yandex Direct API v5: 113 methods from the machine-readable schema

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

1 stars55 downloads/wk

Reviews

Write one

Nobody has reviewed Яндекс Директ API v5 yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Яндекс Директ API v5 tools (5)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • direct_catalog

    Перечисляет ВСЕ методы API Директа и показывает, какие из них объявлены сейчас, а какие

  • direct_fields

    Перечисляет допустимые значения перечисления: колонки отчётов, наборы FieldNames, типы кампаний.

  • direct_inventory

    Полный состав кабинета: кампании из списка И кампании из отчёта, склеенные в одну

  • direct_reports_get

    Статистика: показы, клики, расход, конверсии по кампаниям, группам, объявлениям и запросам.

  • direct_schema

    Возвращает точный состав типа Директа — какие поля, какие обязательны, какие списки.

Public scan report

scanner v0.1.10 · 2026-10-02 · same rubric, same numbers if you re-run it

no findings
  • Code scan14 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 22 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Яндекс Директ API v5 compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,243 servers
Tools
5
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,706 servers
Downloads a week
55
more than 44% of 12,306 servers with a package

What its tools let an agent do: 5 read

Install Яндекс Директ API v5 in Claude Code, Cursor or VS Code

Runs npx -y yandex-direct-api-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add yandex-direct-api-mcp -- npx -y yandex-direct-api-mcp
Add to Cursor

What the publisher says

From the Яндекс Директ API v5 repository's README, as published. We do not edit it. Read it on GitHub

yandex-direct-mcp

MCP-сервер и командная строка к API Яндекс Директа v5. Покрыты все 113 методов, порождённые из машиночитаемой схемы; по умолчанию объявляются девять — те, которыми читают. Остальное включается одной переменной, изменение выключено.

mcp-name: io.github.artgas1/yandex-direct-api-mcp

English

Работает и как MCP-сервер для Claude Code, Cursor, Codex и других клиентов, и как обычная команда — если MCP не нужен.

Что это даёт — за пять секунд

Обе колонки настоящие: левая — тело ответа, разобранное обычным JSON.parse, то есть так, как его получил бы любой клиент; правая — то, что вернул сервер по JSON-RPC. Строка с идентификатором самодоказательна: слева он испорчен не потому, что так нарисовано, а потому что его действительно портит разбор. Ни токена, ни сети: запросы уводятся на локальную заглушку, поэтому прогон повторяется где угодно, включая CI. Повторить у себя — npm run demo, переснять — npm run demo:record (нужен vhs).

npx -y yandex-direct-api-mcp

Покрытие

Таблица считается из спеки (npm run coverage), а не пишется руками: числа в прозе расходятся со схемой молча, и неправда выглядит ровно как правда.

Быстрый старт

Нужен OAuth-токен Яндекса со scope direct:api — https://oauth.yandex.ru/ (приложению требуется одобренная заявка на доступ к API Директа).

MCP:

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "yandex-direct-api-mcp"],
      "env": { "YANDEX_DIRECT_TOKEN": "ваш-токен" }
    }
  }
}

Командная строка:

export YANDEX_DIRECT_TOKEN="ваш-токен"

yandex-direct-mcp catalog --service campaigns
yandex-direct-mcp describe campaigns.get
yandex-direct-mcp call campaigns.get --FieldNames Id --FieldNames Name

Что этот сервер делает за вас

Не удобства. Каждый пункт — место, где прямой запрос к Директу ошибается молча: ответ выглядит нормальным, ошибки нет, а число или вывод неверны. Всё перечисленное снято прогоном живого API, а не прочитано в документации.

Суммы приходят умноженными на миллион — всегда

DailyBudget.Amount = 1000000000     ← это 1000 единиц валюты счёта
Cost               = 1234500000     ← это 1234,50 единицы валюты счёта

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Яндекс Директ API v5: common questions

Is Яндекс Директ API v5 MCP server safe?
Mostly: it is graded B (83/100). Read the Яндекс Директ API v5 safety report
How do I install Яндекс Директ API v5?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Яндекс Директ API v5 need an API key?
Yes. The registry entry asks for YANDEX_DIRECT_TOKEN.
Is Яндекс Директ API v5 maintained?
The last commit was 57 days ago (2026-09-09). The latest release is v1.1.1.
How does Яндекс Директ API v5 compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,243 servers); tools 5 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from artgas1 →