#CLI y Servidor MCP

Usa Bloque desde tu agente de IA. Un comando para configurar, luego solo pide.

#Comenzar

npx @bloque/cli setup

El asistente:

1. Te autentica (OTP por WhatsApp o Email)
2. Detecta tus agentes de IA instalados
3. Configura todo automáticamente

Reinicia tu agente y listo.

¿Ya tienes un JWT? Sáltate el OTP:

npx @bloque/cli setup --jwt eyJhbGciOi...

#Qué Puedes Pedirle a Tu Agente

Una vez configurado, solo habla naturalmente:

• "Crea una tarjeta para gastos de comida, cárgale $200"
• "Necesito una tarjeta desechable de $25 para este sitio web"
• "Asigna mi tarjeta a amazon.com"
• "¿Qué tarjeta debo usar para netflix.com?"
• "Muéstrame mis saldos y transacciones recientes"
• "Carga 100,000 COP de mi banco a mi cuenta"
• "Congela mi tarjeta"
• "Crea dos tarjetas que compartan el mismo presupuesto"

Tu agente maneja las cuentas, tarjetas, transferencias y reportes detrás de escena.

#Cómo Funciona

La CLI instala un servidor MCP que le da a tu agente acceso a 40 herramientas financieras — organizadas en dos niveles:

• Workflows (14 herramientas) — operaciones de alto nivel como "crear una tarjeta" o "buscar mi tarjeta para este sitio web." Una llamada hace todo.
• Primitivas (30 herramientas) — control de bajo nivel cuando lo necesitas. Una herramienta por método del SDK.

Cada tarjeta es una tarjeta crypto: automáticamente obtiene una cuenta virtual (guarda el saldo) y una dirección Polygon (recibe USDC). Recarga vía crypto, transferencia bancaria PSE, o transferencia interna.

Los montos siempre son legibles. Di "$50" para $50 USD o "100000" para 100,000 COP. Sin formatos internos.

Las restricciones de gasto usan nombres amigables. Di "food" en vez del código MCC 5411. Categorías disponibles: food, transport, ads, entertainment, health, shopping, travel, subscriptions.

#Comandos

#bloque setup

#bloque login

Modo OTP (por defecto):

npx @bloque/cli login

Modo API key (recomendado para backend/CI):

npx @bloque/cli login --api-key sk_live_...

Modo clave de origen (heredado):

npx @bloque/cli login --origin-key tu-clave --origin tu-origen --alias @usuario

#bloque mcp

npx @bloque/cli mcp          # stdio (por defecto)
npx @bloque/cli mcp --http   # HTTP en puerto 3100

#Agentes Soportados

#Descargar Binario (Sin Node.js)

Si no tienes Node.js instalado, descarga un binario independiente desde GitHub Releases:

macOS / Linux:

# Descargar (reemplaza PLATFORM con tu plataforma, e.g. darwin-arm64)
curl -fsSL https://github.com/bloque-app/sdk/releases/latest/download/bloque-PLATFORM -o bloque

# Hacer ejecutable
chmod +x bloque

# Mover al PATH
sudo mv bloque /usr/local/bin/bloque

# Ejecutar setup
bloque setup

macOS Gatekeeper: Si macOS bloquea el binario, ejecuta: xattr -d com.apple.quarantine /usr/local/bin/bloque

Windows:

Descarga bloque-windows-x64.exe de la página de releases, renómbralo a bloque.exe y agrega su directorio a tu PATH.

Cuando ejecutas desde el binario, bloque setup configura automáticamente tus agentes para usar la ruta del binario en vez de npx.

#Configuración Manual

Si prefieres configurar manualmente en vez de usar bloque setup:

1. Inicia sesión:

npx @bloque/cli login

2. Agrega esto al archivo de configuración MCP de tu agente:

{
  "mcpServers": {
    "bloque": {
      "command": "npx",
      "args": ["-y", "@bloque/cli", "mcp"]
    }
  }
}

3. Reinicia tu agente.

#Referencia de Herramientas

#Workflows (14 herramientas)

Herramientas de alto nivel. Una llamada maneja operaciones de múltiples pasos.

#Primitivas (30 herramientas)

Herramientas de bajo nivel. 1:1 con métodos del SDK para control total.

#Requisitos

• Vía npm: Node.js 22+ o Bun 1+
• Vía binario: No necesitas runtime — descarga desde GitHub Releases
• Una cuenta en Bloque