@boltzpay/cli
v0.3.2
Published
CLI for BoltzPay — fetch paid APIs from the terminal
Maintainers
Readme
@boltzpay/cli
CLI for BoltzPay — fetch, diagnose, and discover paid APIs from your terminal. Supports x402, L402, and MPP protocols. Also serves as the Python bridge for LangChain and CrewAI integrations.
Install
npm install -g @boltzpay/cliOr run without installing:
npx @boltzpay/cli <command>Requires Node.js >= 20.
Quick Start
# Discover MPP endpoints with a trust score above 70
boltzpay discover --protocol mpp --min-score 70 --query weather
# Get a price quote (no keys needed)
boltzpay quote https://invy.bot/api
# Diagnose protocol, format, and health
boltzpay diagnose https://invy.bot/api
# Fetch and pay (requires wallet credentials)
export COINBASE_API_KEY_ID="your-key-id"
export COINBASE_API_KEY_SECRET="your-key-secret"
export COINBASE_WALLET_SECRET="your-wallet-secret"
boltzpay fetch https://invy.bot/apiCommands
| Command | Description | Requires Keys |
|---------|-------------|:-------------:|
| fetch <url> | Fetch a paid API endpoint and pay automatically | Yes |
| quote <url> | Get price quote without paying | No |
| diagnose <url> | Diagnose endpoint — protocol, format, scheme, health | No |
| discover | Browse paid API endpoints from the BoltzPay registry | No |
| budget | Show remaining spending budget | No |
| history | Show payment history for this session | No |
| wallet | Show wallet status, connectivity, and configuration | No |
| demo | Interactive walkthrough of BoltzPay features | No |
discover
Registry-backed discovery. Searches the BoltzPay trust registry (6,900+ endpoints, 400+ providers).
boltzpay discover # List all endpoints
boltzpay discover --protocol mpp --min-score 70 # MPP endpoints, score >= 70
boltzpay discover --query weather # Search by name, URL, or description
boltzpay discover -c finance -p x402 # x402 endpoints in finance category| Flag | Description |
|------|-------------|
| -p, --protocol <protocol> | Filter by protocol: x402, l402, or mpp |
| --min-score <score> | Minimum trust score (0-100) |
| -q, --query <query> | Search by name, URL, or description |
| -c, --category <category> | Filter by category |
fetch
boltzpay fetch https://api.example.com/data
boltzpay fetch https://api.example.com/data -m POST -d '{"q":"test"}'
boltzpay fetch https://api.example.com/data -H "Accept:application/json" -c evm| Flag | Description |
|------|-------------|
| -m, --method <method> | HTTP method (default: GET) |
| -H, --header <header...> | HTTP headers as key:value |
| -d, --data <body> | Request body |
| -c, --chain <chain> | Override chain selection: evm or svm |
demo
boltzpay demo # Interactive walkthrough
boltzpay demo -y # Skip payment confirmation
boltzpay demo --testnet # Force testnet endpointGlobal Flags
| Flag | Description |
|------|-------------|
| --json | Output as JSON (for scripting and Python bridge) |
| --verbose | Show additional details |
| --debug | Show debug information (headers, timing) |
Python Bridge
The CLI serves as a bridge for Python frameworks. LangChain and CrewAI integrations call npx @boltzpay/cli <command> --json under the hood.
pip install langchain-boltzpay # LangChain integration
pip install boltzpay-crewai # CrewAI integrationLinks
- Documentation
- BoltzPay Registry
- GitHub
- SDK
- MCP Server — for Claude Desktop
Part of BoltzPay
This package is part of the BoltzPay open-source SDK — giving AI agents the ability to pay for APIs automatically.
License
MIT
