@stellect/cli

Command-line interface for Stellect — the agent payment gateway for Stellar.

Smart routing between x402 and MPP. Real USDC payments from your terminal.

Install

npm install -g @stellect/cli

Or use directly with npx:

npx @stellect/cli pay /api/weather?city=Istanbul

Commands

Pay for a service

# Auto-detect protocol (default)
stellect pay /api/weather?city=Istanbul

# Output:
#   ✓ Weather API · $0.001 USDC
#   ✓ x402 (Coinbase) — auto-detected
#   ✓ Allowed · $0.008 / $10.00 daily
#   ✓ Signed · key wiped
#   ✓ Settled in 5.2s
#
#   ─── TRANSACTION ───────────────────
#   Amount          $0.001 USDC
#   Protocol        x402 (auto)
#   Tx Hash         e76347990b09...d96
#   Explorer        https://stellar.expert/explorer/testnet/tx/...
#
#   ← 200 OK
#   { "city": "Istanbul", "temp": 22 }

# Force a specific protocol
stellect pay /api/weather?city=Tokyo --protocol x402
stellect pay /api/crypto-price?symbol=XLM --protocol mpp

Check wallet balance

stellect balance

# Output:
#   ─── AGENT WALLET ──────────────────
#   Address         GBOW6F2G...JSFN
#   Network         Stellar testnet
#   Encryption      AES-256-GCM
#   Status          ● Active
#
#   ─── BALANCE ───────────────────────
#   USDC            101.93
#   XLM             9,899.99

List available services

stellect services

# Output:
#   Service              Price       Protocol  Endpoint
#   ──────────────────────────────────────────────────
#   Weather API          $0.001      x402      /api/weather
#   Crypto Price Feed    $0.002      MPP       /api/crypto-price

View payment history

stellect history
stellect history --limit 5

Initialize a wallet

stellect init
stellect init --name my-agent --network testnet

Configuration

Set the API endpoint via environment variable:

export STELLECT_API_URL=https://api.stellect.xyz

Or pass it per command:

stellect balance --api https://api.stellect.xyz

Part of the Stellect SDK

| Package | Description | |---------|-------------| | @stellect/core | Smart routing engine | | @stellect/wallet | Wallet interface | | @stellect/wallet-native | AES-256-GCM keystore | | @stellect/mcp-server | Claude Desktop integration | | @stellect/cli | This package |

Links

• Live Demo
• GitHub
• Demo Video

License

MIT