Yandex Webmaster MCP — Claude Code MCP server: install and guide
Connects Yandex Webmaster API v4 to your AI coding agent. It checks indexing events, query impressions, clicks, diagnostics, and Site Quality Index trends.
claude mcp add yandex-webmaster-mcp -e YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @stufently/yandex-webmaster-mcpWhat Yandex Webmaster MCP does
This integration provides 33 tools targeting Yandex Webmaster API v4. Agents can inspect domain diagnostics and query metrics directly inside the chat interface. It keeps search analytics context inside your workflow.
The server scans the event stream to isolate dropped URLs in get-excluded-pages. It filters exclusions against recent returns to search so active pages stay out of the drop list. Note that API v4 does not cover IndexNow or robots.txt inspections.
The package is published under @stufently/yandex-webmaster-mcp. The unscoped name belongs to someone else. You must supply an OAuth token in YANDEX_WEBMASTER_TOKEN before making requests.
What it helps with
- inspect URLs removed from Yandex search results
- retrieve top search queries by clicks or impressions
- review Site Quality Index historical changes
- check site diagnostics and crawl issues
Example prompts for the agent
- Fetch my verified domains and their
host_idvalues from Yandex Webmaster - Show top search queries ordered by clicks for host
https:example.com:443 - Run
get-excluded-pageson hosthttps:example.com:443to find dropped URLs
How to install Yandex Webmaster MCP
Platform CLI
claude mcp add yandex-webmaster-mcp -e YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @stufently/yandex-webmaster-mcpReplace <…> with your own values
Platform CLI
codex mcp add yandex-webmaster-mcp --env YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @stufently/yandex-webmaster-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"yandex-webmaster-mcp": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-webmaster-mcp"
],
"env": {
"YANDEX_WEBMASTER_TOKEN": "<YANDEX_WEBMASTER_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"yandex-webmaster-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stufently/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> yandex-webmaster-mcp npx -y @stufently/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 to install Yandex Webmaster MCP in Claude Code?
Run claude mcp add yandex-webmaster-mcp -e YANDEX_WEBMASTER_TOKEN=<YANDEX_WEBMASTER_TOKEN> -- npx -y @stufently/yandex-webmaster-mcp.
What does Yandex Webmaster MCP do?
It exposes tools to monitor indexing status, search analytics, and site diagnostics through Yandex Webmaster API v4.
Why is the scoped package name required?
The author published the package as @stufently/yandex-webmaster-mcp because the unscoped package name belongs to an unrelated publisher.
