SkillFoxx

Dependency-free Node MCP for Yandex Direct

yandex-direct-mcp

A single-file, dependency-free Node.js Direct API v5 MCP server with a universal direct_call tool and a read-only mode

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Bulk-changes bids by rule and creates campaigns and ads
  • The universal direct_call tool opens access to every changing API v5 method
All reasons and checks
Russian stack

iarbor04/yandex-direct-mcpAuthor:iarbor04

Install

Manual install

claude mcp add yandex-direct --scope user -- node "$PWD/server.js"

Run after git clone; no dependencies or npm install needed.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Bulk-changes bids by rule and creates campaigns and ads
  • The universal direct_call tool opens access to every changing API v5 method

This is third-party code. Review the repository files before installing.

What it does

The server is a single Node.js file with zero dependencies, using only the built-in fetch and stdio transport. Analytics covers reports on any slice and period: campaigns, groups, ads, keywords, search queries, geography, devices, time of day, gender and age, plus junk-query analysis and finding keywords with spend and no conversions. Management creates and edits campaigns, groups, ads, keywords, bids and daily budgets, including bulk rule-based changes like 'CPA above 2,000 rubles, cut the bid by 20%,' plus negative keywords, pausing, sending to moderation, bid adjustments and retargeting. The universal direct_call tool covers all v5 services in full, from campaigns to keywordsresearch, not just the ones wrapped as separate tools. There is a dedicated read-only mode that blocks changing methods at the server level, not only the client's.

Who it is for. For people who want a minimal, dependency-free Direct server with a guaranteed read-only mode for everyday monitoring.

Good fit when

  • You need junk-query analysis and to find keywords with spend and no conversions
  • You need bulk, CPA-conditioned bid rules
  • You need a read-only mode the server itself will not let you bypass, for regular summaries

Not a fit when

  • You want a one-command npm install: the server is installed by cloning the repository, no npm install needed
  • You still need an approved Direct API access request: without it even the sandbox will not work
  • You need built-in integrations like Click.ru: the server only talks to the Direct API directly

Example request

Break down this campaign's search queries for the month, find the junk ones and suggest negative keywords

MCP

Transport
stdio
Authentication
API key

Limitations

Without an approved API access request, even the sandbox fails: api-sandbox.direct.yandex.com returns the same error 58. The application takes from an hour to three days to review, up to seven in peak periods. The token is stored locally in a file with 600 permissions.

How to disable. Remove the yandex-direct block from your MCP client config.

FAQ

Can I test in sandbox while the application is pending?

No, the README explicitly checked this: api-sandbox.direct.yandex.com returns the same error 58 as production; nothing works without an approved application.

How do I enable read-only mode?

A dedicated server-level mode, not a client setting; the README covers it in the analytics-and-management section, with details in docs/usage.md.

Discussion

No questions or reviews yet.

All Yandex Direct tools
Russian stack

A dependency-free, pure Ruby MCP server with 30 tools for Yandex Direct campaigns, ad groups, ads, keywords and reports

MCP serverBroad access6
Russian stack

20 Yandex Direct tools where every edit shows the plan by default and needs confirm=True to actually send anything

MCP serverBroad access
Russian stack

A fork of a popular Yandex Direct MCP server that defaults to read-only, with explicit flags for writes and finance

MCP serverBroad access

Yandex Direct MCP server (npm)

@theyahia/yandex-direct-mcp

Russian stack

A TypeScript MCP server with an npm package: 20 tools for Yandex Direct campaigns, bids and negative keywords, with money always in rubles

MCP serverBroad access4
Russian stack

A Python MCP server with 48 Yandex Direct tools and Wordstat frequency lookup, switchable between sandbox and production

MCP serverBroad access1

README in short

The README follows the real order of connecting: the API access application first, with ready-made form text, then the token script that hides input and stores the file with 600 permissions, and only then the server install itself with no npm install. It separately covers a morning spend summary and a weekly query review as example scheduled tasks for an MCP client that supports them.

README badge

Report a problem