This server provides tools to manage Yandex.Direct advertising campaigns from any MCP client (e.g., Claude, Cursor), covering campaigns, ad groups, ads, keywords, bids, negative keywords, statistics, and account balance.
Campaign Management
List campaigns with filtering by status and type
Get detailed info about a specific campaign (budget, status, dates, stats)
Create new campaigns (name, type, start date, daily budget)
Update campaigns (name, budget, or status: SUSPEND/RESUME/ARCHIVE/UNARCHIVE)
Ad Group Management
List ad groups for selected campaigns (names, regions, statuses)
Create ad groups within a campaign with regional targeting
Delete ad groups and set negative keywords (minus-phrases)
Ad Management
List ads within ad groups (titles, texts, links, statuses)
Create text ads (headline, body, second headline, URL)
Update ads and manage statuses (pause, archive, moderation, delete)
Keyword Management
List keywords in ad groups (phrases, bids, statuses)
Add keywords to an ad group
Set bids for search and ad networks
Set campaign-level negative keywords
Statistics & Account
Retrieve campaign performance reports for a date range (impressions, clicks, cost, CTR, CPC)
Check account balance
Access the regions directory
Additional Notes
Budgets and bids are in rubles; the server converts to API micro-units automatically
Supports sandbox mode (YANDEX_DIRECT_SANDBOX=1) for safe testing
Supports agency mode via Client-Login header for managing client accounts
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@yandex-direct-mcp List all active campaigns"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🗄 Repository archived
Development has moved to theYahia/YaAll — a build where the entire Yandex layer lives in one place: official Yandex MCP servers, MCP for Direct and Metrika, the YaGEO skill, and the Wordstat gate.
The current version of what was here:
mcp/yandex-direct-mcp/Nothing is updated here anymore. Issues and pull requests — in YaAll.
Archived — development moved to theYahia/YaAll, a single repository bundling the whole Yandex stack. The current version of this package now lives at
mcp/yandex-direct-mcp/. Please open issues and pull requests there.
MCP server for the Yandex.Direct API — manage contextual advertising from any MCP client (Claude, Cursor, etc.): campaigns, ad groups, ads, keywords, bids, negative keywords, statistics, balance. 20 tools.
Money is in rubles (budgets, bids on input and output); the server itself converts to API micro-units. Sandbox for safe testing and agency mode (Client-Login) are supported.
Related MCP server: yandex-direct-mcp
{
"mcpServers": {
"yandex-direct": {
"command": "npx",
"args": ["-y", "@theyahia/yandex-direct-mcp"],
"env": {
"YANDEX_DIRECT_TOKEN": "ваш_токен"
}
}
}
}claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y @theyahia/yandex-direct-mcpVariable | Required | Purpose |
| yes | Yandex.Direct OAuth token |
| no |
|
| no | Client login for agency tokens ( |
The OAuth token is issued for an app registered in Yandex OAuth with access to the Direct API. Details — app registration and getting a token. API access must be requested in the Direct interface.
The create_campaign, create_text_ad, add_keywords, set_keyword_bids and other tools modify a live advertising account and can spend money. For debugging scenarios, enable the sandbox (YANDEX_DIRECT_SANDBOX=1).
Campaigns
Tool | Description |
| List of campaigns (filter by status/type, pagination) |
| Detailed campaign info by ID |
| Create a campaign (budget in rubles, strategy selection) |
| Update name/budget and/or status (SUSPEND/RESUME/ARCHIVE/UNARCHIVE) |
Ad groups
Tool | Description |
| Ad groups of selected campaigns |
| Create a group with region targeting |
| Delete groups by ID |
| Set group negative keywords |
Ads
Tool | Description |
| Ads in groups |
| Create a text ad (≤56/≤30/≤81) |
| Update headline/text/link |
| suspend/resume/archive/unarchive/moderate/delete |
Keywords and bids
Tool | Description |
| Keyword phrases in groups (bids in rubles) |
| Add keyword phrases |
| Set bids (search/network, rubles) on phrases/groups/campaigns |
| suspend/resume/delete |
| Set campaign negative keywords |
Statistics, account, reference data
Tool | Description |
| Statistics for a period (impressions, clicks, spend, CTR, CPC) |
| Account balance (Live API v4) |
| Region code reference (225 = Russia) |
Покажи все активные рекламные кампании
Создай кампанию "Летняя распродажа" с бюджетом 5000 ₽/день, старт 2026-05-01
Установи ставку 25 ₽ на ключевые фразы 111 и 222
Добавь минус-фразы "бесплатно", "скачать" в кампанию 12345
Какая статистика у кампаний 12345 и 67890 за последнюю неделю?
Найди код региона для Новосибирска
Покажи баланс аккаунтаnpm install
npm run build # tsc → dist/
npm test # vitest (моки fetch)
npm run dev # tsx src/index.tsMIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP for Yandex Direct: manage ad campaigns & analytics from Claude or ChatGPT
All HasData scraping tools in one MCP server: Google, TikTok, Instagram, maps, e-commerce and more.
Read-only Yandex Metrika MCP. Query visits, sources, geo, devices and more in plain language.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/yandex-direct-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server