@blaze-money/cli

Payments infrastructure for modern businesses. SDK, CLI, MCP server, and AI agent — all in one package.

Quick Start

npm install -g @blaze-money/cli
blaze auth
# Opens browser for authentication
blaze balance

{
  "object": "balance",
  "available": 10250.00,
  "pending": 500.00,
  "currency": "USD"
}

SDK

Use Blaze programmatically in any Node.js or TypeScript project.

import { BlazeClient } from "@blaze-money/cli"

const client = new BlazeClient({ apiKey: "sk_test_..." })

// Check balance
const balance = await client.getBalance()

// Create a customer
const customer = await client.createCustomer({
  email: "maria@example.com",
  first_name: "Maria",
  last_name: "Santos",
})

// Send a transfer
const transfer = await client.createTransfer({
  amount: 500,
  currency: "USD",
  customer_id: customer.id,
})

// Get an FX quote
const quote = await client.createFxQuote({
  from_currency: "USD",
  to_currency: "MXN",
  amount: 500,
})

Every method returns typed responses. Errors throw typed exceptions (BlazeAuthenticationError, BlazeValidationError, etc.) so you always know what went wrong.

See docs/sdk.md for the full SDK reference.

CLI

A complete command-line interface for your Blaze account.

Global Flags

--api-key     Override the API key for a single command
--base-url    Point to a different Blaze API environment
--format      Output format: json | table (default: json)

See docs/cli.md for detailed usage and examples.

AI-Native Payments

Give Claude, Cursor, or any MCP-compatible AI assistant the ability to manage payments, customers, and transfers.

Setup for Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "blaze": {
      "command": "npx",
      "args": ["-y", "@blaze-money/cli", "mcp"],
      "env": {
        "BLAZE_API_KEY": "sk_test_..."
      }
    }
  }
}

That's it. Your AI assistant now has full access to the Blaze API.

Setup for Claude Code

claude mcp add blaze -- npx -y @blaze-money/cli mcp

Then set your API key as an environment variable:

export BLAZE_API_KEY="sk_test_..."

Or add the server to your project's .claude/settings.json:

{
  "mcpServers": {
    "blaze": {
      "command": "npx",
      "args": ["-y", "@blaze-money/cli", "mcp"],
      "env": {
        "BLAZE_API_KEY": "sk_test_..."
      }
    }
  }
}

Setup for Codex

BLAZE_API_KEY="sk_test_..." codex --full-auto \
  --mcp-config '{"blaze":{"command":"npx","args":["-y","@blaze-money/cli","mcp"]}}'

Or create an mcp.json file in your project root:

{
  "blaze": {
    "command": "npx",
    "args": ["-y", "@blaze-money/cli", "mcp"],
    "env": {
      "BLAZE_API_KEY": "sk_test_..."
    }
  }
}

Then reference it when running Codex:

codex --full-auto --mcp-config mcp.json

72 Tools Available

Balance — blaze_get_balance, blaze_whoami

Customers — blaze_list_customers, blaze_get_customer, blaze_create_customer, blaze_update_customer, blaze_archive_customer

External Accounts — blaze_list_external_accounts, blaze_create_external_account, blaze_delete_external_account

Transfers — blaze_list_transfers, blaze_get_transfer, blaze_create_transfer

Withdrawals — blaze_list_withdrawals, blaze_get_withdrawal, blaze_create_withdrawal

Payment Links — blaze_list_payment_links, blaze_get_payment_link, blaze_create_payment_link, blaze_update_payment_link, blaze_cancel_payment_link

Virtual Accounts — blaze_list_virtual_accounts, blaze_get_virtual_account, blaze_create_virtual_account

Transactions — blaze_list_transactions, blaze_get_transaction

Team Members — blaze_list_team_members, blaze_list_pending_invitations, blaze_invite_team_member, blaze_update_member_role

Webhooks — blaze_list_webhooks, blaze_get_webhook, blaze_create_webhook, blaze_update_webhook, blaze_delete_webhook

Analytics — blaze_get_analytics_overview

Disputes — blaze_list_disputes, blaze_get_dispute, blaze_submit_dispute_evidence, blaze_close_dispute

Invoices — blaze_list_invoices, blaze_get_invoice, blaze_create_invoice, blaze_send_invoice, blaze_mark_invoice_paid, blaze_void_invoice

Subscriptions — blaze_list_subscriptions, blaze_get_subscription, blaze_create_subscription, blaze_cancel_subscription, blaze_pause_subscription, blaze_resume_subscription

FX — blaze_get_fx_rates, blaze_create_fx_quote

Insights — blaze_get_spending_summary, blaze_list_bank_transactions, blaze_get_bank_balances

Bills (AP Automation) — blaze_list_bills, blaze_get_bill, blaze_create_bill, blaze_update_bill, blaze_approve_bill, blaze_reject_bill, blaze_quote_bill_payment, blaze_pay_bill, blaze_list_bills_activity_log, blaze_list_connected_accounts, blaze_connect_bank_account, blaze_connect_gmail, blaze_disconnect_gmail, blaze_list_extracted_invoices, blaze_create_bill_from_invoice, blaze_get_bill_payment_methods, blaze_set_bill_payment_policy

Convenience — blaze_send_money

How It Works

Your AI Assistant  <-->  stdio  <-->  Blaze MCP Server  <-->  Blaze REST API

The MCP server communicates over standard input/output using the Model Context Protocol, giving any compatible AI client structured access to the full Blaze API surface.

See docs/mcp.md for integration guides and advanced configuration.

Agent Mode

Natural language interface for common payment operations.

blaze agent "send $500 to maria@example.com"

[>>>] Looking up customer: maria@example.com
[ ->] Customer found: Maria Santos (cust_abc123)
[>>>] Checking external accounts...
[ ->] Using account: us_bank ending in 4567
[>>>] Creating transfer: $500.00 USD
[ OK] Transfer created!
{
  "id": "txn_xyz789",
  "status": "pending_approval",
  "amount": 500,
  "currency": "USD"
}

Works for any operation:

blaze agent "check balance"
blaze agent "list transactions 5"

See docs/agent.md for supported commands and customization.

Authentication

Three methods, in order of precedence:

Test mode — Keys starting with sk_test_ hit the sandbox environment. No real money moves.

Live mode — Keys starting with sk_live_ hit the production API. Handle with care.

See docs/authentication.md for setup instructions.

Supported Currencies

Error Handling

All errors are typed and predictable.

import { BlazeClient, BlazeValidationError } from "@blaze-money/cli"

try {
  await client.createCustomer({ email: "invalid" })
} catch (err) {
  if (err instanceof BlazeValidationError) {
    console.error(err.errors) // { email: ["Invalid email format"] }
  }
}

Contributing

We welcome contributions. Please see CONTRIBUTING.md for guidelines on how to get started.

License

MIT — see LICENSE for details.