SnapEX Pay MCP

An official MCP server for SnapEX Pay that allows AI agents to autonomously manage crypto payment operations. Agents can create merchant accounts without captchas, generate invoices, receive payments in 70+ coins settled in USDT, manage balances, execute payouts, and handle currency conversions via a unified API interface.

Visit SnapEX Pay

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-02Operated by SnapEX Pay

MCP endpoint (Streamable HTTP)

https://pay.snapex.pro/mcp

Vendor documentation

What its tools do

32 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (19)

get_account
list_assets
get_fiat_rates
get_fees
list_static_address_networks
get_balances
list_transactions
get_invoice
list_invoices
get_invoice_payment_methods
get_payment
list_payments
list_static_addresses
list_static_address_deposits
get_payout
list_payouts
get_conversion
list_conversions
list_webhooks

32 of 32 have a description · 32 of 32 declare behavior hints · 23 of 27 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

Passed Endpoint answered the live check · Nov 2, 2026, 3:14 PM UTC
Passed Official MCP Registry namespace is tied to snapex.pro · Nov 2, 2026, 2:58 PM UTC
Passed Endpoint is on the registry namespace domain · Nov 2, 2026, 2:58 PM UTC
Availability 1 of 1 checks passed in 30 days

What you can do with it

Create merchant accounts and API keys automatically
Generate invoices and monitor payment status
Withdraw USDT balance to external wallets
Convert crypto assets to USDT

Source and maintenance

Vendor evidenceRegistry 1.0.0MIT

mcp-registry: pro.snapex/pay@1.0.0 Source repository Project website

Last repository push: Nov 2, 2026, 2:47 PM UTC
Latest release: v1.0.0
Maintenance checked: Nov 2, 2026, 6:39 PM UTC

Protocol and capabilities

Server: snapex-pay 1.0.0
MCP protocol negotiated in check: 2025-06-18
Tools: 32 advertised
Resources: 2 advertised
Resource templates: 0 advertised
Prompts: 2 advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  },
  "logging": {},
  "prompts": {
    "listChanged": false
  },
  "resources": {
    "subscribe": false,
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

SnapEX Pay lets you accept, send and exchange crypto as a merchant account. Without an API key only create_account and the catalogue tools (list_assets, get_fiat_rates, get_fees, list_static_address_networks) work. 1. No key yet? Call create_account once (no captcha, no person needed). The new key is used on this connection automatically; save api_key and use it next time as "Authorization: Bearer <api_key>" (or the returned mcp_personal_url). 2. Receive: create_invoice → give pay_url to the payer (or select_invoice_payment_method for a raw address) → get_invoice until status "paid". Use environment "test" first: no real money. Permanent top-up addresses: create_static_address. 3. Balance: get_balances (credited in USDT). 4. Send: preview_payout → check to_amount, fee, address → create_payout with the preview_id and your own idempotency_key (irreversible). Track with get_payout. 5. Exchange: the balance is USDT; to get another coin, pay out in that coin (step 4). preview_conversion → create_conversion turns other assets an older account holds into USDT. Amounts are decimal strings ("12.5"). Asset codes come from list_assets. Errors explain what to do next. Docs: resource snapex://docs/quickstart, https://pay.snapex.pro/mcp

Tools

32 advertised

create_account — Open a SnapEX Pay account (no captcha)

Advertised by the server during the last successful anonymous check.

Open-world

Opens a new SnapEX Pay merchant account for you and returns a merchant API key with every scope (receive, pay out, convert, webhooks). No captcha, no email confirmation, no person needed. Call it once, only when you have no key yet (other tools answer "unauthorized"). On this MCP connection the new key is used automatically from now on; save api_key (shown once) and use it next time as "Authorization: Bearer <api_key>", or connect to mcp_personal_url. login and password (generated when omitted) let a person open the cabinet at cabinet_url. The account starts with a zero balance; money arrives only from payments to your invoices or addresses. Limited to a few accounts per IP per hour.

create_account input schema

{
  "type": "object",
  "properties": {
    "agent": {
      "type": "string",
      "examples": [
        "Acme shop assistant"
      ],
      "maxLength": 120,
      "description": "Who you are: your product or agent name (shown to SnapEX support)."
    },
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 191,
      "description": "Optional contact email of the account owner."
    },
    "login": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9._-]+$",
      "maxLength": 64,
      "minLength": 3,
      "description": "Optional cabinet login; generated (agent-xxxxxxxxxx) when omitted."
    },
    "password": {
      "type": "string",
      "maxLength": 255,
      "minLength": 8,
      "description": "Optional cabinet password; a strong one is generated and returned when omitted."
    },
    "telegram": {
      "type": "string",
      "maxLength": 128,
      "description": "Optional Telegram @username of the owner."
    }
  },
  "additionalProperties": false
}

create_account annotations

{
  "title": "Open an account",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

get_account — Show the current account and key

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the account behind the API key in use: login, the key prefix and scopes, cabinet_url for a person and mcp_personal_url (a secret MCP URL with this key built in, for clients that cannot send headers). Use it to check you are connected to the right account.

get_account input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_account annotations

{
  "title": "Show account",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

list_assets — List coins and networks

Advertised by the server during the last successful anonymous check.

Advertised read-only

Lists the coins and networks SnapEX Pay works with now: asset_id (the code other tools take), symbol, network, decimals, price_usd, payment (can be received), payout (can be paid out) and payout_min_usd. No key needed. Call it before creating invoices, payouts or conversions to pick valid asset codes.

list_assets input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_assets annotations

{
  "title": "List assets",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_fiat_rates — Fiat exchange rates

Advertised by the server during the last successful anonymous check.

Advertised read-only

Fiat → USD rates used for invoices priced in another currency (create_invoice with price_amount + price_currency). Without currency returns all rates; with currency (ISO 4217, e.g. "EUR") returns one or not_found. No key needed.

get_fiat_rates input schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "examples": [
        "EUR"
      ],
      "description": "ISO 4217 code."
    }
  },
  "additionalProperties": false
}

get_fiat_rates annotations

{
  "title": "Fiat rates",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_fees — Fees and limits

Advertised by the server during the last successful anonymous check.

Advertised read-only

What SnapEX Pay charges, no key needed. pricing: invoice_fee_percent (of a paid invoice; fee_on=customer puts it on the payer), invoice_min_usd/invoice_max_usd, static_address_fee_percent, payout_service_fee_percent; the network fee of a payout depends on the coin and is quoted by preview_payout, the smallest payout per coin is payout_min_usd in list_assets. data: recent cached route fee quotes (often empty; filter by route and asset codes).

get_fees input schema

{
  "type": "object",
  "properties": {
    "route": {
      "type": "string",
      "description": "Route name, e.g. \"payout\"."
    },
    "to_asset_id": {
      "type": "string",
      "description": "Public asset code from list_assets (its asset_id field), e.g. \"usdt\" (USDT TRC20), \"btc\", \"eth\", \"xmr\", \"usdc_eth\"."
    },
    "from_asset_id": {
      "type": "string",
      "description": "Public asset code from list_assets (its asset_id field), e.g. \"usdt\" (USDT TRC20), \"btc\", \"eth\", \"xmr\", \"usdc_eth\"."
    }
  },
  "additionalProperties": false
}

get_fees annotations

{
  "title": "Fee quotes",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

list_static_address_networks — Networks for permanent addresses

Advertised by the server during the last successful anonymous check.

Advertised read-only

Lists the coins/networks for which you can get a permanent deposit address (create_static_address): asset code (e.g. "usdt.trc20", "usdc.polygon", "btc"), symbol, network, available, and how a deposit is credited (always in USDT). No key needed.

list_static_address_networks input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_static_address_networks annotations

{
  "title": "Static address networks",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_balances — Account balance

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the account balance. Every payment is credited in USDT (TRC20 accounting), whatever coin the payer used: available (can be paid out or converted now) and held (reserved by payouts in progress), each as a decimal string and in atomic units.

get_balances input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_balances annotations

{
  "title": "Balance",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

list_transactions — Balance history

Advertised by the server during the last successful anonymous check.

Advertised read-only

Ledger of the balance, newest first: every credit and debit (payments, payouts, fees, conversions) with amount, direction and time. Paginated with cursor.

list_transactions input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (1–100)."
    },
    "cursor": {
      "type": "string",
      "description": "Pass meta.next_cursor of the previous page to get the next one."
    },
    "status": {
      "type": "string",
      "description": "Filter by ledger entry type."
    }
  },
  "additionalProperties": false
}

list_transactions annotations

{
  "title": "Balance history",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

create_invoice — Create an invoice (receive crypto)

Advertised by the server during the last successful anonymous check.

Open-world

Creates an invoice and returns pay_url — a hosted payment page where the payer picks a coin and pays; the amount is credited to your balance in USDT minus the fee. Give amount_usd, or price_amount + price_currency (converted at get_fiat_rates). Use environment "test" to try the whole flow without real money: a test invoice turns paid by itself about 10 seconds after a coin is selected (on its page or with select_invoice_payment_method); the real balance does not change. Then follow the status with get_invoice or webhooks (invoice.paid). To get a deposit address right away instead of a page, pass asset_id (and lock_method true), or call select_invoice_payment_method.

create_invoice input schema

{
  "type": "object",
  "properties": {
    "fee_on": {
      "enum": [
        "merchant",
        "customer"
      ],
      "type": "string",
      "description": "Who pays the service fee: you (default) or the payer on top of the amount."
    },
    "asset_id": {
      "type": "string",
      "maxLength": 64,
      "description": "Preselect the coin the payer pays with (Public asset code from list_assets (its asset_id field), e.g. \"usdt\" (USDT TRC20), \"btc\", \"eth\", \"xmr\", \"usdc_eth\".)"
    },
    "amount_usd": {
      "type": "string",
      "pattern": "^[0-9]+(\\.[0-9]{1,8})?$",
      "examples": [
        "25",
        "9.99"
      ],
      "description": "Invoice amount in USD. Either this or price_amount + price_currency."
    },
    "cancel_url": {
      "type": "string",
      "format": "uri",
      "description": "Where the payer returns on cancel."
    },
    "expires_in": {
      "type": "integer",
      "maximum": 86400,
      "minimum": 60,
      "description": "Seconds until the invoice expires."
    },
    "description": {
      "type": "string",
      "examples": [
        "Order #1842 — 3 months VPN"
      ],
      "maxLength": 255,
      "description": "What is paid for; shown to the payer."
    },
    "environment": {
      "enum": [
        "live",
        "test"
      ],
      "type": "string",
      "default": "live",
      "description": "\"test\" — no real money: paid by itself ~10 s after a coin is selected, balance unchanged."
    },
    "external_id": {
      "type": "string",
      "examples": [
        "order-1842"
      ],
      "maxLength": 191,
      "description": "Your own reference (order id); unique per account."
    },
    "lock_method": {
      "type": "boolean",
      "description": "true — the payer cannot change asset_id (requires asset_id)."
    },
    "success_url": {
      "type": "string",
      "format": "uri",
      "description": "Where the payer returns after paying."
    },
    "price_amount": {
      "type": "string",
      "pattern": "^[0-9]+(\\.[0-9]{1,8})?$",
      "examples": [
        "1500"
      ],
      "description": "Price in your currency (with price_currency)."
    },
    "price_currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "examples": [
        "EUR",
        "RUB"
      ],
      "description": "ISO 4217 currency of price_amount."
    },
    "idempotency_key": {
      "type": "string",
      "examples": [
        "order-1842-invoice"
      ],
      "maxLength": 191,
      "description": "Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted."
    }
  },
  "additionalProperties": false
}

create_invoice annotations

{
  "title": "Create invoice",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

get_invoice — Invoice status

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns one invoice with its status (open, awaiting, underpaid, paid, partially_paid, expired), pay_url, credit_usd, the selected coin and the payment attempts. Poll it every 15–30 s while the payer pays, or use webhooks.

get_invoice input schema

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "invoice_id from create_invoice."
    }
  },
  "additionalProperties": false
}

get_invoice annotations

{
  "title": "Invoice status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

list_invoices — List invoices

Advertised by the server during the last successful anonymous check.

Advertised read-only

Invoices of the account, newest first, optionally filtered by status and environment. Paginated with cursor.

list_invoices input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (1–100)."
    },
    "cursor": {
      "type": "string",
      "description": "Pass meta.next_cursor of the previous page to get the next one."
    },
    "status": {
      "type": "string",
      "description": "e.g. \"paid\", \"awaiting\", \"expired\"."
    },
    "environment": {
      "enum": [
        "live",
        "test"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_invoices annotations

{
  "title": "List invoices",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_invoice_payment_methods — Coins an invoice can be paid with

Advertised by the server during the last successful anonymous check.

Advertised read-only

Lists the coins and networks the payer can use for this invoice, with the amount to send in each.

get_invoice_payment_methods input schema

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "invoice_id from create_invoice."
    }
  },
  "additionalProperties": false
}

get_invoice_payment_methods annotations

{
  "title": "Invoice methods",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

select_invoice_payment_method — Pick a coin for an invoice

Advertised by the server during the last successful anonymous check.

Open-world

Chooses the coin for an invoice and returns the deposit address and exact amount to send (in the invoice payment attempt) — use it when you pass the address to the payer yourself instead of pay_url.

select_invoice_payment_method input schema

{
  "type": "object",
  "required": [
    "invoice_id",
    "asset_id"
  ],
  "properties": {
    "asset_id": {
      "type": "string",
      "maxLength": 64,
      "description": "A code from get_invoice_payment_methods."
    },
    "invoice_id": {
      "type": "string",
      "description": "invoice_id from create_invoice."
    }
  },
  "additionalProperties": false
}

select_invoice_payment_method annotations

{
  "title": "Select invoice coin",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

preview_payment — Quote a direct payment

Advertised by the server during the last successful anonymous check.

Open-world

Low-level alternative to invoices: quotes a payment of an exact amount in one coin and how much USDT you will be credited. Returns credit_lock_id for create_payment (valid until expires_at). Most agents should use create_invoice instead.

preview_payment input schema

{
  "type": "object",
  "required": [
    "asset_id"
  ],
  "properties": {
    "amount": {
      "type": "string",
      "pattern": "^[0-9]+(\\.[0-9]+)?$",
      "examples": [
        "0.0005"
      ],
      "description": "Amount the payer sends, in coin units."
    },
    "asset_id": {
      "type": "string",
      "description": "Coin the payer sends. Public asset code from list_assets (its asset_id field), e.g. \"usdt\" (USDT TRC20), \"btc\", \"eth\", \"xmr\", \"usdc_eth\"."
    },
    "amount_atomic": {
      "type": "string",
      "pattern": "^[0-9]+$",
      "description": "Amount in the smallest units of the asset (alternative to amount). Give exactly one of amount and amount_atomic."
    },
    "idempotency_key": {
      "type": "string",
      "examples": [
        "order-1842-invoice"
      ],
      "maxLength": 191,
      "description": "Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted."
    }
  },
  "additionalProperties": false
}

preview_payment annotations

{
  "title": "Quote payment",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

create_payment — Create a direct payment

Advertised by the server during the last successful anonymous check.

Open-world

Creates a payment from a preview_payment quote and returns deposit_address (and deposit_memo when the network needs one) and the exact amount the payer must send before expires_at.

create_payment input schema

{
  "type": "object",
  "required": [
    "credit_lock_id"
  ],
  "properties": {
    "external_id": {
      "type": "string",
      "examples": [
        "order-1842"
      ],
      "maxLength": 191,
      "description": "Your own reference (order id); unique per account."
    },
    "credit_lock_id": {
      "type": "string",
      "format": "uuid",
      "description": "credit_lock_id from preview_payment."
    },
    "idempotency_key": {
      "type": "string",
      "examples": [
        "order-1842-invoice"
      ],
      "maxLength": 191,
      "description": "Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted."
    }
  },
  "additionalProperties": false
}

create_payment annotations

{
  "title": "Create payment",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

get_payment — Payment status

Advertised by the server during the last successful anonymous check.

Advertised read-only

One payment (from an invoice, a static address or create_payment): status (e.g. awaiting_deposit, detected, confirmed, expired), amounts expected/received/credited, deposit address.

get_payment input schema

{
  "type": "object",
  "required": [
    "payment_id"
  ],
  "properties": {
    "payment_id": {
      "type": "string",
      "description": "payment_id."
    }
  },
  "additionalProperties": false
}

get_payment annotations

{
  "title": "Payment status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

list_payments — List payments

Advertised by the server during the last successful anonymous check.

Advertised read-only

Payments of the account, newest first, optionally filtered by status. Paginated with cursor.

list_payments input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (1–100)."
    },
    "cursor": {
      "type": "string",
      "description": "Pass meta.next_cursor of the previous page to get the next one."
    },
    "status": {
      "type": "string",
      "description": "e.g. \"confirmed\"."
    }
  },
  "additionalProperties": false
}

list_payments annotations

{
  "title": "List payments",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

create_static_address — Permanent deposit address

Advertised by the server during the last successful anonymous check.

Open-world

Gets (or creates) a permanent deposit address for a coin/network and optional customer_ref: the same address comes back for the same customer_ref. Every transfer to it is credited to your balance in USDT as a separate payment — good for top-ups. Networks: list_static_address_networks.

create_static_address input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "examples": [
        "usdt.trc20",
        "btc"
      ],
      "maxLength": 32,
      "description": "Code from list_static_address_networks, e.g. \"usdt.trc20\", or a coin symbol with network."
    },
    "label": {
      "type": "string",
      "maxLength": 120,
      "description": "Note for yourself."
    },
    "network": {
      "type": "string",
      "maxLength": 32,
      "description": "Network when asset is a bare symbol, e.g. \"polygon\"."
    },
    "customer_ref": {
      "type": "string",
      "pattern": "^[\\x21-\\x7E]+$",
      "examples": [
        "user-77"
      ],
      "maxLength": 191,
      "description": "Your customer id: one address per customer."
    }
  },
  "additionalProperties": false
}

create_static_address annotations

{
  "title": "Static address",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

list_static_addresses — List permanent addresses

Advertised by the server during the last successful anonymous check.

Advertised read-only

Permanent deposit addresses of the account, optionally for one customer_ref. Paginated with cursor.

list_static_addresses input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (1–100)."
    },
    "cursor": {
      "type": "string",
      "description": "Pass meta.next_cursor of the previous page to get the next one."
    },
    "customer_ref": {
      "type": "string",
      "maxLength": 191
    }
  },
  "additionalProperties": false
}

list_static_addresses annotations

{
  "title": "List static addresses",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

list_static_address_deposits — Deposits to a permanent address

Advertised by the server during the last successful anonymous check.

Advertised read-only

Transfers received on one permanent address with their status and credited USDT. Paginated with cursor.

list_static_address_deposits input schema

{
  "type": "object",
  "required": [
    "address_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (1–100)."
    },
    "cursor": {
      "type": "string",
      "description": "Pass meta.next_cursor of the previous page to get the next one."
    },
    "address_id": {
      "type": "string",
      "format": "uuid",
      "description": "address_id from create_static_address."
    }
  },
  "additionalProperties": false
}

list_static_address_deposits annotations

{
  "title": "Static address deposits",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

preview_payout — Quote a payout (send crypto)

Advertised by the server during the last successful anonymous check.

Open-world

Step 1 of sending money. Quotes a payout of amount USDT from your balance to an address in any coin with payout=true in list_assets: returns preview_id, to_amount (what the recipient gets), fee and expires_at. Nothing is sent yet and the quote is free; check the address and amounts, then call create_payout with preview_id before expires_at. An invalid address answers invalid_address.

preview_payout input schema

{
  "type": "object",
  "required": [
    "destination_asset_id",
    "destination_network",
    "destination_address"
  ],
  "properties": {
    "amount": {
      "type": "string",
      "pattern": "^[0-9]+(\\.[0-9]+)?$",
      "examples": [
        "15"
      ],
      "description": "USDT to take from your balance."
    },
    "amount_atomic": {
      "type": "string",
      "pattern": "^[0-9]+$",
      "description": "Amount in the smallest units of the asset (alternative to amount). Give exactly one of amount and amount_atomic."
    },
    "idempotency_key": {
      "type": "string",
      "examples": [
        "order-1842-invoice"
      ],
      "maxLength": 191,
      "description": "Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted."
    },
    "destination_address": {
      "type": "string",
      "maxLength": 255,
      "description": "Recipient address in that network."
    },
    "destination_network": {
      "type": "string",
      "examples": [
        "TRON",
        "Bitcoin"
      ],
      "maxLength": 64,
      "description": "Network of the destination coin: the network field from list_assets."
    },
    "destination_asset_id": {
      "type": "string",
      "description": "Coin the recipient gets. Public asset code from list_assets (its asset_id field), e.g. \"usdt\" (USDT TRC20), \"btc\", \"eth\", \"xmr\", \"usdc_eth\"."
    }
  },
  "additionalProperties": false
}

preview_payout annotations

{
  "title": "Quote payout",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

create_payout — Send a payout (irreversible)

Advertised by the server during the last successful anonymous check.

Advertised destructiveOpen-world

Step 2 of sending money: executes a preview_payout quote and sends real funds from your balance — irreversible once sent. destination_network and destination_address must be the ones of the preview. idempotency_key is required: reuse the same key when retrying after a timeout so the payout is never sent twice. Then follow get_payout (status until completed or failed, transaction_url) or webhooks payout.completed / payout.failed.

create_payout input schema

{
  "type": "object",
  "required": [
    "preview_id",
    "destination_network",
    "destination_address",
    "idempotency_key"
  ],
  "properties": {
    "preview_id": {
      "type": "string",
      "format": "uuid",
      "description": "preview_id from preview_payout (not expired)."
    },
    "external_id": {
      "type": "string",
      "examples": [
        "order-1842"
      ],
      "maxLength": 191,
      "description": "Your own reference (order id); unique per account."
    },
    "idempotency_key": {
      "type": "string",
      "examples": [
        "payout-2026-11-02-001"
      ],
      "maxLength": 191,
      "minLength": 1,
      "description": "Required. Your unique key of this payout; the same key never sends twice."
    },
    "destination_memo": {
      "type": "string",
      "maxLength": 255,
      "description": "Memo/tag when the destination needs one (exchanges, XRP, TON…)."
    },
    "destination_address": {
      "type": "string",
      "maxLength": 255,
      "description": "Same as in preview_payout."
    },
    "destination_network": {
      "type": "string",
      "maxLength": 64,
      "description": "Same as in preview_payout."
    }
  },
  "additionalProperties": false
}

create_payout annotations

{
  "title": "Send payout",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": true
}

get_payout — Payout status

Advertised by the server during the last successful anonymous check.

Advertised read-only

One payout: status (e.g. processing, completed, failed; manual_review — SnapEX staff checks it), amounts, fee, transaction_hash and transaction_url in the destination network's explorer.

get_payout input schema

{
  "type": "object",
  "required": [
    "payout_id"
  ],
  "properties": {
    "payout_id": {
      "type": "string",
      "description": "payout_id from create_payout."
    }
  },
  "additionalProperties": false
}

get_payout annotations

{
  "title": "Payout status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

list_payouts — List payouts

Advertised by the server during the last successful anonymous check.

Advertised read-only

Payouts of the account, newest first, optionally filtered by status. Paginated with cursor.

list_payouts input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (1–100)."
    },
    "cursor": {
      "type": "string",
      "description": "Pass meta.next_cursor of the previous page to get the next one."
    },
    "status": {
      "type": "string",
      "description": "e.g. \"completed\"."
    }
  },
  "additionalProperties": false
}

list_payouts annotations

{
  "title": "List payouts",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

preview_conversion — Quote a conversion (exchange)

Advertised by the server during the last successful anonymous check.

Open-world

Step 1 of converting assets held on the account into USDT. The balance is kept in USDT (every payment is credited in USDT), so this matters only for an account that still holds another asset; to exchange USDT into another coin, send a payout in that coin (preview_payout, e.g. to your own address). mode "single": convert amount of from_asset_id (to USDT, or to to_asset_id); mode "all_to_usdt": convert every non-USDT holding to USDT. Returns preview_id with the amounts and expires_at; nothing moves yet. Then create_conversion.

preview_conversion input schema

{
  "type": "object",
  "required": [
    "mode"
  ],
  "properties": {
    "mode": {
      "enum": [
        "single",
        "all_to_usdt"
      ],
      "type": "string",
      "description": "\"single\" — one asset; \"all_to_usdt\" — everything to USDT."
    },
    "amount": {
      "type": "string",
      "pattern": "^[0-9]+(\\.[0-9]+)?$",
      "description": "Amount of from_asset_id (mode \"single\")."
    },
    "external_id": {
      "type": "string",
      "examples": [
        "order-1842"
      ],
      "maxLength": 191,
      "description": "Your own reference (order id); unique per account."
    },
    "to_asset_id": {
      "type": "string",
      "description": "Target asset (default USDT). Public asset code from list_assets (its asset_id field), e.g. \"usdt\" (USDT TRC20), \"btc\", \"eth\", \"xmr\", \"usdc_eth\"."
    },
    "amount_atomic": {
      "type": "string",
      "pattern": "^[0-9]+$",
      "description": "Amount in the smallest units of the asset (alternative to amount). Give exactly one of amount and amount_atomic."
    },
    "from_asset_id": {
      "type": "string",
      "description": "Required for mode \"single\". Public asset code from list_assets (its asset_id field), e.g. \"usdt\" (USDT TRC20), \"btc\", \"eth\", \"xmr\", \"usdc_eth\"."
    },
    "idempotency_key": {
      "type": "string",
      "examples": [
        "order-1842-invoice"
      ],
      "maxLength": 191,
      "description": "Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted."
    }
  },
  "additionalProperties": false
}

preview_conversion annotations

{
  "title": "Quote conversion",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

create_conversion — Execute a conversion

Advertised by the server during the last successful anonymous check.

Advertised destructiveOpen-world

Step 2: executes a preview_conversion quote before its expires_at; the balance changes at once. A preview runs once — calling again returns the same conversion.

create_conversion input schema

{
  "type": "object",
  "required": [
    "preview_id"
  ],
  "properties": {
    "preview_id": {
      "type": "string",
      "format": "uuid",
      "description": "preview_id from preview_conversion."
    }
  },
  "additionalProperties": false
}

create_conversion annotations

{
  "title": "Execute conversion",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": true
}

get_conversion — Conversion status

Advertised by the server during the last successful anonymous check.

Advertised read-only

One conversion with its status and amounts.

get_conversion input schema

{
  "type": "object",
  "required": [
    "conversion_id"
  ],
  "properties": {
    "conversion_id": {
      "type": "string",
      "format": "uuid",
      "description": "conversion_id (preview_id)."
    }
  },
  "additionalProperties": false
}

get_conversion annotations

{
  "title": "Conversion status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

list_conversions — List conversions

Advertised by the server during the last successful anonymous check.

Advertised read-only

Conversions of the account, newest first. Paginated with cursor.

list_conversions input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (1–100)."
    },
    "cursor": {
      "type": "string",
      "description": "Pass meta.next_cursor of the previous page to get the next one."
    },
    "status": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_conversions annotations

{
  "title": "List conversions",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

list_webhooks — List webhook endpoints

Advertised by the server during the last successful anonymous check.

Advertised read-only

Webhook endpoints of the account: endpoint_id, url, events, status.

list_webhooks input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_webhooks annotations

{
  "title": "List webhooks",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

create_webhook — Add a webhook endpoint

Advertised by the server during the last successful anonymous check.

Open-world

Registers a public HTTPS URL that receives a POST for each chosen event (JSON {id, type, created_at, data}). Returns secret (shown once): verify each delivery with HMAC-SHA256 of "<Webhook-Timestamp>.<raw body>" against the Webhook-Signature header ("v1=<hex>"). Deliveries are at-least-once — dedupe by Webhook-Id. Up to 10 endpoints.

create_webhook input schema

{
  "type": "object",
  "required": [
    "url",
    "events"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "examples": [
        "https://shop.example.com/snapex/webhook"
      ],
      "maxLength": 2048,
      "description": "Public HTTPS URL."
    },
    "events": {
      "type": "array",
      "items": {
        "enum": [
          "payment.created",
          "payment.detected",
          "payment.credited",
          "payment.expired",
          "payout.created",
          "payout.processing",
          "payout.sent",
          "payout.completed",
          "payout.failed",
          "conversion.completed",
          "conversion.failed",
          "balance.changed",
          "invoice.created",
          "invoice.awaiting",
          "invoice.underpaid",
          "invoice.paid",
          "invoice.partially_paid",
          "invoice.expired",
          "invoice.extra_payment",
          "static_deposit.detected",
          "static_deposit.credited"
        ],
        "type": "string"
      },
      "examples": [
        [
          "invoice.paid",
          "invoice.expired",
          "payout.completed",
          "payout.failed"
        ]
      ],
      "minItems": 1,
      "description": "Events to deliver. Typical: [\"invoice.paid\",\"invoice.expired\",\"payout.completed\",\"payout.failed\"].",
      "uniqueItems": true
    }
  },
  "additionalProperties": false
}

create_webhook annotations

{
  "title": "Add webhook",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

update_webhook — Change a webhook endpoint

Advertised by the server during the last successful anonymous check.

Open-world

Replaces the url and events of an endpoint, or disables/enables it (status).

update_webhook input schema

{
  "type": "object",
  "required": [
    "endpoint_id",
    "url",
    "events"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "events": {
      "type": "array",
      "items": {
        "enum": [
          "payment.created",
          "payment.detected",
          "payment.credited",
          "payment.expired",
          "payout.created",
          "payout.processing",
          "payout.sent",
          "payout.completed",
          "payout.failed",
          "conversion.completed",
          "conversion.failed",
          "balance.changed",
          "invoice.created",
          "invoice.awaiting",
          "invoice.underpaid",
          "invoice.paid",
          "invoice.partially_paid",
          "invoice.expired",
          "invoice.extra_payment",
          "static_deposit.detected",
          "static_deposit.credited"
        ],
        "type": "string"
      },
      "examples": [
        [
          "invoice.paid",
          "invoice.expired",
          "payout.completed",
          "payout.failed"
        ]
      ],
      "minItems": 1,
      "description": "Events to deliver. Typical: [\"invoice.paid\",\"invoice.expired\",\"payout.completed\",\"payout.failed\"].",
      "uniqueItems": true
    },
    "status": {
      "enum": [
        "active",
        "disabled"
      ],
      "type": "string"
    },
    "endpoint_id": {
      "type": "string",
      "format": "uuid",
      "description": "endpoint_id from list_webhooks."
    }
  },
  "additionalProperties": false
}

update_webhook annotations

{
  "title": "Change webhook",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

rotate_webhook_secret — New webhook secret

Advertised by the server during the last successful anonymous check.

Advertised destructive

Issues a new signing secret for an endpoint (shown once); the old one stops working at once.

rotate_webhook_secret input schema

{
  "type": "object",
  "required": [
    "endpoint_id"
  ],
  "properties": {
    "endpoint_id": {
      "type": "string",
      "format": "uuid",
      "description": "endpoint_id from list_webhooks."
    }
  },
  "additionalProperties": false
}

rotate_webhook_secret annotations

{
  "title": "Rotate webhook secret",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": true
}

Prompts

2 advertised

accept_crypto_payment — Accept a crypto payment

Advertised by the server during the last successful anonymous check.

Create an invoice, give the payment link and wait until it is paid.

amount_usd: Amount in USD, e.g. 25 (required)
description: What is paid for

send_crypto_payout — Send a crypto payout

Advertised by the server during the last successful anonymous check.

Quote, check and send a payout from the balance.

amount_usdt: USDT to send from the balance (required)
coin: Coin the recipient gets, e.g. btc (required)
address: Recipient address (required)

Resources

2 advertised

quickstart — SnapEX Pay for agents: quickstart

Advertised by the server during the last successful anonymous check.

Account, receiving, payouts, conversions, test mode and limits in one page.

quickstart URI

snapex://docs/quickstart

MIME type: text/markdown

webhooks — Webhooks: events and signature check

Advertised by the server during the last successful anonymous check.

Event list, payload and how to verify Webhook-Signature.

webhooks URI

snapex://docs/webhooks

MIME type: text/markdown

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (3 of 3 answered).

2026-11-02: 3 of 3 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 1944 ms
95th percentile latency: 1944 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 2, 2026, 6:39 PM UTC · repository · passed · metadata changed · updated
Nov 2, 2026, 6:39 PM UTC · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Nov 2, 2026, 3:14 PM UTC · probe · passed · 1944 ms · metadata changed · 32 tool(s), 2 resource(s), 0 resource template(s), 2 prompt(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http snapex-pay-mcp https://pay.snapex.pro/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add snapex-pay-mcp --url https://pay.snapex.pro/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable snapex-pay-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "snapex-pay-mcp": {
      "url": "https://pay.snapex.pro/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "snapex-pay-mcp": {
      "type": "streamableHttp",
      "url": "https://pay.snapex.pro/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start snapex-pay-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "snapex-pay-mcp": {
      "type": "http",
      "url": "https://pay.snapex.pro/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http snapex-pay-mcp https://pay.snapex.pro/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "snapex-pay-mcp": {
      "url": "https://pay.snapex.pro/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "snapex-pay-mcp": {
      "serverUrl": "https://pay.snapex.pro/mcp"
    }
  }
}

Let your agent find its tools

Find servers like SnapEX Pay MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 512

Do you run SnapEX Pay MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

SnapEX Pay MCP

Endpoint and access

What its tools do

Read-only (19)

Can change data (13)

Checks and signals

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

90-day uptime

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other payments servers

Do you run SnapEX Pay MCP?