Skip to content
Agentmart
Submit a tool

Yandex Direct MCP

MCP server for Yandex Direct API v5 — campaigns, ads, keywords, reports

Connector by stufently · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 19
Write a review

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.

Book a call

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.

We use your email only for this newsletter. Privacy

About

MCP server for Yandex Direct API v5 — campaigns, ads, keywords, reports

Use cases: marketing-content, data-analysis

No 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_adgroups
  • get_ads
  • get_bid_modifiers
  • get_campaigns
  • get_clients
  • get_dictionaries
  • get_keyword_bids
  • get_keywords
  • get_sitelinks
  • get_vcards

Write 19 · Create, change, send or run things.

  • add_adgroups
  • add_ads
  • add_bid_modifiers
  • add_campaigns
  • add_keywords
  • add_sitelinks
  • add_vcards
  • archive_adgroups
  • archive_ads
  • archive_campaigns
  • create_report
  • moderate_ads
Show 7 more tools
  • set_auto_keyword_bids
  • set_bid_modifiers
  • set_keyword_bids
  • update_adgroups
  • update_ads
  • update_campaigns
  • update_keywords

Delete 7 · Delete, drop, revoke or wipe things.

  • delete_adgroups
  • delete_ads
  • delete_bid_modifiers
  • delete_campaigns
  • delete_keywords
  • delete_sitelinks
  • delete_vcards

Not yet classified 7 · We could not tell from the name and description.

  • resume_campaigns
  • resume_keywords
  • suspend_campaigns
  • suspend_keywords
  • unarchive_adgroups
  • unarchive_ads
  • unarchive_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_LOGIN
  • YANDEX_DIRECT_SANDBOX

Network hosts it talks to 3

  • api-sandbox.direct.yandex.com · found in code
  • api.direct.yandex.com · found in code
  • github.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_adgroups

    Add new ad groups. Each must include Name, CampaignId, RegionIds, and optionally type-specific settings.

  • add_ads

    Add new ads. Each must include AdGroupId and an ad-type-specific object (TextAd, DynamicTextAd, etc.).

  • add_bid_modifiers

    Add bid modifiers. Each must include CampaignId or AdGroupId and an adjustment object.

  • add_campaigns

    Add 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_keywords

    Add new keywords. Each must include Keyword text and AdGroupId.

  • add_sitelinks

    Add sitelink sets. Each set contains a Sitelinks array of {Title, Href, Description} objects (2-8 sitelinks per set).

  • add_vcards

    Add VCards. Each must include CampaignId, Country, City, CompanyName, WorkTime, and Phone.

  • archive_adgroups

    Archive ad groups by IDs.

  • archive_ads

    Archive ads by IDs.

  • archive_campaigns

    Archive campaigns by IDs.

  • create_report

    Create 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_adgroups

    Delete 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_ads

    Delete 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_modifiers

    Delete 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_campaigns

    Delete 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_keywords

    Delete 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_sitelinks

    Delete 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_vcards

    Delete 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_adgroups

    Get ad groups. Common FieldNames: Id, Name, CampaignId, Status, Type, RegionIds, NegativeKeywords, TrackingParams, ServingStatuses, Subtype.

  • get_ads

    Get ads. Common FieldNames: Id, AdGroupId, CampaignId, Status, State, Type, StatusClarification, TextAd, DynamicTextAd, MobileAppAd, CpmBannerAdBuilderAd, SmartAdBuilderAd. Use TextAd field to get ad texts.

  • get_bid_modifiers

    Get bid modifiers. Common FieldNames: Id, CampaignId, AdGroupId, Type, Level, MobileAdjustment, DesktopAdjustment, DemographicsAdjustment, RetargetingAdjustment, RegionalAdjustment, VideoAdjustment, SmartAdAdjustment, IncomeGradeAdjustment.

  • get_campaigns

    Get campaigns. Common FieldNames: Id, Name, Status, State, Type, StartDate, EndDate, DailyBudget, Statistics, ClientInfo, TimeTargeting, NegativeKeywords, BlockedIps, StatusPayment, StatusClarification, SourceId, Currency, Funds, RepresentedBy.

  • get_clients

    Get client info (for agency accounts). Common FieldNames: Login, ClientId, ClientInfo, AccountQuality, Archived, CountryId, CreatedAt, Currency, Grants, Notification, OverdraftSumAvailable, Phone, Representatives, Restrictions, Settings, Type.

  • get_dictionaries

    Get Yandex Direct dictionaries (reference data). Available dictionaries: Currencies, MetroStations, GeoRegions, TimeZones, Constants, Categories, OperationSystemVersions, InterestCategories, Interests, AudienceInterests.

  • get_keyword_bids

    Get keyword bids. Common FieldNames: KeywordId, AdGroupId, CampaignId, Bid, ContextBid, CurrentSearchPrice, MinSearchPrice, StrategyPriority.

  • get_keywords

    Get keywords. Common FieldNames: Id, Keyword, AdGroupId, CampaignId, Status, State, Bid, ContextBid, StrategyPriority, UserParam1, UserParam2, Productivity, StatisticsSearch, StatisticsNetwork.

  • get_sitelinks

    Get sitelink sets. Common FieldNames: Id, Sitelinks. Each Sitelinks contains an array of {Title, Href, Description}.

  • get_vcards

    Get VCards (business cards). Common FieldNames: Id, CampaignId, CompanyName, WorkTime, Phone, Street, Building, City, Country, Ogrn, InstantMessenger, ExtraMessage, ContactEmail, ContactPerson.

  • moderate_ads

    Send ads for moderation by IDs.

  • resume_campaigns

    Resume campaigns by IDs.

  • resume_keywords

    Resume keywords by IDs.

  • set_auto_keyword_bids

    Set 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_modifiers

    Update 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_bids

    Set 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_campaigns

    Suspend (pause) campaigns by IDs.

  • suspend_keywords

    Suspend keywords by IDs.

  • unarchive_adgroups

    Unarchive ad groups by IDs.

  • unarchive_ads

    Unarchive ads by IDs.

  • unarchive_campaigns

    Unarchive campaigns by IDs.

  • update_adgroups

    Update 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_ads

    Update 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_campaigns

    Update 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_keywords

    Update 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
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from stufently

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.

Goes to the Chalk Labs founders, not the newsletter. Privacy

Need help deploying Yandex Direct MCP?

CallGet help
Cite this page

Yandex Direct MCP. Agent Mart. https://agentmart.dev/connectors/stufently-yandex-direct-mcp (last updated 2026-10-24)