@xpayr/mcp-server v1.0.0 · Registro: io.github.xpayrcom/xpayr-mcp-server · 21 Herramientas

Servidor Model Context Protocol (MCP) para Comercio Cripto No Custodial.

Otorgue a los agentes de Claude Desktop, Cursor, VS Code Copilot, Windsurf, Cline y n8n acceso nativo y protegido por políticas a 21 herramientas XPayr fuertemente tipadas — cree checkouts multicadena en USDT/USDC, verifique webhooks HMAC, envíe intenciones de pago autónomas y modele divisiones de liquidación 99.5% / 0.5% en cadena.

21 HerramientasPara checkout, webhooks, agentes de IA y tesorería comercial.
2 TransportesJSON-RPC 2.0 Remoto (/api/mcp) + Local npx Stdio.
6 MódulosAcote las ventanas de contexto mediante --suite flagship o all.
GuardarraílesTopes por transacción, presupuestos diarios y colas de aprobación humana.

Configuración en 1 Clic para IDEs y Clientes de Agentes


        

Prueba en Vivo en el Navegador → POST /api/mcp

Envía una solicitud JSON-RPC 2.0 real al endpoint MCP Streamable HTTP en vivo de XPayr directamente desde esta página.

// Click "Run tools/list" or "Run Fee Split ($250 USDC)" to inspect live JSON-RPC 2.0 output from https://xpayr.com/api/mcp

Las 21 herramientas MCP oficiales

xpayr_health_check

Comprobación de estado de API Gateway

Comprueba la salud operativa, la versión y la marca de tiempo del servidor de XPayr Gateway API v1.

GET /health Público (Sin clave)
xpayr_create_payment_session

Crear sesión de pago cripto (Checkout Dual)

Crea una sesión de pago cripto no custodial compatible con pago Web3 en 1 clic, transferencia QR directa desde exchanges, enlaces multicadena, enlaces reutilizables por 1 año y envío automático de facturas HTML por correo.

POST /payments Bearer sk_test / sk_live
xpayr_get_payment_session

Obtener detalles de la sesión de pago

Recupera todos los detalles, metadatos, importes de división de liquidación, modo de checkout y hash de transacción on-chain de una sesión de pago.

GET /payments/{session_id} Bearer sk_test / sk_live
xpayr_list_payment_sessions

Listar sesiones de pago del comercio

Lista las sesiones de pago cripto del comercio filtrando por estado, moneda, red y paginación.

GET /payments Bearer sk_test / sk_live
xpayr_get_public_payment_status

Consultar estado público del pago on-chain

Consulta en tiempo real el estado público del checkout, tx_hash on-chain, dirección de billetera remitente, confirmaciones de bloque y marca de tiempo paid_at sin clave API.

GET /payments/{session_id}/status Público (Sin clave)
xpayr_apply_payment_coupon

Aplicar cupón de descuento en el checkout

Valida y aplica un código de cupón promocional de descuento del comercio a una sesión de pago pendiente activa.

POST /payments/{session_id}/coupon Público (Sin clave)
xpayr_get_merchant_profile

Obtener perfil del comercio y billetera de liquidación

Recupera el perfil autenticado del comercio, la dirección de billetera de liquidación, la tasa de comisión en puntos básicos (50 bps = 0.5%) y las claves API activas.

GET /me Bearer sk_test / sk_live
xpayr_get_merchant_balance

Obtener volumen y saldo de liquidación multicadena

Consulta el volumen confirmado de liquidación no custodial, el recuento de transacciones y las comisiones de plataforma agrupados por moneda y red blockchain.

GET /me/balance Bearer sk_test / sk_live
xpayr_get_supported_networks

Listar redes, cadenas y tokens compatibles

Lista todas las redes blockchain activas de EVM, TRON, Solana y Arc Mainnet/Testnet, IDs de cadena, endpoints RPC, contratos divisores y tokens compatibles.

GET /me/networks Bearer sk_test / sk_live
xpayr_get_webhook_config

Obtener configuración y eventos de webhook

Inspecciona la URL de callback de webhook del comercio, el secreto de firma HMAC-SHA256 enmascarado y los eventos suscritos del ciclo de vida del pago.

GET /webhooks Bearer sk_test / sk_live
xpayr_set_webhook_endpoint

Configurar endpoint de webhook HTTPS

Configura o actualiza la URL receptora HTTPS de webhooks del comercio y genera un nuevo secreto de firma HMAC-SHA256 de 32 bytes.

POST /webhooks Bearer sk_test / sk_live
xpayr_send_test_webhook

Enviar evento de webhook de prueba firmado

Envía una carga útil test.webhook firmada con encabezados HMAC-SHA256 para comprobar la verificación de firmas de webhook del comercio.

POST /webhooks/test Bearer sk_test / sk_live
xpayr_create_ai_agent

Crear agente de comercio de IA controlado por políticas

Aprovisiona una nueva identidad de agente de comercio de IA gestionada por el comercio con credenciales acotadas y límites de gasto programables.

POST /agents Bearer sk_test / sk_live
xpayr_list_ai_agents

Listar agentes de comercio de IA del comercio

Lista todos los agentes de comercio de IA gestionados por el comercio junto con su estado, billeteras asignadas y políticas de gasto.

GET /agents Bearer sk_test / sk_live
xpayr_update_ai_agent_policy

Actualizar límites de gasto del agente de IA

Configura los límites de la política de gasto de un agente de IA (máx. USD por transacción, tope diario, umbral de aprobación automática, cadenas/tokens permitidos).

PUT /agents/{agent_id}/policy Bearer sk_test / sk_live
xpayr_submit_agent_payment_intent

Enviar intención de pago autónoma de agente de IA

Envía una intención de pago autónoma de agente de IA evaluada en tiempo real frente a las reglas de política del comercio (approved, pending_approval, rejected).

POST /agent-intents Bearer agk_test / agk_live
xpayr_list_agent_payment_intents

Listar intenciones de pago de agentes de IA y registros de auditoría

Lista las intenciones de pago de agentes de IA, las decisiones de evaluación de políticas y los registros de auditoría del comercio.

GET /agent-intents Bearer sk_test / sk_live
xpayr_bridge_agent_intent_to_checkout

Vincular intención de agente aprobada a sesión de checkout

Convierte una intención de pago aprobada de agente de IA en una sesión de pago XPayr ejecutable en vivo con URL de checkout alojada y verificación on-chain.

POST /agent-intents/{intent_id}/bridge Bearer sk_test / sk_live
xpayr_approve_agent_intent

Aprobar intención pendiente de agente de IA (Human-in-the-Loop)

Aprueba una intención de pago pendiente de un agente de IA desde la cola de aprobación del comercio y vincúlala al checkout.

POST /agent-approvals/{intent_id}/approve Bearer sk_test / sk_live
xpayr_reject_agent_intent

Rechazar intención pendiente de agente de IA

Rechaza una intención de pago pendiente de un agente de IA en la cola de aprobación del comercio indicando un motivo de auditoría.

POST /agent-approvals/{intent_id}/reject Bearer sk_test / sk_live
xpayr_calculate_gateway_fee_and_split

Calculadora de división de comisión del 0.5% y tolerancia de exchanges

Calcula de forma determinista la división de la comisión fija del 0.5% (50 bps) de XPayr, la liquidación neta en la billetera del comercio, la tolerancia de retiro de exchanges del 1% (máx. $0.50) y el ahorro frente a BitPay, Coinbase Commerce y Stripe.

LOCAL /tools/crypto-payment-fee-calculator Sin conexión / Público

Preguntas frecuentes sobre el servidor MCP de XPayr

¿Debo conectarme mediante Streamable HTTP remoto (/api/mcp) o npx local (@xpayr/mcp-server)?

Ambos exponen las 21 herramientas de XPayr con esquemas idénticos. Streamable HTTP remoto (https://xpayr.com/api/mcp) no requiere entorno local de Node.js y funciona al instante en agentes en la nube, n8n e IDEs modernos; npx -y @xpayr/mcp-server@1.0.0 se ejecuta localmente por stdio y soporta filtrado por módulos (--suite flagship,checkout).

¿Pueden los agentes de IA llamar a herramientas públicas MCP sin una clave API?

Sí. El descubrimiento público, el estado de salud de la pasarela (xpayr_health_check), el cálculo determinista de división del 0.5% (xpayr_calculate_gateway_fee_and_split) y la consulta pública del estado de sesión funcionan sin credenciales. Las herramientas autenticadas de creación de pagos e intenciones de agente utilizan su clave sk_test_ o sk_live_.

¿Cómo evitan los guardarraíles de gasto que una alucinación de un LLM gaste en exceso?

Los Agentes de Comercio con IA de XPayr aplican en el servidor topes por transacción, presupuestos diarios móviles, umbrales de autoaprobación, listas blancas de cadenas/tokens y colas de aprobación humana (/agent-commerce) antes de que se mueva cualquier fondo en cadena.

¿Dónde está publicado y verificado XPayr MCP?

XPayr MCP está publicado en npm (@xpayr/mcp-server@1.0.0), GitHub Container Registry (ghcr.io/xpayrcom/xpayr-mcp-server), el Registro Oficial MCP, Glama y Smithery, y documentado en https://mcp.xpayr.com y /.well-known/mcp.json.