Ask Ads MCP
Remote MCP server · Read-only

Yandex Direct in your AI assistant

A read-only MCP server for ChatGPT and Claude — campaigns, performance stats, account balance and Metrica conversions, straight from your Yandex Direct account.

MCP endpoint
https://mcp.askads.cloud/mcp
Paste this URL into your assistant's connector settings — nothing to install, no signup on this page.
How to connect

Three clients, three steps each

ChatGPT
Apps & Connectors
1 Open Settings → Apps & Connectors and choose Add.
2 Paste the endpoint URL from above.
3 Sign in with Yandex when prompted.
Claude
Custom connectors
1 Open Settings → Connectors.
2 Choose Add custom connector and paste the endpoint URL.
3 Sign in with Yandex when prompted.
Claude Code
Plugin marketplace
1 Run /plugin marketplace add askads/claude-plugins.
2 Install the plugin: /plugin install yandex-direct@askads.
3 Sign in with Yandex when prompted.

Authorization is OAuth with your Yandex account — Ask Ads never sees your password, and you can revoke access at any time.

What it can do

Ask about your account, get real numbers

Read-only
Campaigns
List campaigns with status, budget and strategy at a glance.
Performance reports
Clicks, spend, CPC and conversions by day or by campaign.
Balance & overdraft
Current account balance, spend and overdraft status.
Ad groups, ads & keywords
Browse account structure down to individual keywords.
Metrica goals & conversions
Goals and conversion data from linked Metrica counters.
Read-only by design
The server never changes anything in your account — no edits, no launches, no spend.
Try asking

In plain words, like a colleague

Click a question to copy it, then paste it to your assistant.
Security

Boring, in the good way

OAuth 2.1 with PKCE — the standard flow, revocable from your Yandex account at any time.
Your Yandex token never reaches the assistant — it's stored encrypted on the server.
Strict read-only allowlist — only safe read tools are exposed, nothing can write.
FAQ

Frequently asked questions

Is it safe?
Yes: access is strictly read-only via official Yandex OAuth. The server can't change anything in your account, never sees your password, and your token is stored encrypted and never reaches the assistant. Revoke access at any time in your Yandex account settings.
How much does it cost?
Nothing — the connector is free. If paid plans ever appear, they won't apply retroactively.
What does the assistant see?
Only the data it requests for an answer: campaigns, statistics, balance, Metrica goals. From there it's processed by your assistant's platform (OpenAI or Anthropic) under its own privacy policy.
Does it work with agency accounts?
Yes, both regular and agency Direct accounts connect. Metrica conversions are available for regular accounts only: an agency token has no access to the client's counters.
Which assistants are supported?
Any MCP client with Streamable HTTP and OAuth: ChatGPT (Apps & Connectors), Claude (web, Desktop and Claude Code), Cursor and others.
How is this different from Ask Ads?
Ask Ads is the full product: a chat analyst and a watchdog with Telegram alerts. The MCP server is a free bridge from your favourite assistant to the same Direct data.