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
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
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
Install
Manual install
claude mcp add yandex-direct --scope user -- node "$PWD/server.js"Run after git clone; no dependencies or npm install needed.
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 keywordsLimitations
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.
MCP
- Transport
- stdio
- Authentication
- API key
Security check
- Bulk-changes bids by rule and creates campaigns and ads
- The universal direct_call tool opens access to every changing API v5 method
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.
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.
Related
A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts
Marketing Skills for AI agents
Marketing Skills for AI Agents
About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents
SendPulse MCP server
SendPulse MCP
SendPulse's official remote MCP server: statistics, campaigns and user data through an agent chat
Yandex Direct MCP generated from a machine-readable schema
yandex-direct-mcp
An MCP server and CLI covering all 113 Yandex Direct API v5 methods generated from WSDL, exposing 9 read tools by default and writes only on demand