Skip to content
MCP server

XMLRiver MCP Toolkit

Google and Yandex results, Wordstat demand and position checks via your XMLRiver account

Runs locallyStatus and history
Install
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.0
Listing updated
today

Similar MCP servers

About XMLRiver MCP Toolkit

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

This is an independent project and not an official XMLRiver product. It needs your own XMLRiver account, with the user ID and API key passed as environment variables. The README is in Russian.

Beyond single lookups, a batch tool takes up to 100 phrases per call and runs up to nine requests in parallel, saving results to disk as they arrive so a repeated job reuses stored phrases and pages. The README names serp, wordstat_top, wordstat_history and get_balance as tools, and it notes there is no built-in scheduler or background queue.

It is aimed at SEO specialists who want to ask for keyword expansions, demand history, rank checks across regions and engines, or an account balance in plain language.

Install

Run in a terminal

claude mcp add xmlriver-mcp-toolkit --env XMLRIVER_USER='<XMLRIVER_USER>' --env XMLRIVER_KEY='<XMLRIVER_KEY>' -- uvx xmlriver-mcp-toolkit

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "xmlriver-mcp-toolkit": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "xmlriver-mcp-toolkit"
      ],
      "env": {
        "XMLRIVER_USER": "<XMLRIVER_USER>",
        "XMLRIVER_KEY": "<XMLRIVER_KEY>"
      }
    }
  }
}

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

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

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

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

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

Configuration

  • XMLRIVER_USERXMLRiver user IDRequired
  • XMLRIVER_KEYXMLRiver API keyRequired

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

get_balance
Check the XMLRiver balance
wordstat_top
Expand a phrase with Wordstat frequencies
wordstat_history
Get demand history for a query over a period
serp
Collect Google or Yandex search results
batch
Process up to 100 phrases in one call and save results

What it does

Wordstat expansions
Expands a phrase with frequency counts, optionally with similar queries.
Demand history
Returns Wordstat data for a chosen period to show seasonality.
Live results
Collects Google or Yandex links and titles for a region and device.
Position checks
Finds every occurrence and position of a domain among organic results.
Batch mode
Handles up to 100 phrases per call, nine at a time, and saves results.
Balance check
Shows the XMLRiver balance and per-request cost.

Good for

  • Expand a seed keyword with Wordstat frequencies
  • Check where a site ranks in Yandex and Google for a phrase list
  • Compare results across regions and search engines
  • Look at seasonal demand for a query
  • Check XMLRiver balance before a large run

Pricing

Pricing unknown

Needs a funded XMLRiver account; the package's own licence is not listed

XMLRiver MCP Toolkit FAQ

What do I need to use it?

An XMLRiver account with balance, plus its user ID and API key.

How is it installed?

Through uvx with the xmlriver-mcp-toolkit package, or a pip install; Python 3.11 or newer is needed for pip.

Does it read a .env file?

Not by itself; the client or launch script must load it and pass the values.

Is it official?

No, the README says it is independent.

Which clients are covered?

Setup examples cover Claude Desktop, Claude Code, Cursor and Codex.

How do I add XMLRiver MCP Toolkit to Claude Code?

Run this command in your terminal: claude mcp add xmlriver-mcp-toolkit --env XMLRIVER_USER='<XMLRIVER_USER>' --env XMLRIVER_KEY='<XMLRIVER_KEY>' -- uvx xmlriver-mcp-toolkit

What are the best alternatives to XMLRiver MCP Toolkit?

The closest alternatives to XMLRiver MCP Toolkit are Scrapling MCP Server, Firecrawl MCP Server, Douyin_TikTok_Download_API, Google Ads + Meta Ads + SEO/GEO MCP and SearXNG Search.

Where this comes from

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

How AIPoweredBot checks servers