MCP server connects Yandex Direct to AI assistants. Create campaigns, write ads, and analyze results right in Claude Code.
Everything you need to manage Yandex Direct campaigns — from creation to analytics
Create, edit, pause, and resume ad campaigns with budget and negative keyword settings
Geo-targeting by regions, cities, and countries. Group-level negative keywords
Text and image ads with titles, copy, and links. Submit for moderation
Add, update, and manage keywords. Pause and resume impressions
Campaign, ad, and search query statistics: impressions, clicks, spend, CTR
Regions for geo-targeting, currencies, audience interests, and other reference data
Connect the MCP server to Claude Code and start managing your ads
Register an app at oauth.yandex.ru with Yandex Direct API access permissions
In Yandex Direct go to Tools → API → My Applications. The API starts working right after submission
Authorize via OAuth and copy the token from the address bar
Copy the MCP server config into your project's .mcp.json or the global ~/.claude.json
Restart Claude Code — all 30 tools are available via chat
{
"mcpServers": {
"yandex-direct": {
"command": "ruby",
"args": ["path/to/bin/server"],
"env": {
"YANDEX_DIRECT_TOKEN": "your_token"
}
}
}
}
Complete toolkit for managing ad campaigns
| Tool | Description | Type |
|---|---|---|
| campaigns_get | List campaigns with filtering | read |
| campaigns_add | Create a campaign with budget | write |
| campaigns_update | Update parameters | write |
| campaigns_suspend | Pause impressions | write |
| campaigns_resume | Resume impressions | write |
| campaigns_delete | Archive campaigns | delete |
| adgroups_get | Ad groups | read |
| adgroups_add | Create with geo-targeting | write |
| ads_get | List ads | read |
| ads_add | Create an ad | write |
| ads_moderate | Submit for moderation | write |
| keywords_get | Keywords | read |
| keywords_add | Add keywords | write |
| report_campaign | Campaign statistics | read |
| report_search_queries | Search queries | read |
| dictionaries_regions | Regions directory | read |
| dictionaries_interests | Audience interests | read |