Yandex Direct MCP with two access modes

Яндекс Директ MCP

A Yandex Direct MCP with two connection modes: a read-only remote URL and a full-access local npx server

  • 4 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • The local mode changes ad settings in a live account and can affect spend
  • The OAuth token auto-refreshes and grants long-lived account access
All reasons and checks
Russian stack

askads/mcp-yandex-direct

A similar tool with a larger community: Yandex Direct MCP server in Ruby, 6 ★ on the repository

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/yandeks-direkt-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The local mode changes ad settings in a live account and can affect spend
  • The OAuth token auto-refreshes and grants long-lived account access

This is third-party code. Review the repository files before installing.

What it does

The server gives 44 tools: campaigns, groups, ads, keywords, bids, adjustments, extensions, statistics, balance and dictionaries. There are two connection modes. The remote server at mcp.askads.ru/mcp works via browser OAuth with no manual token, but is read-only: statistics, audits and account objects with no changes. The local npx server gives full write access; its connection also starts in chat via a one-time Yandex code, and the token refreshes automatically. Budgets, bids and balance are shown in the account currency, not API micro-units.

Who it is for. For people who want quick Yandex Direct analytics with no token, and the option to move to full campaign management when needed.

Good fit when

  • You want quick read-only access to statistics and account structure with no token upfront
  • You need full write access: pausing, bids, negative keywords from the local server
  • You need to compare campaigns, ads and keywords and see where budget goes

Not a fit when

  • You need the remote server but with write access: the URL version is deliberately read-only
  • You have no Node.js 20+ and cannot run npx locally
  • You need a sandbox: the README does not describe a separate sandbox mode

Example request

Show my account's campaigns and last week's spend broken down by ad group

MCP

Transport
http, stdio
Authentication
OAuth

Environment variables

YANDEX_DIRECT_TOKEN secret
A ready token for CI and agent setups of the local mode
YANDEX_DIRECT_LOGIN
Client login for agency tokens

Limitations

Local changes apply to the live account and can affect spend; the README does not describe a separate sandbox flag. CI and agent setups need a ready token and YANDEX_DIRECT_LOGIN. The remote mode is read-only and will not work if you need writes without installing npx.

How to disable. Run claude mcp remove yandex-direct in Claude Code or remove the yandex-direct block from your client config.

FAQ

What is the difference between remote and local mode?

The remote URL mode needs no install and is read-only; the local npx mode gives full write access and needs Node.js 20+.

Do I need a token in advance?

No in either mode: the remote one signs in via the browser immediately, and the local one walks through a one-time Yandex code right in chat.

Discussion

No questions or reviews yet.

Russian stack

A fork of a popular Yandex Direct MCP server that defaults to read-only, with explicit flags for writes and finance

MCP serverBroad access
Russian stack

A single-file, dependency-free Node.js Direct API v5 MCP server with a universal direct_call tool and a read-only mode

MCP serverBroad access

Yandex Direct MCP server (npm)

@theyahia/yandex-direct-mcp

Russian stack

A TypeScript MCP server with an npm package: 20 tools for Yandex Direct campaigns, bids and negative keywords, with money always in rubles

MCP serverBroad access4Repository stars
Russian stack

A dependency-free, pure Ruby MCP server with 30 tools for Yandex Direct campaigns, ad groups, ads, keywords and reports

MCP serverBroad access6Repository stars
Russian stack

20 Yandex Direct tools where every edit shows the plan by default and needs confirm=True to actually send anything

MCP serverBroad access

Yandex Direct MCP

yandex-direct-mcp

Russian stack

A Claude Code and Codex plugin for Yandex Direct: a 147-tool MCP server, OAuth, and skills for ad copy and stats analysis

PluginBroad access14Repository stars

README in short

The README compares the two connection modes in a table and gives ready instructions for Codex, Claude Code and other clients. Separate 'How it works' and 'What can change data' sections explain the read-only versus full-access difference, and a telemetry section describes anonymous usage stats disabled via an environment variable.

README badge

Report a problem