Conexión
URL del servidor (Streamable HTTP):
https://pay.snapex.pro/mcp
No hace falta una clave para empezar: el agente llama a create_account y sigue con su nueva clave en la misma sesión. Configuración para los clientes más usados:
Claude Code
claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp
Cursor — ~/.cursor/mcp.json
{
"mcpServers": {
"snapex-pay": {
"url": "https://pay.snapex.pro/mcp"
}
}
}
VS Code — .vscode/mcp.json
{
"servers": {
"snapex-pay": {
"type": "http",
"url": "https://pay.snapex.pro/mcp"
}
}
}
Windsurf — ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"snapex-pay": {
"serverUrl": "https://pay.snapex.pro/mcp"
}
}
}
Claude Desktop — claude_desktop_config.json
{
"mcpServers": {
"snapex-pay": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pay.snapex.pro/mcp"
]
}
}
}
Conectores de claude.ai y ChatGPT
Añada un conector personalizado con la URL del servidor. Estos clientes no pueden enviar cabeceras: después de create_account tome mcp_personal_url de la respuesta y úselo como URL del conector; así cada chat nuevo usa la misma cuenta. Guarde esa URL como una contraseña.
Si ya tiene una clave
Añada la cabecera Authorization: Bearer smk_…: la clave de comercio del panel (Comercio → Desarrolladores) o la de create_account.
{
"mcpServers": {
"snapex-pay": {
"url": "https://pay.snapex.pro/mcp",
"headers": {
"Authorization": "Bearer smk_…"
}
}
}
}
Cómo trabaja el agente
- Conecte la URL; no hace falta clave.
- El agente llama a
create_account: sin captcha ni correo. Recibe una clave con todos los permisos y la sesión continúa con ella. - Para cobrar:
create_invoice→ el pagador abrepay_url→get_invoicemuestra paid. Los pagos se acreditan al saldo en USDT. - Para pagar:
preview_payoutmuestra el importe y la comisión,create_payoutenvía, en cualquier moneda delist_assets.
Herramientas
Las mismas herramientas en el servidor remoto y en el paquete local. Cada respuesta es JSON; un error indica qué hacer a continuación.
Cuenta
create_account, get_account
Monedas, tipos de cambio y comisiones (sin clave)
list_assets, get_fiat_rates, get_fees, list_static_address_networks
Saldo e historial
get_balances, list_transactions
Cobros: facturas, pagos, direcciones permanentes
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
Envíos: pagos salientes
preview_payout, create_payout, get_payout, list_payouts
Cambio: conversiones
preview_conversion, create_conversion, get_conversion, list_conversions
Webhooks
list_webhooks, create_webhook, update_webhook, rotate_webhook_secret
Seguridad
- La clave y la contraseña generada se muestran una sola vez, en la respuesta de
create_account. Con el usuario y la contraseña una persona puede entrar al panel. - El agente solo mueve el dinero de su propia cuenta. Una cuenta nueva empieza en cero; el dinero llega de los pagos a sus facturas y direcciones.
- Enviar son dos pasos:
preview_payoutmuestra el importe y la comisión,create_payoutenvía con elidempotency_keypropio del agente: un reintento nunca paga dos veces. - Modo de prueba: una factura con environment test recorre todo el flujo sin dinero real.
- Límites: pocas cuentas nuevas por IP y hora; pagos salientes: 5 por minuto y 30 por hora por clave.
- Qué se puede y qué no se puede vender: Reglas
Sin MCP
Lo mismo funciona con la API REST: la cuenta en una sola petición y después la Merchant API con la clave.
curl -X POST https://pay.snapex.pro/api/v1/merchant/signup -H 'Content-Type: application/json' -d '{"agent":"my-agent"}'