> ## 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.

# Pay with an agent

> Let an AI agent in Claude Code, Cursor, or Codex pay a Proceeds endpoint over x402, MPP, or Circle Nanopayments.

These docs mostly cover the seller journey — putting a paywall in front of your API. This section covers the buyer journey: you already have a Proceeds payment URL, and you want an AI agent to pay it for you.

Agents pay Proceeds endpoints the same way any client does — request, get a `402` challenge, sign a payment, retry. The difference is the wallet and tooling live inside your agent. Pick a tool below, install it in your IDE, fund a wallet, then hand your agent a Proceeds URL.

## Give your agent these docs

Before wiring up a wallet, let your agent read the documentation directly:

**MCP server** — search and read tools for these docs:

```bash theme={null}
claude mcp add --transport http proceeds https://docs.myproceeds.xyz/mcp
```

**llms.txt** — full docs index for LLMs: [docs.myproceeds.xyz/llms.txt](https://docs.myproceeds.xyz/llms.txt)

## Before you start

You need:

* A **Proceeds payment URL** for the endpoint you want to call:

```text theme={null}
https://myproceeds.xyz/api/pay/{serviceId}/{slug}
```

* A funded **agent wallet** with USDC on a supported network — see [Supported blockchains](https://docs.myproceeds.xyz/guides/supported-blockchains.md).

> [!NOTE]
>
> Every paywall uses that one URL. The `402` challenge offers MPP only when **Tempo** is a supported network, and x402 when an EVM network such as Base is enabled.

## Pick your tool

All three tools work from Claude Code, Cursor, and Codex. Choose based on the standard your target paywall accepts and the wallet experience you want.

| Tool | Best for | Standards | Proceeds URL |
| - | - | - | - |
| [AgentCash](https://docs.myproceeds.xyz/agents/agentcash.md) | Broad access and service discovery across 300+ APIs | x402, MPP | `/api/pay/{serviceId}/{slug}` — the agent picks from the challenge |
| [Circle Agent Stack](https://docs.myproceeds.xyz/agents/circle-agent-stack.md) | Circle-native wallets and sub-cent nanopayments | x402, Circle Nanopayments | `/api/pay/{serviceId}/{slug}` |
| [Tempo Wallet](https://docs.myproceeds.xyz/agents/tempo-wallet.md) | MPP-first agents with built-in spend controls | MPP | `/api/pay/{serviceId}/{slug}` |

## Use from your IDE

The setup pattern is the same across Claude Code, Cursor, and Codex:

**1. Install the CLI or skill**

Each tool ships a CLI, an agent skill, or an MCP server. Install it once in the IDE where your agent runs (see the per-tool pages for the exact command).

**2. Fund a wallet**

Onboard and fund an agent wallet with USDC.

**3. Hand the agent a Proceeds URL**

Give your agent the paywall URL and ask it to call the endpoint. The agent handles the `402` challenge, signs the payment, and retries automatically.

**4. Confirm in the dashboard**

Watch the matching record land as `Completed` in [Transactions](https://docs.myproceeds.xyz/dashboard/transactions.md) (nanopayments go `Pending` → `Completed` after Gateway batch settlement), and trace each step in [Events](https://docs.myproceeds.xyz/dashboard/events.md).

## Proceeds URL cheat sheet

x402, MPP, and Circle Nanopayments share one charge URL. The challenge advertises which rails the paywall accepts.

```bash theme={null}
https://myproceeds.xyz/api/pay/{serviceId}/{slug}
```

## How an agent payment flows

```mermaid theme={null}
flowchart TD
  Dev[You in Claude Code, Cursor, or Codex] --> Tool{Which tool?}
  Tool -->|x402 or MPP| AgentCash[AgentCash]
  Tool -->|x402 or nanopayments| Circle[Circle Agent Stack]
  Tool -->|MPP| Tempo[Tempo Wallet]
  AgentCash --> Call[Agent calls Proceeds URL]
  Circle --> Call
  Tempo --> Call
  Call --> Challenge["Proceeds returns 402 challenge"]
  Challenge --> Pay[Agent signs payment from its wallet]
  Pay --> Retry[Agent retries with proof]
  Retry --> Deliver[Proceeds verifies and proxies upstream]
  Deliver --> Monitor[Track in Transactions and Events]
```

## Next steps

> [card] [AgentCash](https://docs.myproceeds.xyz/agents/agentcash.md)
>
> 300+ APIs over x402 and MPP from one USDC balance.

> [card] [Circle Agent Stack](https://docs.myproceeds.xyz/agents/circle-agent-stack.md)
>
> Agent wallets and gas-free nanopayments via Circle CLI.

> [card] [Tempo Wallet](https://docs.myproceeds.xyz/agents/tempo-wallet.md)
>
> MPP-native payments with built-in spend controls.

> [card] [Help agents call your API](https://docs.myproceeds.xyz/guides/api-discovery.md)
>
> Agent guidance and docs links sellers attach to a service.

> [card] [Accept payments from agents](https://docs.myproceeds.xyz/guides/accept-payments-from-agents.md)
>
> Seller playbook for agent buyers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.