EntraX Payment — MCP server

An MCP server that wraps the EntraX Payment API (cash-register v1) so an AI assistant (Claude Desktop, Cursor, …) can create payments, check status, issue refunds and read rates on your behalf. Requests are signed with HMAC-SHA256 exactly as in the public docs.

Tools

| Tool | Description | |---|---| | create_payment | Create a payment (QR/link) — amount, currency (RUB/THB/USDT), orderId, … | | get_payment_status | Payment status by paymentId | | get_exchange_rates | Current RUB/THB/USDT rates | | get_deposits | Payments history (filter by status/date, paginated) | | create_refund | SBP refund for a payment (partial supported) | | get_refund_status | Refund status by refundId |

Build

cd entra-mcp
npm install
npm run build      # → dist/index.js

Configure your AI client

Get your API key id and secret key from the merchant cabinet (Partners & cashes → open a cash → “API keys”).

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "entrax-payment": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/entra-mcp/dist/index.js"],
      "env": {
        "ENTRA_API_KEY_ID": "your-api-key-id",
        "ENTRA_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Cursor — .cursor/mcp.json (same mcpServers shape).

Environment variables

| Var | Required | Default | |---|---|---| | ENTRA_API_KEY_ID | yes | — | | ENTRA_SECRET_KEY | yes | — | | ENTRA_BASE_URL | no | https://entrax.pro |

Quick check

ENTRA_API_KEY_ID=... ENTRA_SECRET_KEY=... node dist/index.js
# prints: [entrax-mcp] EntraX Payment MCP server running (stdio).

The keys are used only to sign requests locally; nothing is stored or sent anywhere except the EntraX API.