# SnapEX Pay

> Crypto payment gateway for merchants and AI agents: invoices and permanent addresses in many coins, balance in USDT, payouts to any supported coin, conversions. An agent can open an account itself through the API or MCP, without a captcha.

## MCP server (for AI agents)

- Endpoint (Streamable HTTP): https://pay.snapex.pro/mcp
- Auth: optional header `Authorization: Bearer <merchant API key>`. Without a key, call the tool `create_account` — it returns a key with every scope and the session goes on with it.
- Connect in Claude Code: `claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp`
- Docs and configs for Claude, Cursor, VS Code, Windsurf, ChatGPT: https://pay.snapex.pro/mcp
- Server card: https://pay.snapex.pro/.well-known/mcp.json

Tools:
- Account: create_account, get_account
- Catalog: list_assets, get_fiat_rates, get_fees, list_static_address_networks
- Balance: get_balances, list_transactions
- Receive: create_invoice, get_invoice, list_invoices, get_invoice_payment_methods, select_invoice_payment_method, preview_payment, create_payment, get_payment, list_payments, create_static_address, list_static_addresses, list_static_address_deposits
- Send: preview_payout, create_payout, get_payout, list_payouts
- Exchange: preview_conversion, create_conversion, get_conversion, list_conversions
- Webhooks: list_webhooks, create_webhook, update_webhook, rotate_webhook_secret

## REST API

- Account for an agent: `POST https://pay.snapex.pro/api/v1/merchant/signup` (JSON, all fields optional) → `api_key`
- Merchant API reference: https://pay.snapex.pro/partner/merchant/docs
- Rules (allowed and prohibited goods): https://pay.snapex.pro/rules

## Quickstart

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