Installation

Install robokassa-mcp in your MCP client or as a Python library

As an MCP server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "robokassa": {
      "command": "uvx",
      "args": ["robokassa-mcp"],
      "env": {
        "ROBOKASSA_LOGIN": "your-shop-login",
        "ROBOKASSA_PASSWORD1": "password1",
        "ROBOKASSA_PASSWORD2": "password2",
        "ROBOKASSA_PASSWORD3": "password3"
      }
    }
  }
}

claude mcp add robokassa \
  -e ROBOKASSA_LOGIN=my-shop \
  -e ROBOKASSA_PASSWORD1=... \
  -e ROBOKASSA_PASSWORD2=... \
  -e ROBOKASSA_PASSWORD3=... \
  -- uvx robokassa-mcp

{
  "mcpServers": {
    "robokassa": {
      "command": "uvx",
      "args": ["robokassa-mcp"],
      "env": {
        "ROBOKASSA_LOGIN": "your-shop-login",
        "ROBOKASSA_PASSWORD1": "password1",
        "ROBOKASSA_PASSWORD2": "password2",
        "ROBOKASSA_PASSWORD3": "password3"
      }
    }
  }
}

{
  "github.copilot.chat.mcp.servers": {
    "robokassa": {
      "command": "uvx",
      "args": ["robokassa-mcp"],
      "env": {
        "ROBOKASSA_LOGIN": "your-shop-login",
        "ROBOKASSA_PASSWORD1": "password1",
        "ROBOKASSA_PASSWORD2": "password2",
        "ROBOKASSA_PASSWORD3": "password3"
      }
    }
  }
}

{
  "mcpServers": {
    "robokassa": {
      "command": "uvx",
      "args": ["robokassa-mcp"],
      "env": {
        "ROBOKASSA_LOGIN": "your-shop-login",
        "ROBOKASSA_PASSWORD1": "password1",
        "ROBOKASSA_PASSWORD2": "password2",
        "ROBOKASSA_PASSWORD3": "password3"
      }
    }
  }
}

uvx is from the uv package manager — install via brew install uv or curl -LsSf https://astral.sh/uv/install.sh | sh.

As a Python library

pip install robokassa-mcp
# or
uv add robokassa-mcp

from robokassa import RobokassaClient

async with RobokassaClient("my-shop", password2="...", password3="...") as client:
    state = await client.check_payment(inv_id=12345)
    if state.is_paid and state.info.op_key:
        refund = await client.refund_create(state.info.op_key)

HTTP transport (advanced)

By default the server runs as stdio — what every MCP client expects. For remote setups or the MCP Inspector:

uvx robokassa-mcp --transport http --port 8000

Flags: --transport {stdio,http,streamable-http,sse}, --host, --port.

Credentials

Variable	Required for
ROBOKASSA_LOGIN	All tools
ROBOKASSA_PASSWORD1	Checkout, SuccessURL verification, CalcOutSumm, fiscal, SMS
ROBOKASSA_PASSWORD2	check_payment (OpStateExt), ResultURL verification
ROBOKASSA_PASSWORD3	refund_create (requires API Refund access in cabinet)

See Environment for per-tool breakdown.

Next: Quickstart →