# Yandex Direct MCP

> Yandex Direct MCP is an open-source MCP server for marketing and seo. Manage Yandex Direct ad campaigns, keywords and stats from an AI chat. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/askads/mcp-yandex-direct
- **MCP Registry name:** io.github.askads/mcp-yandex-direct
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

The README is written in Russian and describes 46 tools covering campaigns, ad groups, ads, keyword phrases, bids, bid adjustments, extensions, statistics, account balance and reference data. Account connection can also happen inside the conversation: the assistant gives a Yandex sign-in link, you confirm access and send back the code, and access then lasts about a year.

There are two ways to connect. A remote server at mcp.askads.ru is read-only and suited to statistics, audits and browsing objects. The local npx package gives full access, including creating and editing objects. New campaigns and ads can only be created as text type; campaigns of other types can be read, renamed, stopped, archived and deleted by ID.

Local changes apply to the live ad account and can affect spend, and the registry entry warns that the OAuth token gives full account access. A sandbox switch (YANDEX_DIRECT_SANDBOX) points calls at the Yandex Direct test API instead. Money values are shown in the account currency rather than API micro-units, and agency accounts can pick a client by login.

## Features

- **46 tools:** Covers campaigns, groups, ads, keywords, bids, adjustments, extensions and statistics.
- **Two connection modes:** Read-only remote URL or full-access local npx package.
- **In-chat sign-in:** Connect a Yandex account by following a link and sending back a code.
- **Sandbox mode:** An environment variable switches calls to the Yandex Direct sandbox API.
- **Readable money values:** Budgets, bids and balance appear in account currency, not micro-units.
- **Agency client switching:** Pick a client login per call or list managed clients.

## Good for

- Find which campaigns spent the most last week
- Review keywords that spend budget without clicks
- Check balance and remaining daily API quota
- Add keyword phrases to an ad group with a set bid
- Compare spend per client across an agency's accounts

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-yandex-direct --env YANDEX_DIRECT_TOKEN='<YANDEX_DIRECT_TOKEN>' -- npx -y mcp-yandex-direct
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-yandex-direct": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-yandex-direct": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-direct"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
      }
    }
  }
}
```

## Tools

- `list_clients`: Lists managed client accounts.
- `set_campaign_strategy`: Changes the strategy and weekly budget of text and unified campaigns.

## FAQ

### Can it change my ads?

The local npx version can create and edit objects in the live account. The remote URL version is read-only.

### Is there a way to test safely?

Yes. Setting YANDEX_DIRECT_SANDBOX to true makes it call the Yandex Direct sandbox API.

### What does it need to run locally?

Node.js 20 or newer and a Yandex Direct OAuth token, which can be obtained through the in-chat sign-in.

### Which campaign types can it create?

Only text campaigns and ads. Other campaign types can be read, renamed, stopped, archived or deleted.

### Is Yandex Direct MCP free?

Yes. Yandex Direct MCP is open source, so you can use and self-host it for free.

### How do I add Yandex Direct MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-yandex-direct --env YANDEX_DIRECT_TOKEN='<YANDEX_DIRECT_TOKEN>' -- npx -y mcp-yandex-direct

### What are the best alternatives to Yandex Direct MCP?

The closest alternatives to Yandex Direct MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Customer Io, Google_search_console and Ads AI Creator MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Customer Io](https://ai-powered.com/mcp/customer-io): Customer Io is a freemium MCP server for marketing and seo.
- [Google_search_console](https://ai-powered.com/mcp/google-search-console-8): Google_search_console is a freemium MCP server for web search and scraping.
- [Ads AI Creator MCP](https://ai-powered.com/mcp/ads-ai-creator-mcp): Ads AI Creator MCP is a paid MCP server for marketing and seo.
- [Zovo QR Code Maker](https://ai-powered.com/mcp/zovo-qr-code-maker): Zovo QR Code Maker is an MCP server for marketing and seo.
- [Agentzia](https://ai-powered.com/mcp/agentzia): Agentzia is a freemium MCP server for marketing and seo.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.

---
Source: https://ai-powered.com/mcp/yandex-direct-mcp-4
