Yandex Direct MCP: Documentation

Connection

npx -y @theyahia/yandex-direct-mcp (stdio; a fresh process per client launch, no HTTP mode). Auth: YANDEX_DIRECT_TOKEN, a Yandex OAuth token for an app with Direct API access (oauth.yandex.ru); optionally YANDEX_DIRECT_LOGIN for agency tokens and YANDEX_DIRECT_SANDBOX=1 for a test environment with no real charges.

Capabilities

20 tools: campaigns (list_campaigns, get_campaign, create_campaign, update_campaign — SUSPEND/RESUME/ARCHIVE/UNARCHIVE), ad groups (list_ad_groups, create_ad_group, delete_ad_groups, set_ad_group_negative_keywords), ads (list_ads, create_text_ad, update_text_ad, manage_ads — suspend/resume/archive/moderate/delete), keywords and bids (list_keywords, add_keywords, set_keyword_bids, manage_keywords, set_campaign_negative_keywords), stats and account (get_statistics, get_account_balance, get_regions).

Agent flow

"Show active campaigns and the account balance", "raise bids for group 555 by 15%", "pull click and spend stats for the week".

Note

A community project (theYahia), not affiliated with Yandex. As of 08.07.2026 the altrr2/yandex-tools-mcp monorepo also ships an unrelated, unscoped yandex-direct-mcp package (21 tools) — this card is about @theyahia/yandex-direct-mcp specifically. Tools like create_campaign, create_text_ad, add_keywords and set_keyword_bids modify the live ad account and spend real money — there's no in-server confirmation, so test with YANDEX_DIRECT_SANDBOX=1. Transport is stdio only.