yandex-api-mcp: Webmaster, Direct, Metrika and Wordstat in one MCP
yandex-api-mcp
One MCP server in Docker reads data from Yandex Webmaster, Direct, Metrika, Wordstat, Audiences and Search API, with writes blocked by default
- 0 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The Yandex token grants reading site, Direct account and counter statistics, and the service runs with Docker access
- The public build blocks writing, but the pro build can change data with confirmation
Install
- Works in
- Services
Manual install
git clone https://github.com/5iNeX/yandex-api-mcp.git && cd yandex-api-mcp && sudo ./install.shInstalls the server into `/opt/yandex-api-mcp`, then `sudo yp-api oauth` and `sudo yp-api service start`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The Yandex token grants reading site, Direct account and counter statistics, and the service runs with Docker access
- The public build blocks writing, but the pro build can change data with confirmation
This is third-party code. Review the repository files before installing.
What it does
The gateway combines six Yandex services behind a single MCP address. Webmaster returns sites, diagnostics, queries, indexing, sitemaps and the recrawl limit. Direct shows campaigns, groups, ads, keywords, bids and reports, including agency clients. Metrika gives counters, goals, segments and reports, Wordstat gives frequency, dynamics and regions, and Search API gives search results through Yandex Cloud. Several projects share one Yandex OAuth token, while links between a site, a counter and a Direct login are stored as local profiles. Installation runs with `install.sh` and management with the `yp-api` command. The public Docker image blocks every write call, and a separate pro build with a preview is not published automatically. The server connects to Claude, Codex and Cursor through the `docker exec` stdio command.
Who it is for. SEO specialists and agencies that run several sites and Direct accounts and want Yandex data inside an agent dialog.
Good fit when
- You need a Webmaster summary: indexing, diagnostics and queries for several sites
- A manager asks for a Direct report on campaigns and keywords of an agency client
- Wordstat frequency and dynamics must be compared with Metrika counters
- Several projects need one OAuth token and site plus counter profiles
Not a fit when
- You need to change campaigns, bids and goals: the public build blocks writes
- There is no Debian or Ubuntu server with Docker Engine: the installer targets them
- You only need Yandex Direct or only Metrika: a narrow single-service server is simpler
Example request
Show which queries brought impressions to example.com in Webmaster over the month and compare with Wordstat dynamicsMCP
- Transport
- stdio, sse
- Authentication
- OAuth
Environment variables
YANDEX_CLIENT_IDrequired- Client ID of the Yandex OAuth app, asked by the installer on launch
YANDEX_CLIENT_SECRETrequired, secret- App Client Secret, entered hidden and stored in secrets/
Limitations
It needs Debian 12 or 13 or Ubuntu 22.04 or 24.04, Docker Engine with Compose v2, `sudo`, your own Yandex OAuth app and Direct API access. Wordstat and Search API require a separate Yandex Cloud key. The author did not test write operations in production accounts, and OAuth must be repeated after adding new rights. Docker access gives broad rights on the server. Apache-2.0 license, the TypeScript core under MIT, the last commit in September 2026, no stars.
How to disable. Stop the server with `sudo yp-api service stop`, remove it from MCP client settings and revoke the app token at oauth.yandex.ru. The `state/` and `secrets/` folders in `/opt/yandex-api-mcp` are deleted by hand.
FAQ
Can Direct campaigns be changed through this server?
No, the public build blocks every write call. A separate pro build with a preview and confirmation is not part of the public image.
Which OAuth rights are needed?
`webmaster:hostinfo` and `webmaster:verify` for Webmaster, `direct:api` for Direct, `metrika:read` for Metrika and `audience:read` for Audiences. After adding a right the OAuth is repeated.
How do Wordstat and Search API authenticate?
With a Yandex Cloud service account key with the `search-api.webSearch.user` role. The Direct token does not work for them. The key goes into `secrets/yandex.env` and the service is restarted.
How do I connect the server to ChatGPT?
Through a separate OpenAI Secure MCP Tunnel with `tunnel-client` whose stdio command is `docker exec`. A public MCP port is not needed.
How do I check the installation?
The `sudo yp-api doctor`, `sudo yp-api discover` and `sudo yp-api verify` commands check the link, show available sites and counters and run read requests through MCP.
Discussion
No questions or reviews yet.
Related
All Yandex Webmaster toolsA ZAI.ONE MCP server bringing Direct, Metrika, search, Wordstat and Webmaster into one agent, with a setup wizard and opt-in write operations
An MCP server with 125 tools for Yandex Webmaster, Direct and Metrika, multiple projects and tokens in one process
A 155-tool MCP server for Yandex Direct, Metrika, Wordstat and Webmaster, with self-setup OAuth and read-only and confirm modes
Five MCP servers for Yandex APIs: Wordstat, Search, Webmaster, Metrika and Direct, plus a Claude Code plugin with skills
An MCP server for Yandex Direct, Metrika, Wordstat and Webmaster: campaigns, ads, bids, reports and keyword research from chat
Monorepo of Yandex MCP servers: Direct, Metrica, Webmaster, Wordstat, Tracker, 360, Maps, SpeechKit, YandexGPT and AppMetrica
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| yandex-api-mcp: Webmaster, Direct, Metrika and Wordstat in one MCP (this card) | no | OAuth | 0 | |
| Yandex Direct MCP | no | not required | 14 | this one spans six Yandex services with shared projects and has writes blocked |
| Yandex Metrika MCP | no | API key | 24 | Metrika is one of six here, next to Webmaster, Direct and Wordstat |
README in short
The README covers six services, preparing OAuth and Yandex Cloud keys, installing with a script, project profiles, connecting local clients and ChatGPT, management commands and a table of common problems.