Yandex Direct MCP
MCP server for Yandex Direct API v5 — campaigns, ads, keywords, reports
Connector by stufently · GitHub account verified by the MCP Registry
Chalk Labs
Need help deploying Yandex Direct MCP?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/stufently-yandex-direct-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: marketing-content, data-analysis
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 10 read · 19 write · 7 delete · 7 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 43
Read from the source code; the running server may list different tools.
Read 10 · Look things up without changing anything.
get_adgroupsget_adsget_bid_modifiersget_campaignsget_clientsget_dictionariesget_keyword_bidsget_keywordsget_sitelinksget_vcards
Write 19 · Create, change, send or run things.
add_adgroupsadd_adsadd_bid_modifiersadd_campaignsadd_keywordsadd_sitelinksadd_vcardsarchive_adgroupsarchive_adsarchive_campaignscreate_reportmoderate_ads
Show 7 more tools
set_auto_keyword_bidsset_bid_modifiersset_keyword_bidsupdate_adgroupsupdate_adsupdate_campaignsupdate_keywords
Delete 7 · Delete, drop, revoke or wipe things.
delete_adgroupsdelete_adsdelete_bid_modifiersdelete_campaignsdelete_keywordsdelete_sitelinksdelete_vcards
Not yet classified 7 · We could not tell from the name and description.
resume_campaignsresume_keywordssuspend_campaignssuspend_keywordsunarchive_adgroupsunarchive_adsunarchive_campaigns
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
YANDEX_DIRECT_TOKEN
Other settings (environment variables or headers).
YANDEX_DIRECT_CLIENT_LOGINYANDEX_DIRECT_SANDBOX
Network hosts it talks to 3
api-sandbox.direct.yandex.com· found in codeapi.direct.yandex.com· found in codegithub.com· found in code
Tools (43)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
add_adgroupsAdd new ad groups. Each must include Name, CampaignId, RegionIds, and optionally type-specific settings.
add_adsAdd new ads. Each must include AdGroupId and an ad-type-specific object (TextAd, DynamicTextAd, etc.).
add_bid_modifiersAdd bid modifiers. Each must include CampaignId or AdGroupId and an adjustment object.
add_campaignsAdd new campaigns. Pass a JSON array of campaign objects. Each must include Name and a campaign-type-specific settings object (e.g. TextCampaign, DynamicTextCampaign).
add_keywordsAdd new keywords. Each must include Keyword text and AdGroupId.
add_sitelinksAdd sitelink sets. Each set contains a Sitelinks array of {Title, Href, Description} objects (2-8 sitelinks per set).
add_vcardsAdd VCards. Each must include CampaignId, Country, City, CompanyName, WorkTime, and Phone.
archive_adgroupsArchive ad groups by IDs.
archive_adsArchive ads by IDs.
archive_campaignsArchive campaigns by IDs.
create_reportCreate a Yandex Direct report. Supported ReportType: ACCOUNT_PERFORMANCE_REPORT, AD_PERFORMANCE_REPORT, ADGROUP_PERFORMANCE_REPORT, CAMPAIGN_PERFORMANCE_REPORT, CRITERIA_PERFORMANCE_REPORT, CUSTOM_REPORT, REACH_AND_FREQUENCY_PERFORMANCE_REPORT, SEARCH_QUERY_PERFORMANCE_REPORT. DateRangeType: TODAY, YESTERDAY, THIS_MONTH, LAST_MONTH, THIS_QUARTER, LAST_QUARTER, THIS_YEAR, LAST_YEAR, ALL_TIME, CUSTOM_DATE, LAST_3_DAYS, LAST_5_DAYS, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, LAST_365_DAYS, AUTO. Result is returned as JSON array parsed from TSV (max 500 rows).
delete_adgroupsDelete ad groups by IDs. IRREVERSIBLE: ad groups and the statistics attached to them are lost permanently — re-adding creates new entities with new IDs, not the old ones back. Requires `confirm: true` — without it the tool refuses and calls nothing.
delete_adsDelete ads by IDs. IRREVERSIBLE: ads and the statistics attached to them are lost permanently — re-adding creates new entities with new IDs, not the old ones back. Requires `confirm: true` — without it the tool refuses and calls nothing.
delete_bid_modifiersDelete bid modifiers by IDs. IRREVERSIBLE: bid modifiers and the statistics attached to them are lost permanently — re-adding creates new entities with new IDs, not the old ones back. Requires `confirm: true` — without it the tool refuses and calls nothing.
delete_campaignsDelete campaigns by IDs. IRREVERSIBLE: campaigns and the statistics attached to them are lost permanently — re-adding creates new entities with new IDs, not the old ones back. Requires `confirm: true` — without it the tool refuses and calls nothing.
Show 28 more tools
delete_keywordsDelete keywords by IDs. IRREVERSIBLE: keywords and the statistics attached to them are lost permanently — re-adding creates new entities with new IDs, not the old ones back. Requires `confirm: true` — without it the tool refuses and calls nothing.
delete_sitelinksDelete sitelink sets by IDs. IRREVERSIBLE: sitelink sets and the statistics attached to them are lost permanently — re-adding creates new entities with new IDs, not the old ones back. Requires `confirm: true` — without it the tool refuses and calls nothing.
delete_vcardsDelete VCards by IDs. IRREVERSIBLE: VCards and the statistics attached to them are lost permanently — re-adding creates new entities with new IDs, not the old ones back. Requires `confirm: true` — without it the tool refuses and calls nothing.
get_adgroupsGet ad groups. Common FieldNames: Id, Name, CampaignId, Status, Type, RegionIds, NegativeKeywords, TrackingParams, ServingStatuses, Subtype.
get_adsGet ads. Common FieldNames: Id, AdGroupId, CampaignId, Status, State, Type, StatusClarification, TextAd, DynamicTextAd, MobileAppAd, CpmBannerAdBuilderAd, SmartAdBuilderAd. Use TextAd field to get ad texts.
get_bid_modifiersGet bid modifiers. Common FieldNames: Id, CampaignId, AdGroupId, Type, Level, MobileAdjustment, DesktopAdjustment, DemographicsAdjustment, RetargetingAdjustment, RegionalAdjustment, VideoAdjustment, SmartAdAdjustment, IncomeGradeAdjustment.
get_campaignsGet campaigns. Common FieldNames: Id, Name, Status, State, Type, StartDate, EndDate, DailyBudget, Statistics, ClientInfo, TimeTargeting, NegativeKeywords, BlockedIps, StatusPayment, StatusClarification, SourceId, Currency, Funds, RepresentedBy.
get_clientsGet client info (for agency accounts). Common FieldNames: Login, ClientId, ClientInfo, AccountQuality, Archived, CountryId, CreatedAt, Currency, Grants, Notification, OverdraftSumAvailable, Phone, Representatives, Restrictions, Settings, Type.
get_dictionariesGet Yandex Direct dictionaries (reference data). Available dictionaries: Currencies, MetroStations, GeoRegions, TimeZones, Constants, Categories, OperationSystemVersions, InterestCategories, Interests, AudienceInterests.
get_keyword_bidsGet keyword bids. Common FieldNames: KeywordId, AdGroupId, CampaignId, Bid, ContextBid, CurrentSearchPrice, MinSearchPrice, StrategyPriority.
get_keywordsGet keywords. Common FieldNames: Id, Keyword, AdGroupId, CampaignId, Status, State, Bid, ContextBid, StrategyPriority, UserParam1, UserParam2, Productivity, StatisticsSearch, StatisticsNetwork.
get_sitelinksGet sitelink sets. Common FieldNames: Id, Sitelinks. Each Sitelinks contains an array of {Title, Href, Description}.
get_vcardsGet VCards (business cards). Common FieldNames: Id, CampaignId, CompanyName, WorkTime, Phone, Street, Building, City, Country, Ogrn, InstantMessenger, ExtraMessage, ContactEmail, ContactPerson.
moderate_adsSend ads for moderation by IDs.
resume_campaignsResume campaigns by IDs.
resume_keywordsResume keywords by IDs.
set_auto_keyword_bidsSet automatic keyword bids (strategy-level). Pass a JSON array of auto-bid objects. Common fields: CampaignId, AdGroupId, KeywordId, Bid, ContextBid, and strategy parameters. SPENDS MONEY and is IRREVERSIBLE: these settings drive automatic bidding, the previous settings are overwritten and cannot be read back from the API. Requires `confirm: true` — without it the tool refuses and calls nothing.
set_bid_modifiersUpdate bid modifier values. Pass a JSON array of objects with Id and the new adjustment value. SPENDS MONEY and is IRREVERSIBLE: modifiers multiply the bid actually paid, the previous values are overwritten and cannot be read back from the API. Requires `confirm: true` — without it the tool refuses and calls nothing.
set_keyword_bidsSet keyword bids. Pass a JSON array of bid objects with KeywordId, SearchBid (in micros), and/or NetworkBid (in micros). SPENDS MONEY and is IRREVERSIBLE: bids decide the cost per click, the previous bid is overwritten and cannot be read back from the API. Requires `confirm: true` — without it the tool refuses and calls nothing.
suspend_campaignsSuspend (pause) campaigns by IDs.
suspend_keywordsSuspend keywords by IDs.
unarchive_adgroupsUnarchive ad groups by IDs.
unarchive_adsUnarchive ads by IDs.
unarchive_campaignsUnarchive campaigns by IDs.
update_adgroupsUpdate existing ad groups. Pass a JSON array with Id and fields to update. IRREVERSIBLE: the previous values of the updated ad groups are overwritten and cannot be read back from the API afterwards. Requires `confirm: true` — without it the tool refuses and calls nothing.
update_adsUpdate existing ads. Pass a JSON array with Id and fields to update. IRREVERSIBLE: the previous values of the updated ads are overwritten and cannot be read back from the API afterwards. Requires `confirm: true` — without it the tool refuses and calls nothing.
update_campaignsUpdate existing campaigns. Pass a JSON array of campaign objects with Id and fields to update. IRREVERSIBLE: the previous values of the updated campaigns are overwritten and cannot be read back from the API afterwards. Requires `confirm: true` — without it the tool refuses and calls nothing.
update_keywordsUpdate existing keywords. Pass a JSON array with Id and fields to update. IRREVERSIBLE: the previous values of the updated keywords are overwritten and cannot be read back from the API afterwards. Requires `confirm: true` — without it the tool refuses and calls nothing.
Signals
- Stars
- 19
- Forks
- 1
- Open issues
- 1
- Last commit (this folder)
- Oct 16, 2026 (15 days ago)
- Last release
- Oct 16, 2026 (15 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.stufently/yandex-direct-mcp- Version
- 2.2.1
- Auth
- API key
- Packages
- npm @stufently/yandex-direct-mcp
- License
- MIT
- Repository
- github.com/stufently/yandex-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from stufently
- 0.646score
Yandex Metrika MCP
stufently
MCP server for Yandex Metrika API — web analytics, traffic, audience data
ConnectorAFreshness: ALocal★ 19Claude Code +5 - 0.646score
Yandex Wordstat MCP
stufently
MCP server for Yandex Wordstat API — keyword research for Russian/CIS markets
ConnectorAFreshness: ALocal★ 19Claude Code +5 - 0.646score
Yandex Webmaster MCP
stufently
MCP server for Yandex Webmaster API — site analytics, indexing, search queries
ConnectorAFreshness: ALocal★ 19Claude Code +5 - 0.643score
Yandex Search MCP
stufently
MCP server for Yandex Search API (v2, Cloud)
ConnectorAFreshness: ALocalRead-only★ 19Claude Code +5 - 0.640score
Aviasales Flight Prices
stufently
Flight price search via Aviasales/Travelpayouts: fares by route, cheapest days, flexible dates.
ConnectorAFreshness: ALocalRead-only★ 13↓ 70/wkClaude Code +5 - 0.637score
Google Webtools MCP
stufently
Google Search Console + GA4 for AI agents: properties, reports, indexing, verification, SEO.
ConnectorAFreshness: ALocal★ 6Claude Code +5
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get Yandex Direct MCP running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
Yandex Direct MCP. Agent Mart. https://agentmart.dev/connectors/stufently-yandex-direct-mcp (last updated 2026-10-24)