Xmlriver-mcp Server

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

Local serverstdio

What is the Xmlriver-mcp Server?

Xmlriver Mcp is an MCP project maintained in the artgas1/xmlriver-mcp repository. The maintainer describes its purpose as “MCP server for XMLRiver — Google/Yandex SERP parsing and Yandex Wordstat keyword frequency data via XML API”. Read the project documentation for the complete scope.

Installation

The documented pypi package is xmlriver-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares XMLRIVER_USER, XMLRIVER_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
google_searchParse Google SERP for a query — country, language, device, page, date filter, extra blocks (ads, FAQ, knowledge graph, AI Overview)
yandex_searchParse Yandex SERP — region, language, device, page, date filter, extra blocks
yandex_search_api_v2Yandex Search API v2 (official) via XMLRiver — cleaner structured output
wordstat_queryYandex Wordstat keyword frequency + similar queries, or demand dynamics by month/week/day
search_suggestionsSearch-box autocomplete from Google or Yandex, 1–50 phrases per call. Surfaces long-tail phrasings that carry no Wordstat frequency at all
google_maps_searchGoogle Maps places around a coordinate (zoom + coords required). ⚠️ See caveat below
check_url_indexedCheck if URL is indexed in Google or Yandex
get_balanceCurrent XMLRiver balance in rubles
get_tariffCurrent XMLRiver tariff name (Basic / Pro / Mega / Giga)
get_tariff_expireTariff expiration date (for prepay tariffs)
get_costCost per 1000 requests for a given engine (google / yandex / yaxml / wordstat)

How to install the Xmlriver-mcp Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
XMLRIVER_USERDeclared in the maintainer’s client configuration.Check documentation
XMLRIVER_KEYDeclared in the maintainer’s client configuration.Check documentation