How do I install Xmlriver?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Xmlriver need an API key?

No required environment variable is listed on this record.

What transport does Xmlriver use?

Xmlriver runs locally over stdio.

Xmlriver MCP server

Q: When was Xmlriver last checked?

Last checked 2026-11-09. Google/Yandex SERP parsing and Yandex Wordstat keyword frequency via XMLRiver XML API

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx xmlriver-mcp==0.2.3

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.artgas1-xmlriver-mcp -- uvx xmlriver-mcp==0.2.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.artgas1-xmlriver-mcp": {4      "command": "uvx",5      "args": [6        "xmlriver-mcp==0.2.3"7      ]8    }9  }10}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.3
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

`xmlriver-mcp`

MCP server for XMLRiver — Google/Yandex SERP parsing and Yandex Wordstat keyword frequency data via XML API.

mcp-name: io.github.artgas1/xmlriver-mcp

What it does

Gives Claude / Cursor / Windsurf direct access to:

Google SERP parsing (organic, ads, FAQ, knowledge graph, AI Overview) for any country / region / device
Yandex SERP parsing (Russian-speaking markets — primary use case)
Yandex Wordstat keyword frequency, history, similar queries (Yandex's keyword volume tool)
Indexing check — is this URL in Google/Yandex index?
Account ops — balance, tariff, cost per 1k requests

First MCP for XMLRiver — fills a gap for Russian SEO research and Yandex-aware analysis. Pay-as-you-go (~25 ₽ / 1000 requests on Basic tariff).

Demo

Claude queries wordstat_query and parses real frequency data from Yandex. Same flow works for google_search, yandex_search, indexing checks, and account ops.

Quickstart

uvx xmlriver-mcp

Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "xmlriver": {
      "command": "uvx",
      "args": ["xmlriver-mcp"],
      "env": {
        "XMLRIVER_USER": "<your_numeric_user_id>",
        "XMLRIVER_KEY": "<your_40_char_hex_key>"
      }
    }
  }
}

Claude Code

Add to project .mcp.json:

{
  "mcpServers": {
    "xmlriver": {
      "command": "uvx",
      "args": ["xmlriver-mcp"],
      "env": {
        "XMLRIVER_USER": "<your_numeric_user_id>",
        "XMLRIVER_KEY": "<your_40_char_hex_key>"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "xmlriver": {
      "command": "uvx",
      "args": ["xmlriver-mcp"],
      "env": {
        "XMLRIVER_USER": "<your_numeric_user_id>",
        "XMLRIVER_KEY": "<your_40_char_hex_key>"
      }
    }
  }
}

Tools

Tool	What it does
`google_search`	Parse Google SERP for a query — country, language, device, page, date filter, extra blocks (ads, FAQ, knowledge graph, AI Overview)
`yandex_search`	Parse Yandex SERP — region, language, device, page, date filter, extra blocks
`yandex_search_api_v2`	Yandex Search API v2 (official) via XMLRiver — cleaner structured output
`wordstat_query`	Yandex Wordstat keyword frequency + similar queries, or demand dynamics by month/week/day
`search_suggestions`	Search-box autocomplete from Google or Yandex, 1–50 phrases per call. Surfaces long-tail phrasings that carry no Wordstat frequency at all
`google_maps_search`	Google Maps places around a coordinate (zoom + coords required). ⚠️ See caveat below
`check_url_indexed`	Check if URL is indexed in Google or Yandex
`get_balance`	Current XMLRiver balance in rubles
`get_tariff`	Current XMLRiver tariff name (Basic / Pro / Mega / Giga)
`get_tariff_expire`	Tariff expiration date (for prepay tariffs)
`get_cost`	Cost per 1000 requests for a given engine (google / yandex / yaxml / wordstat)

All tools are read-only (annotated with readOnlyHint: true). No destructive operations.

⚠️ google_maps_search is unverified against a live response. Every setab=maps request answered code 500 while it was written (2026-08-04), including a deliberately invalid one that should have returned code 108 — plain Google and Yandex searches worked in the same minutes, so the mode appears unavailable service-side. The request shape and response parsing follow the documentation and are covered by unit tests; both still need a live check.

Deliberately not wrapped: raw=page (returns the full HTML page — bypasses parsing and returns megabytes into the model's context) and the deferred-response mode (delayed / req_id) — an MCP call is synchronous, so a request id the caller must poll for has nowhere useful to go.

Authentication

Register at https://xmlriver.com
Top up balance (minimum ~100 ₽ to start)
Get your user (numeric ID) and key (40-char hex) from the dashboard
Set XMLRIVER_USER and XMLRIVER_KEY env vars in your MCP client config

Security note: XMLRiver API is HTTP-only (not HTTPS). The key is rotatable from the dashboard if compromised.

Pricing context

Tariff	Setup	Google / Yandex / Wordstat	Yandex Search API v2
Basic	Pay-as-you-go	25 ₽ / 1k	25 ₽ / 1k
Pro	5000 ₽/mo	20 ₽ / 1k	24 ₽ / 1k
Mega	15000 ₽/mo	15 ₽ / 1k	23 ₽ / 1k
Giga	50000 ₽/mo	12 ₽ / 1k	22 ₽ / 1k

Use get_balance and get_cost to monitor spend before bulk operations.

Common use cases

SEO position tracking — yandex_search(query="...", region=213) for own/competitor ranking
Keyword research — wordstat_query(query="купить iphone", history_period="monthly") for demand validation + seasonality
Featured snippet hunting — google_search(additional_blocks="faqsnippet,knowledge_graph,zeroposition") to see what owns the answer box
Long-tail discovery — search_suggestions(phrases=[...]) with a prefix sweep (seed + each letter of the alphabet) pulls phrasings Wordstat never reports
Indexation monitoring — check_url_indexed(url="https://your-site.com/new-page") after publishing
Cross-region comparison — same query, different region/country for Yandex/Google to see geographic variance

Local development

git clone https://github.com/artgas1/xmlriver-mcp
cd xmlriver-mcp
uv sync --all-extras

# Run unit tests (no API key needed)
uv run pytest tests/unit -v

# Run integration tests (requires XMLRIVER_USER / XMLRIVER_KEY)
XMLRIVER_USER=... XMLRIVER_KEY=... uv run pytest tests/integration -v -m integration

# MCP Inspector — interactive
XMLRIVER_USER=... XMLRIVER_KEY=... npx @modelcontextprotocol/inspector uv run python -m xmlriver_mcp.server

# MCP Inspector — CLI smoke test (list tools)
npx @modelcontextprotocol/inspector --cli "uv run python -m xmlriver_mcp.server" --method tools/list

Architecture

Stack: Python 3.10+ / FastMCP / httpx / tenacity / pydantic
Transport: stdio (default)
No external SDK dependency — direct REST via httpx + custom XML parser
Retry strategy: 3 attempts with exponential backoff on network errors (not on HTTP 4xx)
Logging: stderr only (stdio protocol requires stdout for JSON-RPC)

License

MIT

Contributing

PRs welcome. Open an issue first for substantial changes.

Acknowledgements

XMLRiver — for the underlying API
Anthropic MCP — for the protocol

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Xmlriver?

Does Xmlriver need an API key?

What transport does Xmlriver use?

When was Xmlriver last checked?

Documentation

xmlriver-mcp

What it does

Demo

Quickstart

Configuration

Claude Desktop

Claude Code

Cursor

Tools

Authentication

Pricing context

Common use cases

Local development

Architecture

License

Contributing

Acknowledgements

`xmlriver-mcp`