SDK
Burnbound tiene un cliente de TypeScript con payFetch y wrapFetchWithPayment, pero todavía no está publicado en npm. Hoy no hay ningún paquete que instalar. Para dar ya a un agente acceso de pago a APIs x402, usa el servidor MCP @burnbound/mcp, que lleva dentro este mismo cliente.
¿Hay un SDK de JavaScript o TypeScript que pueda instalar?
Todavía no. El cliente que paga APIs x402 bajo una política de Burnbound lo usa internamente @burnbound/mcp, pero no se ha publicado como paquete público de npm, así que no hay ningún nombre de paquete que instalar. Cuando se publique, esta página explicará cómo instalarlo.
Mientras tanto:
- Para agentes en Claude Code, Cursor u otro cliente MCP, instala el servidor MCP. Consulta Primeros pasos.
- Para frameworks de agentes que admiten herramientas MCP, conecta
npx -y @burnbound/mcp@latestcomo servidor MCP stdio, conBURNBOUND_KEYen su entorno.
¿Qué hará el SDK?
El SDK ofrece un fetch que paga x402 bajo tu política de Burnbound. Sigue el mismo flujo que fetch_paid: ante un HTTP 402 pide a Burnbound que autorice el pago, hace que lo firme tu cartera, reintenta la petición una vez con el pago e informa del recibo. La interfaz de abajo es la actual y puede cambiar antes de publicarse.
wrapFetchWithPayment(options)devuelve un sustituto directo defetch. Un pago denegado o que espera una aprobación lanza un error que lleva la decisión de Burnbound; un pago que el vendedor no sirvió lanzaPaymentRejectedError.payFetch(options, input, init)hace un intento de compra y devuelve qué ha pasado:free(no hacía falta pagar),paid(el vendedor sirvió la petición pagada con un 2xx; conintentId,idempotencyKey,mode,replayedy el recibo),rejected(el pago se envió pero el vendedor respondió otra cosa, como otro 402; conhttpStatusy elreasondel vendedor),denied(con los códigos de motivo) ostep_up(con elapprovalIdque hay que consultar). Ninguno de los dos firma un pago dos veces por su cuenta.
Los dos reciben la URL base de la API de Burnbound, la clave del agente, el id del agente y, para la firma en el cliente, un firmador. Igual que el servidor MCP, envían la clave solo a la API de Burnbound, nunca al vendedor, y nunca siguen una redirección después de pagar.
¿Espero al SDK o uso el servidor MCP?
Usa el servidor MCP salvo que necesites pagar desde tu propio código fuera de un cliente MCP. Está publicado, añade protecciones en el cliente que un simple envoltorio de fetch no tiene (los hosts permitidos se comprueban antes de cualquier petición, las direcciones privadas se bloquean, las respuestas del vendedor se marcan como no fiables y la clave se mantiene fuera de los resultados de las herramientas) y funciona con cualquier cliente MCP.