Skip to content
MCP server

Yandex Webmaster MCP

Ask AI about your site's Yandex search indexing, queries and diagnostics

Runs locally
Install
Platforms
CLI
Runs
Locally
Version
1.2.4
Listing updated
4 days ago

Similar MCP servers

About Yandex Webmaster MCP

Yandex Webmaster MCP is an MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

The server is built around Yandex's own view of a site. It answers questions about which pages are in or out of the Yandex index, how impressions, clicks and average positions move by date and device type, which problems the Webmaster diagnostics flag, how sitemaps are read and which external links point at the site. It does not cover traffic analytics, search demand or advertising data, so it complements rather than replaces those tools.

Connection happens inside the chat. You ask the assistant to connect Yandex Webmaster, Yandex opens a sign-in page, a one-time code is valid for 10 minutes, and the server checks access to your sites straight afterwards. A ready-made OAuth token can be supplied instead for CI or unattended setups.

Most calls only read data. A few can change state in the Webmaster account: adding a site, starting ownership verification by DNS record, HTML file or meta tag, adding a sitemap, and queuing a page for recrawl, which uses the site's daily recrawl quota. Statistics and diagnostics need verified ownership; otherwise Webmaster returns HOST_NOT_VERIFIED.

Install

Run in a terminal

claude mcp add mcp-yandex-webmaster --env YANDEX_OAUTH_TOKEN='<YANDEX_OAUTH_TOKEN>' -- npx -y mcp-yandex-webmaster

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-yandex-webmaster": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-yandex-webmaster": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-yandex-webmaster"
      ],
      "env": {
        "YANDEX_OAUTH_TOKEN": "<YANDEX_OAUTH_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • YANDEX_OAUTH_TOKENYandex OAuth token with Webmaster access, sent as `Authorization: OAuth <token>`. Treat it as a secret.Required
  • YANDEX_USER_IDToken owner's user id; auto-detected via GET /v4/user when unset.
  • YANDEX_WEBMASTER_HOST_IDDefault host_id (e.g. https:example.com:443) used when a tool call omits one.
  • YANDEX_WEBMASTER_API_BASEAPI root override.
  • YANDEX_WEBMASTER_TIMEOUT_MSPer-request timeout in milliseconds.
  • YANDEX_WEBMASTER_MAX_RETRIESRetries on transient errors (429 — except the daily QUOTA_EXCEEDED; 5xx/network for reads).

What it does

Twenty Webmaster tools
The README describes 20 tools covering sites, diagnostics, search queries, indexing, sitemaps and external links.
Search query statistics
Shows impressions, clicks and average positions by date and for desktop versus mobile.
Indexing and diagnostics
Reports pages in and excluded from search, status changes and problems grouped by severity.
Sitemap and recrawl actions
Adds sitemaps and queues pages for recrawl, with the remaining daily quota shown in the reply.
Sign-in from the conversation
Connects to Yandex through a browser login with a 10-minute one-time code, so no token has to be prepared first.
Configurable limits
Environment variables set a default host, request timeout and retry count for rate-limited or failing calls.

Good for

  • Review critical Yandex diagnostics issues for a site
  • Check which important pages changed indexing status
  • Compare mobile and desktop search visibility over a month
  • Verify a sitemap and see when the crawler last read it
  • Queue a changed page for recrawl while watching the daily quota

Yandex Webmaster MCP FAQ

Do I need to create a token first?

No. The assistant starts a Yandex sign-in during the chat. For automation you can instead set YANDEX_OAUTH_TOKEN.

Does it include Metrica or Wordstat data?

No. It covers organic search data from Yandex Webmaster only, with no traffic, search demand or ad data.

Can it change my account?

Some tools can add a site or sitemap, start ownership verification or queue a recrawl. Everything else reads data.

What does HOST_NOT_VERIFIED mean?

Webmaster returns it when site ownership is not confirmed, which blocks statistics and diagnostics.

How do I add Yandex Webmaster MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-yandex-webmaster --env YANDEX_OAUTH_TOKEN='<YANDEX_OAUTH_TOKEN>' -- npx -y mcp-yandex-webmaster

What are the best alternatives to Yandex Webmaster MCP?

The closest alternatives to Yandex Webmaster MCP are Yandex Direct MCP, LV24 SEO, Yandex Metrica MCP, Yandex Metrika and mowteng.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers