Yandex Direct MCP: hardened fork
yandex-direct-mcp
A fork of a popular Yandex Direct MCP server that defaults to read-only, with explicit flags for writes and finance
- 0 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- With writes enabled it changes campaigns, ad groups, ads and bids in a live account
- Finance tools top up balances and transfer money between accounts
- Stores the user's OAuth token locally
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/nikolaymokh-dev-yandex-direct-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- With writes enabled it changes campaigns, ad groups, ads and bids in a live account
- Finance tools top up balances and transfer money between accounts
- Stores the user's OAuth token locally
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent access to the Yandex Direct API through 146 tools: reports, stats, budget forecasts, Wordstat and dictionaries in the default analytics profile, while campaigns, ad groups, ads and bids only unlock when writes are explicitly enabled. Auth runs through the direct-cli package with PKCE: each user logs in under their own Yandex account, and the token is stored locally with restricted file permissions. Finance tools such as balance top-ups and transfers require a separate flag on top of writes. The tool surface can be narrowed with allow and deny lists by group or by specific tool name.
Who it is for. For PPC specialists who want to start with safe read access and turn on writes deliberately.
Good fit when
- You want Direct access that is read-only by default, without risk of accidental changes
- You want to widen the agent's rights gradually: analytics first, then campaigns, then finance
- You use Claude Code and want a one-command uvx install
Not a fit when
- You need a package with stable, guaranteed interfaces rather than a fast-moving fork
- You do not have time to work through tool profiles and allow-lists
Example request
Show Direct campaign stats for the last 14 days without changing anythingMCP
- Transport
- stdio
- Authentication
- OAuth
Environment variables
YANDEX_DIRECT_ENABLE_WRITES- true enables the campaign-editor profile with write access
YANDEX_DIRECT_ENABLE_FINANCE- true enables finance tools, only works together with ENABLE_WRITES
YANDEX_DIRECT_TOOL_PROFILE- Explicit profile choice: analytics, core, campaign-editor or full
Limitations
You need your own Yandex OAuth app with an approved Direct API application. The fork is unofficial, maintained by one author on top of axisrow/yandex-direct-mcp-plugin with a separate upstream sync process. Finance tools work with real money and require a deliberate flag on top of writes.
How to disable. Remove the server with claude mcp remove yandex-direct or delete the block from your MCP client config; Direct auth is stored separately in ~/.direct-cli/.
FAQ
Is it risky to install with no configuration?
No, only the analytics profile is active by default: reports and reads, no permission to change campaigns.
How is this different from the original axisrow/yandex-direct-mcp-plugin?
Same API coverage, but read-only by default, with separate flags for writes and finance and pinned dependency versions, detailed in the repo's FORK.md.
Discussion
No questions or reviews yet.
Related
All Yandex Direct toolsPython MCP for Yandex Direct and Wordstat
Yandex.Direct MCP
A Python MCP server with 48 Yandex Direct tools and Wordstat frequency lookup, switchable between sandbox and production
Yandex Direct MCP
yandex-direct-mcp
A Claude Code and Codex plugin for Yandex Direct: a 147-tool MCP server, OAuth, and skills for ad copy and stats analysis
Yandex Direct, Metrica and Wordstat MCP: fork with responsive ads
Yandex Direct MCP Server
A 120-tool fork of Yandex Ads MCP that adds responsive ad creation and IAM tokens from a service account key
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
Yandex Direct MCP server (npm)
@theyahia/yandex-direct-mcp
A TypeScript MCP server with an npm package: 20 tools for Yandex Direct campaigns, bids and negative keywords, with money always in rubles
An MCP server for Yandex Direct, Metrika, Wordstat and Webmaster: campaigns, ads, bids, reports and keyword research from chat
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Yandex Direct MCP: hardened fork (this card) | no | OAuth | 0 | |
| Yandex Ads MCP Server | no | OAuth | 50 | Direct, Metrika, Wordstat |
| Yandex Direct, Metrica and Wordstat MCP: fork with responsive ads | no | OAuth | 0 | combinatorial ads |
README in short
The README describes the fork as a hardened version of axisrow/yandex-direct-mcp-plugin with analytics, campaign-editor and full profiles, an environment variable table for controlling the tool surface, a uvx install for Claude Code, PKCE auth steps, and a separate flag for finance operations. It links to docs on access setup, the threat model and upstream sync.