Crypto payments for AI agents: self-serve account, invoices, receiving, payouts, exchange.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional: "Bearer smk_…" merchant API key. Without it the agent calls create_account and the session goes on with the new key.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Who you are: your product or agent name (shown to SnapEX support).
Optional contact email of the account owner.
Optional cabinet login; generated (agent-xxxxxxxxxx) when omitted.
Optional cabinet password; a strong one is generated and returned when omitted.
Optional Telegram @username of the owner.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http pay https://pay.snapex.pro/mcp
Headers
Authorization (optional, not in the config above): Optional: "Bearer smk_…" merchant API key. Without it the agent calls create_account and the session goes on with the new key.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.
| Argument | Type | Description |
|---|---|---|
| agent | string | Who you are: your product or agent name (shown to SnapEX support). |
| string | Optional contact email of the account owner. | |
| login | string | Optional cabinet login; generated (agent-xxxxxxxxxx) when omitted. |
| password | string | Optional cabinet password; a strong one is generated and returned when omitted. |
| telegram | string | Optional Telegram @username of the owner. |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| preview_id* | string | preview_id from preview_conversion. |
{
"type": "object",
"required": [
"preview_id"
],
"properties": {
"preview_id": {
"type": "string",
"format": "uuid",
"description": "preview_id from preview_conversion."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| fee_on | string | Who pays the service fee: you (default) or the payer on top of the amount. |
| asset_id | string | 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 | string | Invoice amount in USD. Either this or price_amount + price_currency. |
| cancel_url | string | Where the payer returns on cancel. |
| expires_in | integer | Seconds until the invoice expires. |
| description | string | What is paid for; shown to the payer. |
| environment | string |
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.
| Argument | Type | Description |
|---|---|---|
| external_id | string | Your own reference (order id); unique per account. |
| credit_lock_id* | string | credit_lock_id from preview_payment. |
| idempotency_key | string | Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted. |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| preview_id* | string | preview_id from preview_payout (not expired). |
| external_id | string | Your own reference (order id); unique per account. |
| idempotency_key* | string | Required. Your unique key of this payout; the same key never sends twice. |
| destination_memo | string | Memo/tag when the destination needs one (exchanges, XRP, TON…). |
| destination_address* | string | Same as in preview_payout. |
| destination_network* | string | Same as in preview_payout. |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| asset* | string | Code from list_static_address_networks, e.g. "usdt.trc20", or a coin symbol with network. |
| label | string | Note for yourself. |
| network | string | Network when asset is a bare symbol, e.g. "polygon". |
| customer_ref | string | Your customer id: one address per customer. |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| url* | string | Public HTTPS URL. |
| events* | array | Events to deliver. Typical: ["invoice.paid","invoice.expired","payout.completed","payout.failed"]. |
{
"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
}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.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}One conversion with its status and amounts.
| Argument | Type | Description |
|---|---|---|
| conversion_id* | string | conversion_id (preview_id). |
{
"type": "object",
"required": [
"conversion_id"
],
"properties": {
"conversion_id": {
"type": "string",
"format": "uuid",
"description": "conversion_id (preview_id)."
}
},
"additionalProperties": false
}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).
| Argument | Type | Description |
|---|---|---|
| route | string | Route name, e.g. "payout". |
| to_asset_id | string | Public asset code from list_assets (its asset_id field), e.g. "usdt" (USDT TRC20), "btc", "eth", "xmr", "usdc_eth". |
| from_asset_id | string | Public asset code from list_assets (its asset_id field), e.g. "usdt" (USDT TRC20), "btc", "eth", "xmr", "usdc_eth". |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| currency | string | ISO 4217 code. |
{
"type": "object",
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"examples": [
"EUR"
],
"description": "ISO 4217 code."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| invoice_id* | string | invoice_id from create_invoice. |
{
"type": "object",
"required": [
"invoice_id"
],
"properties": {
"invoice_id": {
"type": "string",
"description": "invoice_id from create_invoice."
}
},
"additionalProperties": false
}Lists the coins and networks the payer can use for this invoice, with the amount to send in each.
| Argument | Type | Description |
|---|---|---|
| invoice_id* | string | invoice_id from create_invoice. |
{
"type": "object",
"required": [
"invoice_id"
],
"properties": {
"invoice_id": {
"type": "string",
"description": "invoice_id from create_invoice."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| payment_id* | string | payment_id. |
{
"type": "object",
"required": [
"payment_id"
],
"properties": {
"payment_id": {
"type": "string",
"description": "payment_id."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| payout_id* | string | payout_id from create_payout. |
{
"type": "object",
"required": [
"payout_id"
],
"properties": {
"payout_id": {
"type": "string",
"description": "payout_id from create_payout."
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Conversions of the account, newest first. Paginated with cursor.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Items per page (1–100). |
| cursor | string | Pass meta.next_cursor of the previous page to get the next one. |
| status | string |
{
"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
}Invoices of the account, newest first, optionally filtered by status and environment. Paginated with cursor.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Items per page (1–100). |
| cursor | string | Pass meta.next_cursor of the previous page to get the next one. |
| status | string | e.g. "paid", "awaiting", "expired". |
| environment | string |
{
"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
}Payments of the account, newest first, optionally filtered by status. Paginated with cursor.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Items per page (1–100). |
| cursor | string | Pass meta.next_cursor of the previous page to get the next one. |
| status | string | e.g. "confirmed". |
{
"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
}Payouts of the account, newest first, optionally filtered by status. Paginated with cursor.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Items per page (1–100). |
| cursor | string | Pass meta.next_cursor of the previous page to get the next one. |
| status | string | e.g. "completed". |
{
"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
}Transfers received on one permanent address with their status and credited USDT. Paginated with cursor.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Items per page (1–100). |
| cursor | string | Pass meta.next_cursor of the previous page to get the next one. |
| address_id* | string | address_id from create_static_address. |
{
"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
}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.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Permanent deposit addresses of the account, optionally for one customer_ref. Paginated with cursor.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Items per page (1–100). |
| cursor | string | Pass meta.next_cursor of the previous page to get the next one. |
| customer_ref | string |
{
"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
}Ledger of the balance, newest first: every credit and debit (payments, payouts, fees, conversions) with amount, direction and time. Paginated with cursor.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Items per page (1–100). |
| cursor | string | Pass meta.next_cursor of the previous page to get the next one. |
| status | string | Filter by ledger entry type. |
{
"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
}Webhook endpoints of the account: endpoint_id, url, events, status.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| mode* | string | "single" — one asset; "all_to_usdt" — everything to USDT. |
| amount | string | Amount of from_asset_id (mode "single"). |
| external_id | string | Your own reference (order id); unique per account. |
| to_asset_id | string | 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 | string | Amount in the smallest units of the asset (alternative to amount). Give exactly one of amount and amount_atomic. |
| from_asset_id | string | 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 |
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.
| Argument | Type | Description |
|---|---|---|
| amount | string | Amount the payer sends, in coin units. |
| asset_id* | string | 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 | string | Amount in the smallest units of the asset (alternative to amount). Give exactly one of amount and amount_atomic. |
| idempotency_key | string | Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted. |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| amount | string | USDT to take from your balance. |
| amount_atomic | string | Amount in the smallest units of the asset (alternative to amount). Give exactly one of amount and amount_atomic. |
| idempotency_key | string | Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted. |
| destination_address* | string | Recipient address in that network. |
| destination_network* | string | Network of the destination coin: the network field from list_assets. |
| destination_asset_id* | string | Coin the recipient gets. Public asset code from list_assets (its asset_id field), e.g. "usdt" (USDT TRC20), "btc", "eth", "xmr", "usdc_eth". |
{
"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
}Issues a new signing secret for an endpoint (shown once); the old one stops working at once.
| Argument | Type | Description |
|---|---|---|
| endpoint_id* | string | endpoint_id from list_webhooks. |
{
"type": "object",
"required": [
"endpoint_id"
],
"properties": {
"endpoint_id": {
"type": "string",
"format": "uuid",
"description": "endpoint_id from list_webhooks."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| asset_id* | string | A code from get_invoice_payment_methods. |
| invoice_id* | string | invoice_id from create_invoice. |
{
"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
}Replaces the url and events of an endpoint, or disables/enables it (status).
| Argument | Type | Description |
|---|---|---|
| url* | string | |
| events* | array | Events to deliver. Typical: ["invoice.paid","invoice.expired","payout.completed","payout.failed"]. |
| status | string | |
| endpoint_id* | string | endpoint_id from list_webhooks. |
{
"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
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 2, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.
| "test" — no real money: paid by itself ~10 s after a coin is selected, balance unchanged. |
| external_id | string | Your own reference (order id); unique per account. |
| lock_method | boolean | true — the payer cannot change asset_id (requires asset_id). |
| success_url | string | Where the payer returns after paying. |
| price_amount | string | Price in your currency (with price_currency). |
| price_currency | string | ISO 4217 currency of price_amount. |
| idempotency_key | string | Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted. |
{
"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
}| string |
| Optional. The same key returns the same result instead of a duplicate (safe retries); generated when omitted. |
{
"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
}