> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myproceeds.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Proceeds CLI

> Manage Proceeds services, paywalls, transactions, and events from your terminal or AI agent.

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

| Area             | Commands                                          |
| ---------------- | ------------------------------------------------- |
| **Auth**         | `login`, `logout`, `profiles`, `status`, `switch` |
| **Services**     | `create`, `get`, `list`, `update`, `delete`       |
| **Paywalls**     | `create`, `get`, `list`, `update`, `delete`       |
| **Transactions** | `list`                                            |
| **Events**       | `list`                                            |
| **Health**       | `health`                                          |
| **Integrations** | `skills`, `mcp`, `completions`                    |

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

<Steps>
  <Step title="Authenticate">
    Create a console API key, then log in with `proceeds auth login`. See [Authentication](/cli/authentication).
  </Step>

  <Step title="Create a service">
    Wrap an upstream API with `proceeds services create --file service.json`.
  </Step>

  <Step title="Create an Exact paywall">
    Price a single route with flags or `--file` (`pricingMode: exact`).
  </Step>

  <Step title="Create a Tiered paywall">
    Use `--file` for nested `priceTiers` (`pricingMode: tiered`).
  </Step>

  <Step title="Share payment URLs">
    Construct **x402** and **MPP** URLs from the service ID and paywall slug — they are not returned in create responses.
  </Step>

  <Step title="Manage and monitor">
    List and update services and paywalls, then run `proceeds transactions list` and `proceeds events list`. See [Services](/cli/services), [Paywalls](/cli/paywalls), and [Transactions and events](/cli/transactions).
  </Step>
</Steps>

## Agent integrations

Wire the CLI into your agent stack:

```bash theme={null}
proceeds skills add
proceeds mcp add
proceeds completions --help
```

## Related

<CardGroup cols={2}>
  <Card title="Install" icon="download" href="/cli/install">
    Node 22+, global npm, or npx.
  </Card>

  <Card title="Authentication" icon="key" href="/cli/authentication">
    API keys, profiles, and CI.
  </Card>

  <Card title="Services" icon="server" href="/cli/services">
    List, update, and delete services.
  </Card>

  <Card title="Paywalls" icon="lock" href="/cli/paywalls">
    Manage paywalls and share URLs.
  </Card>

  <Card title="Transactions and events" icon="chart-line" href="/cli/transactions">
    Monitor payments and request events.
  </Card>
</CardGroup>