Direct Manager — MCP for Yandex Direct

Connect Claude or ChatGPT to Yandex Direct and manage ads in a conversation: "Where is money being wasted?" → the assistant finds campaigns with ROAS < 1 and suggests what to turn off.

Try free — 7 days of the "Pro" plan →

Website: https://app.marketscore.ru

What It Is

marketscore-direct-mcp is a thin connector to the Direct Manager host MCP server. The server itself, access to the Direct API, and all logic run on the service side — this package only connects your AI assistant to it.

The service has two independent MCP servers: advertising (Direct, VK, Avito, Wordstat) and SEO (Webmaster, Search Console, Metrika, Topvisor) — see the SEO section below.

Here's how it works:

You: Where is my money being wasted over the last 14 days?

Claude: Found 3 problems worth 12,400 ₽: campaign "Ремонт квартир — РСЯ" spent 4,210 ₽ without a single conversion; site dsp.example gives ROAS 0.2; 6 keywords with spend and zero leads. Turn off the site and add keywords to negative keywords?

Related MCP server: meta-ads-mcp-server

Capabilities

Up to 116 tools over Direct API v5 and Reports API (on "Assistant" and "Pro" plans — 111, on "Agency" — 116, including the portfolio accounts_overview):

• Analytics and statistics — campaign metrics by period and slices: device, gender, age, Yandex Display Network sites, geo; search queries; impression share.

• Inefficient spend detection — campaigns with ROAS < 1, spend without conversions, unnecessary sites and keywords.

• Management — pause/resume, daily and weekly budget, strategies (including conversion-based with goal and target CPA/ROAS), negative keywords, keywords, bids and adjustments.

• Campaign building from scratch — campaign → ad group → ad with sitelinks and UTM.

• AI insights — 30-day spend and conversion forecast, diagnostics of drops (traffic/CR/CPC), period-over-period change explanation with drivers, ranked top findings in rubles, a ready weekly brief in one call.

• Wordstat — keyword suggestions with frequencies.

• For agencies — portfolio overview across all accounts: spend, profit, wasted spend, and remaining budget per client in one response.

Write actions are marked with separate annotations — the assistant and the client see what exactly changes before applying the edit. Direct API errors are handled correctly, including "silent" ones (when the API returns 200 but the edit wasn't applied).

MarketScore SEO — A Second MCP for Search Engine Optimization

The same account has a separate MCP server for SEO: it's not about ads but about organic search — Yandex Webmaster, Google Search Console, Yandex Metrika, Topvisor, and Wordstat in one assistant.

https://app.marketscore.ru/api/mcp/seo

This is a different address and a different subscription: the SEO plan is not included in Direct plans and vice versa. Direct tools do not appear on the SEO address, and vice versa.

You: Why has organic search traffic dropped over the last 28 days?

Claude: Clicks fell from 940 to 610. I currently compare only by sources that measured both periods: Search Console — yes, Webmaster — yes, Topvisor not connected, positions not independently checked. The main drop is the /catalog section: 18 pages fell out of Yandex search with reason "duplicate", Webmaster has seen this since August 3. Show the list of URLs?

21 tools, of which only three change anything (seo_add_keywords, seo_add_competitors, seo_request_recrawl) — the rest are read-only:

• Search data — seo_overview (clicks, impressions, CTR, average position, top-3/top-10 and period comparison), seo_search_queries (queries and pages from Webmaster and Search Console by device and region), seo_positions (latest Topvisor check), seo_indexation (how many pages are in Yandex search, what is excluded and why), seo_metrika (visitor behavior from search and goal completions), seo_landing_pages (visits and leads by landing page).

• Site work — seo_audit (analysis of indexing, technical, on-page, and competition of pages with the source for each conclusion), seo_page_analysis (speed, Core Web Vitals, and on-page signals of a page), seo_opportunities (queries near the top, pages with low CTR, impressions without clicks, cannibalization), seo_sitemaps (do Yandex and Google see the sitemap?), seo_url_inspection (Google's verdict for a specific URL), seo_request_recrawl (send a URL for re-crawling in Yandex), seo_text_check (AI clichés, officialese, and over-optimization in ready-made Russian text).

• Demand — seo_keyword_demand: frequency, similar phrases, noise markup, and seasonality from Wordstat.

• Keywords and checks — seo_keywords (what is being tracked for positions), seo_add_keywords (submit phrases for tracking), seo_positions_plan (check schedule, launch price, and Topvisor balance).

• Competitors — seo_competitors (our positions next to theirs), seo_add_competitors (add competitor sites to the project).

• Project — seo_projects (account websites) and seo_sources (what is connected, what has expired, and what exactly becomes unknown while the source is down).

What is done differently here than in wrappers over the same APIs:

• The answer carries provenance. Every number has a source and fetch date. Revoked access to Webmaster is shown as a source failure, not as zero traffic: "no data" and "no problems" are different answers, and the model should not confuse them.

• Unfulfilled checks are listed. An audit with a silent source or without confirmed rights to the site returns a list of "what exactly was not checked and why" and caps the assessment, rather than lowering it to "everything is fine".

• The write boundary is drawn at money. Paid launch of position tracking, schedule changes, deletion of keywords and competitors are intentionally not exposed to chat — they deduct money from the Topvisor balance, and the price should be visible on the screen before the deduction. Two of the writing tools increase the cost of the next position check, and the assistant must state this consequence before the call.

• What we don't promise: no full site crawl — one page is checked per call; text uniqueness is not checked (we don't have a source); positions without a connected Topvisor are not invented.

SEO plans (separate subscription, 7 days free): "Start" — 590 ₽/month (1 site, 2 audits, 20 Wordstat queries), "Pro" — 1,490 ₽/month (5 sites, 10 audits, 200 Wordstat), "Agency" — 9,900 ₽/month (20 sites, 60 audits, 2,000 Wordstat). All 21 tools are available on any active SEO plan. Position checks work on the balance of your Topvisor account — no markup on them.

Details: https://app.marketscore.ru/seo

Installation

Claude (Desktop, Web, Code) and ChatGPT — via Link

Add a remote MCP connector:

https://app.marketscore.ru/api/mcp        реклама: Яндекс Директ, VK, Авито, Wordstat
https://app.marketscore.ru/api/mcp/seo    органика: Вебмастер, Search Console, Метрика, Topvisor

The assistant will open a login — authenticate via OAuth. The Yandex token is not passed to the assistant. Both addresses can be added simultaneously: they are independent connectors with independent subscriptions.

Local MCP Clients (Cursor, VS Code, Cline, Zed) — via a Bridge

npx -y marketscore-direct-mcp

Example MCP client configuration:

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

Plans and Access

The connector requires a Direct Manager account. On registration — 7 days of the "Pro" plan free (including the AI assistant in Claude/ChatGPT). Thereafter:

• "Assistant" — 990 ₽/month: full MCP set (111 tools) for working from the AI chat, up to 3 Direct accounts. No web dashboard — only the assistant.

• "Pro" — 1,990 ₽/month: the same 111 tools plus a web dashboard with analytics and autopilot, up to 5 Direct accounts.

• "Agency" — 9,900 ₽/month: 116 tools (plus the portfolio overview accounts_overview), up to 20 accounts.

• SEO — a separate axis of plans (590 / 1,490 / 9,900 ₽/month) and a separate connector address. The Direct plan does not grant access to SEO tools, and vice versa.

Without an active plan, the server returns 0 tools. Registration: https://app.marketscore.ru/register · Plans: https://app.marketscore.ru/pricing · SEO: https://app.marketscore.ru/seo

How It Differs from Open-Source Wrappers over the Direct API

There are self-hosted MCP wrappers over the Direct API (e.g., mcp-yandex-direct). Honest comparison:

Security

• Authentication — OAuth 2.1: the Yandex token is not passed to the assistant and does not lie in the client config; it is stored on the service side.

• Changing the Direct Manager account password revokes all issued MCP accesses.

• Write actions are annotated and confirmed on the MCP client side.

• Personal data is stored on servers in Russia (Federal Law 152-FZ).

FAQ

Is it free? The first 7 days — yes (trial of the "Pro" plan on registration). Thereafter, a plan from "Assistant" (990 ₽/month, MCP-only) and up.

Where does the Direct token go? It is issued to the Direct Manager service during OAuth connection and stored on its servers. The assistant and MCP client do not see the token.

Can the assistant break something in the account? Write tools are marked separately, and the MCP client requests confirmation before calling them. Campaign pauses and budgets are not touched by the autopilot — only on your command.

Does it work with ChatGPT, Cursor, VS Code? Yes: Claude and ChatGPT connect via URL directly; Cursor/VS Code/Cline/Zed — via this package (npx -y marketscore-direct-mcp).

How is it different from free MCP wrappers? Besides API access — a layer of AI insights, audit, dashboard, Telegram bot, and portfolio overview; the Yandex token is not stored in the config. More details in the table above.

Does it work without a subscription? No — without an active plan, the server returns 0 tools.

Can you do SEO? Yes, via a separate MCP server: https://app.marketscore.ru/api/mcp/seo — 21 tools over Yandex Webmaster, Google Search Console, Metrika, Topvisor, and Wordstat. Subscription to it is separate from Direct plans, with a 7-day trial.

Docker

docker build -t marketscore-direct-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-direct-mcp

The OAuth URL is printed to stdout — the browser won't open from the container; follow the link manually. mcp-remote tokens live in ~/.mcp-auth — mount a volume to avoid re-authenticating on each run.

Useful Links

• What is an MCP server for Yandex Direct: https://app.marketscore.ru/blog/mcp-server-yandex-direct

• AI for Yandex Direct — tools 2026: https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026

• Managing Direct via Claude and ChatGPT: https://app.marketscore.ru/blog/upravlenie-yandex-direct-cherez-claude-chatgpt

• MCP server for Yandex Webmaster: https://app.marketscore.ru/blog/mcp-server-yandex-webmaster

• Neural network for SEO — what is actually automated: https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya

• Why clicks in Search Console do not match: https://app.marketscore.ru/blog/search-console-kliki-ne-shodyatsya

English

Direct Manager is an AI/MCP service for Yandex Direct (Russian search advertising). This package is a thin connector to the hosted Direct Manager MCP server: it lets Claude, ChatGPT, or any MCP client read campaign analytics and run actions (pause, bids, budgets, negative keywords) on a Yandex Direct account from chat.

Install (remote, Claude/ChatGPT): add connector URL https://app.marketscore.ru/api/mcp and sign in via OAuth.

Install (local MCP clients — Cursor, VS Code, Cline, Zed):

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

Tools: up to 116 tools on top of Direct API v5 and Reports API — campaign analytics by device/gender/age/placements/geo, search queries, impression share, wasted-spend detection (ROAS < 1), campaign management (pause, budgets, strategies, negative keywords, bids), building campaigns from scratch, AI insights (spend forecast, drop diagnosis, change explanation, weekly brief), Wordstat keyword research, and a cross-account portfolio overview for agencies.

SEO MCP (separate server): https://app.marketscore.ru/api/mcp/seo — 21 tools for organic search on top of Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor and Wordstat: search performance and period comparison, queries and pages, Yandex indexation state with exclusion reasons, growth opportunities (near-top queries, low-CTR pages, impressions without clicks, cannibalisation), a full SEO audit with a source and a date behind every finding, single-page technical analysis (PageSpeed, Core Web Vitals, on-page signals), sitemap status in both engines, Google URL inspection, Yandex recrawl requests, competitor positions, keyword management in Topvisor, landing-page conversions from Metrica, and a deterministic Russian-text check. Only three tools write anything; paid position checks are deliberately kept out of chat. Every answer carries provenance — a revoked source shows up as a source failure, never as zero traffic. Separate subscription (590 / 1 490 / 9 900 ₽/mo, 7-day trial): https://app.marketscore.ru/seo

Pricing: a Direct Manager account is required; sign-up includes a 7-day free Pro trial. Assistant — 990 ₽/mo (111 tools, chat-only, 3 Direct accounts); Pro — 1 990 ₽/mo (111 tools + web dashboard, 5 accounts); Agency — 9 900 ₽/mo (116 tools incl. portfolio overview, 20 accounts). SEO is a separate plan axis on a separate connector URL. Without an active plan the server exposes zero tools.

FAQ:

Is it free? The first 7 days are (Pro trial on sign-up); after that a subscription is required.

Where does my Yandex token go? It stays on the Direct Manager service — the assistant and the MCP client never see it, and it is not stored in any local config.

Can the assistant break my ad account? Write tools are annotated separately and the MCP client asks for confirmation before running them.

Keywords: Yandex Direct, Яндекс Директ, MCP, Model Context Protocol, MCP server, PPC, ads management, campaign analytics, ROAS, negative keywords, Wordstat, Claude, ChatGPT, Cursor, AI marketing, SEO MCP, Yandex Webmaster, Яндекс Вебмастер, Google Search Console, Yandex Metrica, Topvisor, SEO audit, ИИ-менеджер для Яндекс Директа, ИИ для рекламы.

License

MIT — see LICENSE. The connector is open; the Direct Manager service is a paid SaaS. / The connector is open; the Direct Manager service is a paid SaaS.