yandex-webmaster-mcp — Claude Code MCP server: what it does, install
Connects Yandex.Webmaster API to your coding agent. Inspect search traffic and submit pages for indexing directly from chat.
claude mcp add yandex-webmaster-mcp -e YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @theyahia/yandex-webmaster-mcpWhat yandex-webmaster-mcp does
This server exposes 13 tools for Yandex.Webmaster. It lets you review search query performance and track page indexing trends. The agent can return responses formatted as Markdown or raw JSON.
Setup requires a Yandex OAuth token with the webmaster:api permission. You do not need to configure a numerical user ID manually because the server detects it automatically. It communicates over standard I/O or runs as a Streamable HTTP service.
HTTP mode restricts traffic to localhost by default to protect against DNS rebinding attacks. Multi-tenancy is not supported. The authentication token is shared globally through a single environment variable.
What it helps with
- track search queries and click metrics in Yandex
- request recrawls for updated web pages
- inspect site diagnostics and crawling errors
- monitor sitemaps and indexing history
Example prompts for the agent
- Check the indexing status and recent exclusion trends for my site.
- Show the top search queries and impressions from the past week.
- Submit a URL for recrawling and report the remaining daily quota.
How to install yandex-webmaster-mcp
Platform CLI
claude mcp add yandex-webmaster-mcp -e YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @theyahia/yandex-webmaster-mcpReplace <…> with your own values
Platform CLI
codex mcp add theyahia-yandex-webmaster-mcp --env YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @theyahia/yandex-webmaster-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"theyahia-yandex-webmaster-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-webmaster-mcp"
],
"env": {
"YANDEX_WEBMASTER_TOKEN": "<YANDEX_WEBMASTER_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"theyahia-yandex-webmaster-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-webmaster-mcp"
],
"env": {
"YANDEX_WEBMASTER_TOKEN": "<YANDEX_WEBMASTER_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> theyahia-yandex-webmaster-mcp npx -y @theyahia/yandex-webmaster-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about yandex-webmaster-mcp
How do I install yandex-webmaster-mcp in Claude Code?
Run claude mcp add yandex-webmaster-mcp -e YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @theyahia/yandex-webmaster-mcp with your OAuth token.
What does yandex-webmaster-mcp do?
It provides MCP tools to query Yandex.Webmaster metrics, review crawling health, and manage page indexing.
Is manual user ID configuration required?
No, setting YANDEX_WEBMASTER_USER_ID is optional. The server resolves your account ID automatically on startup.
