roasr-mcp
The MCP server for RoASr: ad audits, KPIs and competitor intelligence across Meta, Google Ads and Yandex Direct in one place
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- Can pause and resume Yandex Direct ad campaigns
- Reads spend, KPIs and competitor data through the third-party RoASr service
- The pg_live key grants access to the whole workspace according to its scopes
Install
Manual install
URL: https://roasr.com/api/mcp
Auth: Bearer pg_live_...Remote connector with no install; the tool catalog is public, calls require a Bearer header with the key.
This is third-party code. Review the repository files before installing.
What it does
The server connects an agent to a RoASr workspace, a third-party ad-analytics service. It exposes 18 tools: audit findings by priority, KPI summaries and daily time series, breakdowns by audience, placement, device and region, per-campaign metrics, competitor creative search and a leaderboard, a Vision breakdown of a creative, and a dedicated Yandex Direct block covering search queries, ads, Metrika goals and the daily API quota. The one write tool pauses or resumes a Yandex Direct campaign, but only within the permissions the account owner granted for that specific key.
Who it is for. For performance marketers and agencies running campaigns in Meta, Google Ads and Yandex Direct at once.
Good fit when
- You need to compare campaign KPIs across three ad platforms in one conversation with an agent
- You need to find Direct search queries that spend budget without conversions
- You need to see competitor creatives and get a hook and risk breakdown from Vision
Not a fit when
- You need a tool that talks to the Yandex Direct API directly without a third-party service
- You need to manage bids and ads: the server only supports pausing and resuming a campaign
- You have no RoASr account and API key and do not want to add a third-party service
Example request
Show me Direct search queries from the past month that spent budget with zero conversionsLimitations
The tool works only on top of a RoASr workspace, a separate paid analytics service, not directly against the Yandex Direct API. A pg_live API key with the right scopes is required. Vision analysis and competitor ad-library scans run and consume credits inside the RoASr app; the server just returns the stored result. The package is not yet published to npm, so install is from GitHub.
How to disable. Remove the server from your MCP client config and revoke the pg_live API key in RoASr settings.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| ROASR_API_KEY required, secret | RoASr access key in pg_live format with access scopes |
| ROASR_BASE_URL | API base URL, defaults to https://roasr.com |
Security check
- Can pause and resume Yandex Direct ad campaigns
- Reads spend, KPIs and competitor data through the third-party RoASr service
- The pg_live key grants access to the whole workspace according to its scopes
README in short
The bilingual README describes three connection modes: a remote HTTP connector with no install, npx for Claude Desktop, Cursor and Claude Code, or building from source. It gives a full table of 18 tools with endpoints and scopes, explains date-window and breakdown parameters, and lists the ROASR_API_KEY and ROASR_BASE_URL variables. The repo ships agent SKILL.md files with an analysis method, including a dedicated Yandex Direct skill covering goal selection before reading conversions, archived campaigns, the State versus Status distinction, micro-units and the daily API quota. MIT license.
FAQ
Does the server work without a RoASr account?
No, every tool calls the roasr.com API and requires a pg_live key issued in the service's dashboard.
Can the agent change bids in Direct?
No, the only write tool pauses or resumes a Direct campaign, and only within that key's granted permissions.
Related
Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution
A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata
An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents