# Yandex Direct MCP

> Yandex Direct MCP is an open-source MCP server for marketing and seo. MCP server that manages Yandex Direct campaigns, ads, keywords, bids and reports. It runs locally on your machine and is started by your AI client.

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

## About

Write access with no dry run is the headline caveat in the README: this server can create, update, delete and archive live campaigns and ads and set bids, and bids are expressed in micro-units, so a factor-of-1,000,000 mistake is a real risk. The author advises pointing it at the Yandex Direct sandbox (`YANDEX_DIRECT_SANDBOX=true`) until you trust the workflow.

As a guard, fourteen irreversible tools refuse to run unless the call carries a literal `confirm: true`. These are the seven delete tools, the four update tools for campaigns, ad groups, ads and keywords, and the three bid-setting tools. Without it, the tool returns an explanation and sends nothing to the Direct API. Additions, archive, suspend and moderate calls are deliberately left unguarded because each has an inverse.

It covers 43 tools for Yandex Direct API v5 across campaigns, ad groups, ads, keywords, bids, bid modifiers, sitelinks, vCards and reports. Known limits: the path is fixed to `/json/v5`, so the unified performance campaigns endpoint is unreachable, and the API's Units quota header is not surfaced. The npm package is not published yet, so it runs from source with Node.

## Features

- **43 Direct API tools:** Covers campaigns, ad groups, ads, keywords, bids, modifiers, sitelinks, vCards and reports.
- **Confirm guard:** Fourteen irreversible tools need `confirm: true` or they send nothing.
- **Sandbox mode:** `YANDEX_DIRECT_SANDBOX=true` routes calls to the Direct sandbox.
- **Agency support:** `YANDEX_DIRECT_CLIENT_LOGIN` lets agency accounts act for a client.
- **Destructive hints:** The guarded tools carry `destructiveHint` annotations so clients can warn before the call.
- **Reporting:** `create_report` and `get_dictionaries` pull performance data and reference lists.

## Good for

- Pause or resume keywords across campaigns from a chat
- Adjust keyword bids in bulk with a confirmation step
- Add sitelinks and vCards to ads
- Pull a Direct report for a campaign
- Rehearse an ad workflow in the sandbox before touching production

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `get_campaigns`: Reads campaigns in Yandex Direct
- `add_campaigns`: Creates campaigns in Yandex Direct
- `update_campaigns`: Updates campaigns in Yandex Direct
- `delete_campaigns`: Deletes campaigns in Yandex Direct
- `archive_campaigns`: Archives campaigns in Yandex Direct
- `unarchive_campaigns`: Unarchives campaigns in Yandex Direct
- `suspend_campaigns`: Suspends campaigns in Yandex Direct
- `resume_campaigns`: Resumes campaigns in Yandex Direct
- `get_adgroups`: Reads adgroups in Yandex Direct
- `add_adgroups`: Creates adgroups in Yandex Direct
- `update_adgroups`: Updates adgroups in Yandex Direct
- `delete_adgroups`: Deletes adgroups in Yandex Direct
- `archive_adgroups`: Archives adgroups in Yandex Direct
- `unarchive_adgroups`: Unarchives adgroups in Yandex Direct
- `get_ads`: Reads ads in Yandex Direct
- `add_ads`: Creates ads in Yandex Direct
- `update_ads`: Updates ads in Yandex Direct
- `delete_ads`: Deletes ads in Yandex Direct
- `archive_ads`: Archives ads in Yandex Direct
- `unarchive_ads`: Unarchives ads in Yandex Direct
- `moderate_ads`: Sends for moderation ads in Yandex Direct
- `get_keywords`: Reads keywords in Yandex Direct
- `add_keywords`: Creates keywords in Yandex Direct
- `update_keywords`: Updates keywords in Yandex Direct
- `delete_keywords`: Deletes keywords in Yandex Direct
- `suspend_keywords`: Suspends keywords in Yandex Direct
- `resume_keywords`: Resumes keywords in Yandex Direct
- `get_keyword_bids`: Reads keyword bids in Yandex Direct
- `set_keyword_bids`: Sets keyword bids in Yandex Direct
- `set_auto_keyword_bids`: Sets auto keyword bids in Yandex Direct
- `get_bid_modifiers`: Reads bid modifiers in Yandex Direct
- `add_bid_modifiers`: Creates bid modifiers in Yandex Direct
- `set_bid_modifiers`: Sets bid modifiers in Yandex Direct
- `delete_bid_modifiers`: Deletes bid modifiers in Yandex Direct
- `get_sitelinks`: Reads sitelinks in Yandex Direct
- `add_sitelinks`: Creates sitelinks in Yandex Direct
- `delete_sitelinks`: Deletes sitelinks in Yandex Direct
- `get_vcards`: Reads vcards in Yandex Direct
- `add_vcards`: Creates vcards in Yandex Direct
- `delete_vcards`: Deletes vcards in Yandex Direct
- `create_report`: Creates report in Yandex Direct
- `get_dictionaries`: Reads dictionaries in Yandex Direct
- `get_clients`: Reads clients in Yandex Direct

## FAQ

### Can it change live ads?

Yes. It has write access to live campaigns, ads and bids and no dry-run mode, so the README recommends the sandbox first.

### What is the confirm flag?

Fourteen irreversible tools refuse unless called with a literal `confirm: true`; strings like "yes" or 1 are refused.

### How do I install it?

The README says nothing is published on the npm scope yet, so clone the repo, run `bun install` and start `src/index.mjs` with Node.

### What credentials does it need?

`YANDEX_DIRECT_TOKEN`, an OAuth token for Direct API v5; `YANDEX_DIRECT_CLIENT_LOGIN` is only for agency accounts.

### Are there known limits?

It uses the `/json/v5` path only, and the Units quota header is not shown to the client.

### 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 yandex-direct-mcp --env YANDEX_DIRECT_TOKEN='<YANDEX_DIRECT_TOKEN>' -- npx -y @stufently/yandex-direct-mcp

### 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
