Skip to main content
Create services and paywalls, share payment URLs, and monitor transactions — all from your terminal. The same surface is available to agents via skills and MCP. Default CLI output is TOON (Incur). Pass --format json whenever you want JSON (including the samples in these docs).

​
What you can do

Prices are USDC base-unit strings (1000000 = $1.00, 10000 = $0.01). Exact and Tiered paywalls are supported — see the create flow below.

​
Seller path

1

Authenticate

Create a console API key, then log in with proceeds auth login. See Authentication.
2

Create a service

Wrap an upstream API with proceeds services create --file service.json.
3

Create an Exact paywall

Price a single route with flags or --file (pricingMode: exact).
4

Create a Tiered paywall

Use --file for nested priceTiers (pricingMode: tiered).
5

Share payment URLs

Construct x402 and MPP URLs from the service ID and paywall slug — they are not returned in create responses.
6

Manage and monitor

List and update services and paywalls, then run proceeds transactions list and proceeds events list. See Services, Paywalls, and Transactions and events.

​
Agent integrations

Wire the CLI into your agent stack:

Install

Node 22+, global npm, or npx.

Authentication

API keys, profiles, and CI.

Services

List, update, and delete services.

Paywalls

Manage paywalls and share URLs.

Transactions and events

Monitor payments and request events.