bsl-agent-mcp

Servidor MCP que permite a un agente de IA (Claude Desktop, Claude Code o cualquier cliente MCP) operar una cartera propiedad del usuario en la testnet de Bitcoin-IPC: depositar BTC L1 en subnet1, pagar wBTC dentro de subnet1 o a través de subnet2, y obtener el recibo anclado a Bitcoin de cualquier pago. El agente nunca posee las claves; solo puede solicitar operaciones; el servidor firma localmente y rechaza cualquier depósito o pago superior a SPEND_CAP_SATS hasta que el usuario lo apruebe explícitamente (confirmed=true).

Aviso legal: este código no está auditado y está pensado únicamente para uso en testnet. No lo utilices con fondos de mainnet ni con claves que controlen valor real.

Herramientas

Requisitos

Un contenedor bsl-client en ejecución —la imagen pública es ghcr.io/bitcoinscalinglabs/bsl-client:testnet— con su archivo de configuración bsl.env, que también debe contener AGENT_PRIVATE_KEY (la clave EVM desde la que paga el servidor).

Ejecutar con Docker

La imagen se ejecuta junto a bsl-client y comparte su red; el entrypoint genera la configuración de ipc-cli, importa AGENT_PRIVATE_KEY, ejecuta comprobaciones de conectividad y queda en reposo.

docker build -t ghcr.io/bitcoinscalinglabs/bsl-agent-mcp:testnet .

docker run -d --env-file ./bsl.env \
  --network container:bsl-client \
  --name bsl-agent-mcp \
  ghcr.io/bitcoinscalinglabs/bsl-agent-mcp:testnet
docker logs bsl-agent-mcp   # should end with "bsl-agent-mcp ready"

Claude Desktop asocia sesiones MCP al contenedor en ejecución:

{
  "mcpServers": {
    "bsl-payments": {
      "command": "docker",
      "args": ["exec", "-i", "bsl-agent-mcp", "node", "/app/dist/index.js"]
    }
  }
}

Ejecutar desde el código fuente (desarrollo)

Node.js ≥ 20. El contenedor bsl-client debe publicar el puerto del proveedor (-p 127.0.0.1:3030:3030) y tener la clave del agente importada una vez:

docker exec bsl-client ipc-cli wallet import --wallet-type evm --private-key <key>

npm install && npm run build
cp .env.example .env        # fill in

Configuración de Claude Desktop: "command": "node", "args": ["/ABS/PATH/bsl-agent-mcp/dist/index.js"]. La configuración proviene del .env del repositorio; un bloque env en la configuración de Desktop tiene prioridad.

Configuración

Notas

• Los importes están en satoshis en todas partes (1 BTC = 100,000,000 sats); wBTC tiene 18 decimales y el servidor convierte internamente.

• Los destinatarios son o beneficiarios de la libreta de direcciones incorporada o direcciones proporcionadas por el usuario; se instruye al agente a no inventar nunca una dirección.