CLI for the mōdus x402 facilitator and marketplace.
npm install -g modus-cli
modus-cli statusUSD₮ has brought digital payments to 500m+ people. mōdus brings it to AI agents and machine commerce, powering the agentic economy. It operates an x402 facilitator and marketplace on Stable, enabling verifiable, non-custodial per-request payments for APIs, inference, and services.
This CLI lets you interact with the mōdus facilitator and marketplace:
- Pay for APIs and services per-request through x402
- Search the marketplace for available sellers and services
- Register your own x402-enabled service as a seller
- Scaffold a seller server with pre-configured x402 support
| Command | Description |
|---|---|
init |
Initialize the CLI and check facilitator connectivity |
status |
Check facilitator and network status |
search [query] |
Search marketplace sellers |
pay <endpoint> |
Pay and call an x402 endpoint |
register <origin> |
Register a seller origin |
create-server [dir] |
Scaffold a seller server (--template bun|node) |
wallet [set|show|clear] |
Manage wallet configuration |
# Check the facilitator
modus-cli status
# Search available services
modus-cli search
# Preview the cost of a request (no payment sent)
PRIVATE_KEY=0x... modus-cli pay --dry-run https://api.moduscommerce.xyz/hello-service/hello- Node.js 18+
- A wallet with USDT0 on Stable Mainnet (chain ID 988)
| Variable | Default | Description |
|---|---|---|
PRIVATE_KEY |
— | EVM private key for signing x402 payments (0x-prefixed) |
MIT