YR

yurich-ru/yandex-ads-mcp

Developer tools

This page was translated automatically. Technical details may differ from the original. View the original

48 stars 15 forks Quality 72 Trend 27

MCP server for Yandex Direct, Metrika, Audience & Wordstat APIs — 152 tools for campaign management, audience segments, analytics, and keyword research

Overview

MCP server for managing ads in , segments in , analytics in and keyword selection through . for a full cycle of ad management from AI assistants (Claude Code, Cursor, Windsurf, etc.). Copy .env.example into .env and fill in: Add to ~/.claude.json (mcpServers section): One token is used for Yandex.Direct, Yandex.Metrica, and Yandex.Audience — if all services live in the same Yandex account. The OAuth token is tied to the account, so one token cannot cover two accounts. Issue a token in each account and break them down into variables: YD_OAUTH_TOKEN is an account with a Yandex.Direct account, YD_METRIKA_TOKEN / YD_AUDIENCE_TOKEN is an account with Yandex.Metrica and Audiences. 1. Go to https://oauth.yandex.ru/ 2. Press 3. Redirect URI: Select (https://oauth.yandex.ru/verification_code)] 4.

Overview (machine translated)

MCP server for managing ads in Yandex Direct, segments in Yandex Audiences, analytics in Yandex Metrica, and keyword selection through the Wordstat API.

152 tools for a full cycle of ad management from AI assistants (Claude Code, Cursor, Windsurf, etc.).

Features

Service Tools What it can do
Yandex Direct 86 Campaigns, groups, ads, keywords, autotargeting, bidding, adjustments, negative keywords, sitelinks, callouts, business cards, feeds, images, videos, retargeting, sites, strategies, reports
Yandex Metrica 43 Counters, Goals, Segments, Filters, Accesses, Reports, Annotations, Offline Conversions, Costs, Calls
Yandex Audiences 23 Segments from CRM data (email/phones/device IDs), lookalike, geo-segments, segments from Metrica/AppMetrica, pixels, permissions, delegates
Wordstat 5 Request Volume, Dynamics, Regional Distribution, Region Tree, API Quota

Quick Start

1. Installation

2. Token Setup

Copy .env.example to .env and fill in:

3. Connecting to Claude Code

Add to '~/.claude.

This page was translated automatically. Technical details may differ from the original.

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →