#CLI & MCP Server

Use Bloque from your AI agent. One command to set up, then just ask.

#Get Started

npx @bloque/cli setup

The wizard:

1. Logs you in (WhatsApp or Email OTP)
2. Finds your installed AI agents
3. Configures everything automatically

Restart your agent and you're ready.

Already have a JWT? Skip the OTP:

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

#What You Can Ask Your Agent

Once set up, just talk naturally:

• "Create a card for food expenses, load it with $200"
• "I need a one-time $25 card for this website"
• "Assign my card to amazon.com"
• "Which card should I use for netflix.com?"
• "Show me my balances and recent transactions"
• "Top up my account with 100,000 COP from my bank"
• "Freeze my card"
• "Create two cards that share the same budget"

Your agent handles the accounts, cards, transfers, and reporting behind the scenes.

#How It Works

The CLI installs an MCP server that gives your agent access to 44 financial tools — organized in two tiers:

• Workflows (14 tools) — high-level operations like "create a card" or "find my card for this website." One call does everything.
• Primitives (26 tools) — low-level control when you need it. One tool per SDK method.

Every card is a crypto card: it automatically gets a virtual account (holds the balance) and a Polygon address (receives USDC). Top up via crypto, PSE bank transfer, or internal transfer.

Amounts are always human-readable. Say "$50" for $50 USD or "100000" for 100,000 COP. No need to think about internal formats.

Spending restrictions use friendly names. Say "food" instead of MCC code 5411. Available categories: food, transport, ads, entertainment, health, shopping, travel, subscriptions.

#Commands

#bloque setup

#bloque login

OTP mode (default):

npx @bloque/cli login

API key mode (recommended for backend/CI):

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

Origin key mode (legacy):

npx @bloque/cli login --origin-key your-key --origin your-origin --alias @user

#bloque mcp

npx @bloque/cli mcp          # stdio (default)
npx @bloque/cli mcp --http   # HTTP on port 3100

#Supported Agents

#Download Binary (No Node.js Required)

If you don't have Node.js installed, download a standalone binary from GitHub Releases:

macOS / Linux:

# Download (replace PLATFORM with your target, e.g. darwin-arm64)
curl -fsSL https://github.com/bloque-app/sdk/releases/latest/download/bloque-PLATFORM -o bloque

# Make executable
chmod +x bloque

# Move to PATH
sudo mv bloque /usr/local/bin/bloque

# Run setup
bloque setup

macOS Gatekeeper: If macOS blocks the binary, run: xattr -d com.apple.quarantine /usr/local/bin/bloque

Windows:

Download bloque-windows-x64.exe from the release page, rename to bloque.exe, and add its directory to your PATH.

When running via the binary, bloque setup automatically configures your agents to use the binary path instead of npx.

#Manual Configuration

If you prefer to configure manually instead of using bloque setup:

1. Log in:

npx @bloque/cli login

2. Add this to your agent's MCP config:

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

3. Restart your agent.

#Tools Reference

#Workflows (14 tools)

High-level tools. One call handles multi-step operations.

#Primitives (30 tools)

Low-level tools. 1:1 with SDK methods for full control.

#Requirements

• Via npm: Node.js 22+ or Bun 1+
• Via binary: No runtime needed — download from GitHub Releases
• A Bloque account