Tu agente de IA,
conectado a los pagos
El servidor MCP de SatsRail es remoto y está alojado por nosotros: 53 herramientas para órdenes, facturas, enlaces de pago, productos y webhooks en un solo endpoint al que cualquier cliente MCP puede conectarse. Nada que instalar. Te conectas con una URL y una clave API.
Una API de pagos para Bitcoin, por Lightning u on-chain (acceso anticipado): piensa en Stripe, pero sin custodia y hecha para agentes.
Un endpoint. Toda la API.
Model Context Protocol es el estándar abierto para darles herramientas a los agentes. Este es el nuestro.
Alojado, no instalado
Sin paquete npm, sin un proceso local que ejecutar o mantener actualizado. El servidor vive dentro de la API. Solo te conectas a una URL.
53 herramientas
Todo el ciclo de vida del pago: la misma API de comercio que usa tu panel, expuesta como herramientas que un agente puede llamar directamente.
Cualquier cliente MCP
Claude Code, Claude Desktop, Cursor, Windsurf y cualquier cliente que hable Streamable HTTP. Los clientes stdio se conectan con un puente de una sola línea.
Tres pasos
De cero a un agente capaz de cobrar un pago.
Crea una clave API
Genera una clave en tu panel. Usa una clave de prueba mientras desarrollas y una clave live en producción.
Pega un bloque de configuración
Apunta tu cliente MCP al endpoint con tu clave como encabezado. Esa es toda la configuración.
Tu agente cobra
Crea órdenes, genera facturas Lightning o direcciones on-chain (acceso anticipado) y consulta el estado de los pagos. Lightning se liquida en segundos; on-chain es definitivo una vez confirmado. Los fondos van directo a la billetera del propio comercio.
Conéctate en segundos
La configuración completa para un cliente HTTP nativo.
{
"mcpServers": {
"satsrail": {
"type": "http",
"url": "https://app.satsrail.com/api/v1/mcp",
"headers": { "Authorization": "Bearer sk_live_your_key" }
}
}
}
Funciona en Claude Code, Claude Desktop, Cursor, Windsurf y cualquier cliente MCP con Streamable HTTP. Los clientes que solo hablan stdio se conectan mediante mcp-remote.
¿Sin clave que pegar? Un cliente compatible con OAuth se conecta solo con la URL: inicias sesión, eliges el negocio y apruebas. Esas conexiones solo gestionan tu catálogo, y puedes revocarlas cuando quieras en Configuración → Asistentes de IA.
Lo que pueden hacer los agentes
Todas las funciones del comercio, agrupadas.
Órdenes y facturas
Arma pedidos artículo por artículo con impuestos y envía un enlace de pago o un correo con tu marca, genera facturas Lightning o direcciones on-chain, consulta el estado de pago en tiempo real y sigue las entregas. Mira el recorrido de un pedido.
Checkout y solicitudes de pago
Abre sesiones de checkout alojadas y solicitudes de pago en una sola llamada, y luego da seguimiento a los pagos confirmados.
Productos y catálogo
Administra productos, tipos de producto y todo el catálogo, y crea enlaces de pago para enviar a tus clientes.
Webhooks
Crea, actualiza y elimina endpoints de webhook para que los agentes reaccionen a los eventos en tiempo real.
Cuenta y uso
Consulta el perfil del comercio, las billeteras conectadas, los documentos y el uso de tokens de API para monitorear por tu cuenta.
Acceso y planes
Verifica tokens de acceso para contenido restringido y consulta los planes de suscripción públicos sin autenticación.
Envía el enlace, no el dinero
Un agente que compra algo por ti no necesita una billetera ni tu tarjeta. Te envía el enlace de pago del comercio y tú pagas desde tu propia billetera.
1. El agente obtiene el enlace
Del comercio, de su sitio o del propio agente del comercio. Si le agrega .json a un enlace de SatsRail, el agente sabe para qué es, el precio y a quién se paga, sin abrir un checkout.
2. Te envía el enlace
En el chat, correo o app donde ya hablas con él. El enlace se muestra con el artículo, el precio y el nombre del comercio.
3. Pagas desde tu billetera
Ves el checkout, revisas el precio y pagas. El dinero va directo a la billetera del comercio. El agente nunca toca fondos ni datos de tarjeta.
¿Vendes? Tu propio agente crea el enlace con create_payment_link y te lo devuelve para enviarlo.
De una conversación a un pedido entregado
Tu agente arma el pedido, lo envía, ve que se pagó y lo hace llegar, con herramientas que ya tiene.
-
1
Arma el pedido
Dile a tu agente lo que quiere el cliente. Empieza un borrador con
create_ordery agrega cada artículo conadd_order_item: productos del catálogo o artículos sueltos, cada uno con su cantidad y su precio. Los impuestos se calculan por artículo con las reglas de tu catálogo. -
2
Envía un solo enlace
create_order_payment_linkdevuelve un enlace para todo el pedido, impuestos incluidos, para pegar en un chat o un mensaje. Osend_order_payment_emaillo envía por correo por ti, con tu logo, el resumen del pedido y un botón de Pagar. Las respuestas te llegan a ti. -
3
El cliente ve tus precios y paga en bitcoin
El enlace abre el pedido completo con precios en tu moneda. El monto en bitcoin se fija cuando hace clic en Pagar, al tipo de cambio de ese momento, y el pago va directo a tu billetera. Un pedido se paga una sola vez.
-
4
Tu agente lo confirma
get_ordermuestra el pedido pagado en cuanto llega el pago, así el agente te avisa a ti, o al cliente, enseguida. -
5
Y lo hace llegar
list_unfulfilled_ordersresponde “¿qué falta enviar?”, ymark_order_fulfilledregistra cada pedido como enviado, con su número de seguimiento, y luego como entregado.
Conversación de ejemplo
Tú: Ada quiere dos bolsas del café de la casa y un molino. Mándale la cuenta.
Agente: Pedido ORD-7F2A: 2 × Café de la casa $36.00, Molino $60.00, impuesto $1.80, total $97.80. Le envié a Ada el enlace de pago por correo. Vale por 24 horas.
Agente, más tarde: Ada pagó $97.80. Está esperando en tus pedidos por entregar.
Tú: Enviado, UPS 1Z999. → marcado como enviado, con el número de seguimiento.
Tú pones las reglas
Vencimiento del pedido
Elige cuánto tiempo se puede pagar un enlace, de 1 hora a 7 días. Después muestra que el pedido venció. Los precios quedan en tu moneda hasta que se hace clic en Pagar, así que un vencimiento largo nunca fija un tipo de cambio viejo.
Recordatorios automáticos
Ninguno, uno o dos correos de recordatorio a un cliente que no ha pagado: a mitad del plazo y poco antes del vencimiento. Nunca cuando el pedido ya está pagado, cancelado o vencido. Tu agente también puede enviar uno cuando se lo pidas.
Seguimiento de entregas
Pide una dirección de envío y un teléfono antes del pago, y deja los pedidos pagados en una lista de pedidos por entregar hasta que los marques como enviados y entregados. Tu agente ve la misma lista.
Pagos para agentes de IA
Por qué Lightning encaja con el software autónomo.
Leer la guía de inicio rápido →Conecta tu agente
Obtén una clave API, pega un bloque de configuración y tu agente podrá aceptar Bitcoin por Lightning u on-chain (acceso anticipado).