webmaster-mcp
A Python MCP server for Yandex Webmaster with writes disabled by default and a site whitelist for sitemaps and recrawl
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Once its flags are enabled it can add sitemaps and submit recrawl URLs
- The Webmaster OAuth token is stored in .env next to the server code
Install
Manual install
python -m venv .venv && source .venv/bin/activate && pip install -e . && cp .env.example .envInstall from source via venv and pip.
This is third-party code. Review the repository files before installing.
What it does
The server provides ten read tools: auth status, site list, diagnostics, sitemaps, recrawl quota, popular queries and their history, plus two write operations: add a sitemap and submit a recrawl. Both writes are disabled by default via separate environment variables, require confirm=true on the call, and are only allowed for sites in an explicit YANDEX_WEBMASTER_WRITE_HOST_WHITELIST. Built with an OpenCode example, including a ready mcp.json config.
Who it is for. For OpenCode users who want Webmaster writes disabled by default and to explicitly list which sites are allowed to write.
Good fit when
- You want a server where writes are off until explicitly enabled via environment variables
- You work in OpenCode and want a ready config example
- You need a whitelist of sites where writes are allowed
Not a fit when
- You need broad API coverage: important-URL diagnostics, external links or indexing events are not implemented here
- You need to add new sites or start verification, these tools are not included
Example request
Show example.com's recrawl quota and top queries for the last monthLimitations
Only ten tools, no important URLs, external links or indexing events. Both write operations are off by default and need separate enabling via YANDEX_WEBMASTER_ENABLE_ADD_SITEMAP and YANDEX_WEBMASTER_ENABLE_RECRAWL. No packaged distribution, install via pip install -e .
How to disable. Remove the webmaster-mcp block from your OpenCode or other MCP client config.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| YANDEX_WEBMASTER_OAUTH_TOKEN required, secret | Yandex Webmaster OAuth token |
| YANDEX_WEBMASTER_ENABLE_ADD_SITEMAP | Enables sitemap writes, off by default |
| YANDEX_WEBMASTER_ENABLE_RECRAWL | Enables recrawl submission, off by default |
| YANDEX_WEBMASTER_WRITE_HOST_WHITELIST | List of sites where writes are allowed |
| YANDEX_WEBMASTER_DEFAULT_HOST | Default site |
Security check
- Once its flags are enabled it can add sitemaps and submit recrawl URLs
- The Webmaster OAuth token is stored in .env next to the server code
README in short
The English README lists the ten tools, venv and pip install -e . based installation, required and optional environment variables, write safety (off by default, site whitelist, required confirm), how to run the server, and a ready OpenCode config example.
FAQ
Why doesn't recrawl fire right away?
Writes are off by default: you need to enable YANDEX_WEBMASTER_ENABLE_RECRAWL, add the site to the whitelist and pass confirm=true when calling webmaster_request_recrawl.
How is the server wired to OpenCode?
The README gives a ready snippet for ~/.config/opencode/opencode.json with a bash command that loads .env itself and runs python -m yandex_webmaster_mcp.server.
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