---
title: "BlindPay CLI"
description: "The official CLI for BlindPay, the most AI-native stablecoin infrastructure. Manage payouts, payins, customers, and bank accounts from your terminal. Built for developers and AI agents alike with structured JSON output, schema introspection, and predictable exit codes."
date: "2026-03-06"
categories: ["product", "engineering", "guide"]
author: "Alves"
thumbnail: "/images/blog/cli.png"
isBlog: true
---

![BlindPay CLI](/images/blog/cli.png)

BlindPay is the most AI-native stablecoin infrastructure available today. Every layer of the platform, the API, the [MCP Server](/blog/mcp), the [Agent Skills](/blog/agent-skills), and now the CLI, is built so that AI agents and developers can operate global payment infrastructure with equal ease. No other stablecoin platform offers this depth of integration.

The BlindPay CLI brings the full power of that infrastructure to your terminal. You or any AI agent can manage customers, execute payouts, create virtual accounts and configure webhooks without leaving your shell. It works for developers typing commands by hand, and it works just as well for AI agents like Claude, Codex, and automation scripts that need structured, predictable output.

## Installation

Install globally with npm:

```bash
npm install -g @blindpay/cli
```

Or run without installing:

```bash
npx @blindpay/cli <command>
```

## Setup

Grab your API key and instance ID from the [BlindPay dashboard](https://app.blindpay.com) and configure:

```bash
blindpay config set --api-key <your-api-key> --instance-id <your-instance-id>
```

## What You Can Do

The CLI covers the full BlindPay API surface. Every command supports `--help` for usage details and `--json` for machine-readable output.

### Customers and Bank Accounts

Create and manage customers, attach bank accounts across multiple rails (ACH, Wire, PIX, SPEI, SWIFT), and configure blockchain wallets.

```bash
blindpay customers create
blindpay bank_accounts create --customer-id re_...
blindpay blockchain_wallets create --customer-id re_...
```

### Payouts and Payins

Generate quotes with real-time FX rates, then execute payouts and payins in a single flow.

```bash
blindpay quotes create
blindpay payouts create --quote-id qu_...
blindpay payin_quotes create
blindpay payins create --quote-id qu_...
```

### Virtual Accounts and Offramp Wallets

Create virtual accounts for receiving payments and list offramp wallets for on-chain settlement.

```bash
blindpay virtual_accounts create --customer-id re_...
blindpay offramp_wallets list --customer-id re_... --bank-account-id ba_...
```

### Webhooks, API Keys, and Partner Fees

Configure webhook endpoints, manage API keys, and set up partner fees directly from the CLI.

```bash
blindpay webhook_endpoints create
blindpay api_keys list
blindpay partner_fees create
```

### Reference Data

Check supported payment rails and the bank detail fields required for each one.

```bash
blindpay available rails
blindpay available bank_details --rail pix
```

## Built for Humans and AI Agents

The CLI is designed from the ground up to be used by both humans and AI agents. If you use Claude, Codex, or any LLM-based coding assistant, they can run BlindPay CLI commands directly as part of their workflow.

What makes it agent-friendly:

- **`--json` flag** on every command returns structured JSON output that agents can parse without guessing
- **`blindpay schema`** returns full field definitions, types, defaults, and enums as JSON, so an agent can discover the API surface and build valid commands without external documentation
- **Predictable exit codes**: `0` for success, `1` for user error, `2` for API error
- **Structured errors** when `--json` is active:

```json
{ "error": true, "message": "...", "exitCode": 2, "statusCode": 401 }
```

An AI agent can install the CLI, run `blindpay schema` to understand what resources and fields are available, then construct and execute commands autonomously. Combined with the [MCP Server](/blog/mcp) for direct tool-use and [Agent Skills](/blog/agent-skills) for domain knowledge, BlindPay gives agents a complete integration surface that no other stablecoin platform provides.

## Updating

```bash
npm install -g @blindpay/cli@latest
```

## Get Started

Install the CLI and connect it to your BlindPay instance in under a minute:

```bash
npm install -g @blindpay/cli
blindpay config set --api-key <your-api-key> --instance-id <your-instance-id>
blindpay customers list --json
```

Source code and full command reference are available on [GitHub](https://github.com/blindpaylabs/blindpay-cli).