Integración con Cursor

Cursor ejecuta @burnbound/mcp como un servidor MCP stdio local configurado en un archivo mcp.json. Una vez añadido, el agente de Cursor puede pagar APIs x402 y MPP con fetch_paid, reembolsar cargos de Stripe a través de tu gateway de acciones con stripe_refund y consultar su presupuesto con get_budget, y Burnbound comprueba cada pago o reembolso contra la política del agente antes de que se mueva el dinero. Configuración según la documentación de MCP de Cursor.

¿Dónde va la configuración?

Usa el archivo global para un único agente que usas en todas partes, y el archivo de proyecto cuando cada repositorio deba pagar como su propio agente de Burnbound, con sus propios topes y su propia auditoría.

Añade el servidor

Necesitas Node.js 20 o posterior y una clave del agente (bb_agent_…) del panel de Burnbound. Añade esto al archivo, o fusiona la entrada burnbound en un objeto mcpServers que ya exista:

{
  "mcpServers": {
    "burnbound": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@burnbound/mcp@latest"],
      "env": {
        "BURNBOUND_KEY": "bb_agent_…"
      }
    }
  }
}

command tiene que estar en el PATH del sistema o ser una ruta completa. Si Cursor no encuentra npx, ejecuta which npx (macOS, Linux) o where npx (Windows) en una terminal y usa esa ruta como command.

Deja la clave fuera del repositorio

Es fácil hacer commit por error de un .cursor/mcp.json de proyecto. Cursor puede leer la clave del entorno, con ${env:NAME}:

{
  "mcpServers": {
    "burnbound": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@burnbound/mcp@latest"],
      "env": {
        "BURNBOUND_KEY": "${env:BURNBOUND_KEY}"
      }
    }
  }
}

La variable tiene que estar definida en el entorno con el que arranca Cursor, por ejemplo exportándola en el perfil de tu shell y abriendo el proyecto desde esa shell. Si la clave acaba vacía, el servidor termina con BURNBOUND_KEY is required.

Comprueba que funciona

1. Abre Customize en la barra lateral de Cursor y comprueba que burnbound aparece y está activado. Si editaste mcp.json con Cursor abierto y no aparece, reinicia Cursor.
2. En el chat del agente, pregunta: "¿Cuál es mi presupuesto de Burnbound?". El agente llama a get_budget y muestra el tope diario, lo que queda y los hosts permitidos.

Para obtener una versión nueva de @burnbound/mcp, reinicia el servidor MCP: en Cursor, Settings → MCP, y reinicia burnbound. Con @latest, npx busca la versión más reciente cuando arranca el servidor.

Si el servidor falla, abre el panel Output (Cmd+Shift+U en macOS, Ctrl+Shift+U en los demás) y elige MCP Logs en el desplegable. El servidor escribe ahí sus errores de arranque:

Primera llamada de pago

Añade el host de un vendedor a los hosts permitidos del agente y pregúntale al agente. Por ejemplo, con CoinGecko (pro-api.coingecko.com, 0.01 USDC por llamada en Base la última vez que lo verificamos):

Use fetch_paid to GET
https://pro-api.coingecko.com/api/v3/x402/onchain/search/pools?query=weth&network=eth
with maxAmountUsd "0.02".

El resultado es paid, con el importe, la transacción y el cuerpo de la respuesta, marcado como no fiable. Tienes más vendedores verificados, con sus hosts y precios, en el catálogo de APIs x402, y el agente puede buscar en él con search_paid_apis.

Cursor ejecuta comandos de shell: elige el modo de cartera teniéndolo en cuenta

El agente de Cursor puede ejecutar comandos de terminal. Con la firma en el cliente, la clave de la cartera está en la misma máquina, y un agente que ejecuta comandos con tu usuario podría leerla y firmar fuera de Burnbound. Para un agente que ejecuta comandos por su cuenta, conecta en su lugar una cartera de Coinbase CDP: así el agente no tiene nada con lo que firmar. Consulta Carteras de agente: Coinbase CDP o una clave local.

Relacionado

• Primeros pasos: del registro al primer pago.
• Servidor MCP x402: configuración para Claude Code y Cursor: qué hacen las ocho herramientas.
• Referencia de las herramientas MCP: cada entrada, resultado y código de error.