bridgerton

CLI and MCP server for Bridge.xyz stablecoin infrastructure.

Install

npm install -g bridgerton

Or run directly:

npx bridgerton --help

Setup

On first run with no arguments, bridgerton prompts for your API key interactively. Or configure it explicitly:

bridgerton configure api-key sk-test-...

You can also set it via environment variable:

export BRIDGE_API_KEY=sk-test-...

Environment is auto-detected from the key prefix — sk-test-* routes to sandbox, sk-live-* to production.

Usage

# check exchange rates
bridgerton rates --from usd --to usdc

# list customers
bridgerton customers list

# create a customer
bridgerton customers create -f John -l Doe -e john@example.com

# create a wallet on tempo
bridgerton wallets create <customer-id> --chain tempo

# create a liquidation address
bridgerton liquidation create <customer-id> \
  --chain tempo --currency usdc \
  --destination-address 0x...

# create a transfer
bridgerton transfers create \
  --on-behalf-of <customer-id> \
  --source-rail bridge_wallet --source-currency usdc \
  --dest-rail tempo --dest-currency usdc \
  --dest-address 0x...

# set default output format
bridgerton configure format json

Commands

Group	Commands
customers	create, get, list, update, delete, tos-link, kyc-link, tos-acceptance-link, transfers
wallets	create, get, list, list-all, total-balances, history
transfers	create, get, list
liquidation	create, get, list, update, drains, all-drains
external-accounts	create, get, list, delete
virtual-accounts	create, get, list, list-all, update, deactivate, reactivate, activity, all-activity
prefunded-accounts	list, get, history
configure	api-key, format, show
rates	Get current exchange rates

All commands support --format toon|json|yaml|md|jsonl and --help.

Agent Setup

Give your AI agent (Claude Code, Amp, Cursor, Copilot, etc.) full access to Bridge.xyz:

npx bridgerton mcp add      # register as MCP server — gives agents direct tool access
npx bridgerton skills add   # install skill files — gives agents context on available commands

That's it. Your agent can now run commands like "create a wallet on tempo for a customer" or "list all transfers".

You can also run the MCP server directly in stdio mode:

bridgerton --mcp

Development

bun install
bun run build        # tsc + chmod
bun run typecheck    # tsc --noEmit

Built with

incur — one CLI router that gives you a CLI, MCP server, and agent skills for free.

License

MIT