Log inSubmit server
Yandex Direct logo

Yandex Direct

Manage Yandex Direct campaigns, ads, keywords, bids, and reporting through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Yandex Direct

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct@latest"
      ],
      "env": {
        "YANDEX_DIRECT_LOGIN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 46 tools correctly (7d ago).

Overview

Yandex Direct MCP server connects AI applications to the Yandex Direct advertising cabinet through 46 tools for campaigns, ads, keywords, bids, reports, balances, and account data. A remote HTTP endpoint provides read-only access for analysis, while the local npm package supports creating and modifying advertising objects. Authentication starts in the chat through a Yandex sign-in flow, making it useful for campaign audits, budget analysis, and controlled PPC changes.

Use cases

  • Audit campaign spend by group, ad, or keyword
  • Compare PPC performance across campaigns
  • Find paused, moderated, or inefficient ads
  • Prepare new text campaigns and keyword structures
  • Apply reviewed bid or ad changes

Key features

  • 46 tools for Yandex Direct account operations
  • Campaign, ad, keyword, and bid management
  • Statistics and budget reporting in account currency
  • Read-only remote HTTP connection
  • Full local access through npx
  • Interactive Yandex account authorization

Tools46

What Yandex Direct lets your agent do. Expand a tool for its parameters.

Verified live~15.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

19/23 checks healthy over the last 90d

What it can do

From the 46 tools this server returned when we ran it; 46 declare their own safety hints.

Can delete or modify data · 11Makes network requests · 46Read-only tools · 35
Network at startup4 connections
Files written at startup1
Install scriptsprepare
npm provenanceNot published
Package age139 days
Maintainers1

Observed 2026-11-01 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · mcp-yandex-direct@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads3.5kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed46Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Yandex Direct works

What Yandex Direct does

Yandex Direct exposes the main structures of a Yandex advertising account to an MCP-compatible AI application. Its tools cover campaigns, ad groups, text ads, keyword phrases, bids, bid adjustments, extensions, statistics, balances, reference data, and account connections.

The server is suited to both reporting and account operations. An assistant can connect campaign spend with groups, ads, and keywords; compare metrics such as spend, CTR, and average cost per click; inspect moderation or delivery status; and review account balances and API quota. It can also prepare or apply selected changes in the advertising cabinet.

New campaigns, groups, text ads, and keyword phrases can be created. Campaigns of other types can be viewed and can be renamed, budget-adjusted, paused, archived, or deleted by identifier.

How it works

Two connection modes are available. The remote endpoint at https://mcp.askads.ru/mcp is added to an AI application that supports MCP over a URL. It is intended for reading statistics and advertising objects, audits, and account inspection; it does not modify advertising settings.

The local mode runs through npx -y mcp-yandex-direct@latest and provides access to account-changing operations. Node.js 20 or newer is required for this mode. The package is downloaded by npx when first started, so a separate package installation is unnecessary.

Authentication begins from the conversation. The assistant provides a Yandex sign-in link, and the user confirms access in a browser before returning the displayed code. The connected account can then be used without restarting the application. Access remains available for approximately one year.

Statistics are generated through Yandex Direct's reporting service. A statistics request waits for the report to become available, and large paginated result sets are traversed automatically.

Setup and configuration

Add the remote URL through the MCP settings of an HTTP-capable client, or register the local stdio command:

Terminal
npx -y mcp-yandex-direct@latest

Examples of supported client setup include Codex, Claude Code, Claude Desktop, Cursor, and VS Code. Codex and Claude Code also provide command-line registration commands. Claude Desktop uses its MCP configuration file, Cursor uses mcp.json, and VS Code uses the MCP user configuration.

For automated or agent-based installations, the project documents a ready token together with the YANDEX_DIRECT_LOGIN setting. Interactive use can instead complete the Yandex authorization flow in the chat.

Tools and capabilities

  • Inspect campaigns, groups, ads, keywords, balances, and account information.
  • Generate statistics by campaign, ad group, ad, or keyword.
  • Compare spend, clicks, CTR, conversions, and average click costs.
  • Review bid adjustments, negative keywords, quick links, clarifications, business cards, and images.
  • Create text campaigns, groups, ads, and keyword phrases.
  • Change bids, pause ads, update campaign settings, and add assets through the local connection.

Limitations and notes

The local connection can affect the live advertising account, including spend-related settings, so changes should be explicitly reviewed before application. The remote URL connection is read-only. New campaign and ad creation is limited to text formats, while other campaign types are available for inspection and selected management operations.

Yandex Direct statistics are not returned instantly because reports must be prepared by the reporting service. The service also provides a sandbox option for testing work against a non-production environment.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Yandex Direct

Yandex Direct is an MCP server that connects AI applications to the Yandex Direct advertising cabinet. Its tools manage campaigns, groups, text ads, keywords, bids, bid adjustments, statistics, balances, and account data, with read-only remote access or full local access for approved changes.

Run `npx -y mcp-yandex-direct@latest` through your MCP client's local stdio configuration. Node.js 20 or newer is required. The package downloads on first launch, and authentication can be completed interactively through a Yandex sign-in link.

Yes, Yandex Direct works with Cursor through its `mcp.json` configuration. Add the local `npx -y mcp-yandex-direct@latest` command to the user-level or project-level MCP file, then authorize the Yandex account from the chat.

Yes, the local connection can change the live advertising cabinet, including bids, ads, campaigns, and other supported objects. The remote HTTP endpoint is read-only, so use it for reporting and audits when changes must be prevented.

Yes, interactive authentication starts in the conversation rather than requiring a token in advance. The assistant opens a Yandex sign-in flow, and you return the code shown after confirming access to the advertising cabinet.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewYandex Direct AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/yandex-direct?style=directory)](https://allmcps.com/mcp/yandex-direct)
HTML Embed
<a href="https://allmcps.com/mcp/yandex-direct"><img src="https://allmcps.com/api/badge/yandex-direct?style=directory" alt="Yandex Direct on AllMCPs" /></a>