Labsco
MCP SERVER

Yandex Direct Manager

by marketscore

Manage Yandex Direct advertising from a chat — find campaigns burning money with ROAS under 1, adjust budgets, bids and negative keywords, and get a weekly brief in one call.

Marketing Automation & Advertising
Summary
Answers carry their source and their gaps.

On the SEO side every figure comes back with the source it was measured from and the date it was taken, a revoked Webmaster connection shows up as a source failure rather than as zero traffic, and an audit run with a silent source returns a list of what was not checked instead of quietly scoring it as fine. The advertising side handles the same problem from the other end — it detects the Direct API's silent failures, where a 200 comes back but the edit did not apply. Paid position checks are deliberately kept out of chat because they draw down a Topvisor balance and the price should be on screen first.

What it is

A thin connector to the hosted Direct Manager MCP server. The server, the Direct API access and all the logic run on the service side; this package only attaches your assistant to it. Two separate servers exist on the same account: an advertising one covering Yandex Direct, VK, Avito and Wordstat, and a separate SEO one.

What you get
  • Campaign analytics over Direct API v5 and the Reports API, broken down by period, device, gender, age, placement and geography, plus search queries and impression share
  • Wasted-spend detection: campaigns with ROAS below 1, spend with no conversions, placements and keywords costing money without returning any
  • Management writes: pause and resume, daily and weekly budgets, strategies including conversion strategies with a target CPA or ROAS, negative keywords, keywords, bids and adjustments
  • Campaigns built from scratch — campaign, then group, then ad with sitelinks and UTM tags
  • AI-derived output: a 30-day spend and conversion forecast, diagnosis of a drop across traffic, conversion rate and CPC, a period-over-period explanation with its drivers, a ranked list of findings in roubles, and a ready weekly brief from a single call
  • A cross-account portfolio view on the agency plan — spend, profit, wasted spend and remaining budget per client in one answer — `accounts_overview`
  • A separate SEO server with 21 tools over Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor and Wordstat, of which only three write anything — `seo_overview`, `seo_search_queries`, `seo_positions`, `seo_indexation`, `seo_audit`, `seo_page_analysis`, `seo_opportunities`, `seo_url_inspection`, `seo_keyword_demand`, `seo_competitors`, `seo_sources`, plus the writes `seo_add_keywords`, `seo_add_competitors` and `seo_request_recrawl`
Requirements

A Direct Manager account with an active plan — without one the server exposes zero tools. Registration includes a 7-day free trial of the Pro plan. Claude and ChatGPT connect directly by URL at `https://app.marketscore.ru/api/mcp` and sign in over OAuth 2.1; your Yandex token stays on the service and never reaches the assistant or a local config. Local clients such as Cursor, VS Code, Cline and Zed bridge through this package with `npx -y marketscore-direct-mcp`; it is `marketscore-direct-mcp` (1.0.2) on npm. The SEO server is a different URL and a different subscription: `https://app.marketscore.ru/api/mcp/seo`. Write actions are annotated so the MCP client asks for confirmation before running them.

Setup effort

One command — npx -y marketscore-direct-mcp