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

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. 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.