Skip to main content
Set up the InFlow CLI so that your agent can discover services with ODP, enroll with AEP, and pay with MPP and x402. By default, the agent pays from its InFlow balance. Do you use Claude Code, Cursor, Codex, or another coding agent? It can do this setup for you. See Connect an AI agent.

​
Step 1: Install the CLI

On Windows, run PowerShell as a user who can approve the Windows Installer admin prompt. For Homebrew, WinGet, and other options, see Install the CLI.

​
Step 2: Unlock your vault

The CLI stores credentials in an encrypted local vault.
Run this command yourself in a terminal. Choose a PIN or a passphrase. Never give that PIN or passphrase to an agent.

​
Step 3: Log in

Start the OAuth device flow. Give --client-name a clear and unique name. The owner sees this name on the approval page.
Open the verification URL that the CLI prints. Approve the login. Then check that authenticated is true.
The CLI uses production by default. For the sandbox and for API keys, see Authenticate.

​
Step 4: Check your funds

balances list shows your InFlow balance. deposit-addresses list shows where to send stablecoins. For onchain and card payments, see Pay for a resource.

​
Step 5: Inspect, then pay

inspect reports the ODP, AEP, MPP, and x402 capabilities of a URL. It enrolls nothing and pays nothing.
Run the pay command for the protocol that the output names.
pay waits for the owner’s approval when the payment needs it. It then returns the seller’s response body. The default --timeout of 900 seconds matches the server-side approval expiry. For all pay flags, see Pay for a resource.

​
Find and enroll with a service

Some services need discovery and enrollment before payment. For all flags, see Discover and enroll.
1

Search the directory

2

Read what a service offers

3

Enroll and get a credential

enroll requests access and waits for approval. fetch calls a protected resource with your stored credential.

​
Load a playbook

Load the playbook for a task before your agent runs it. Each playbook matches your installed CLI version. The web copies do not always match. To run the CLI as an MCP server, see Connect an AI agent.

​
Troubleshooting

Run inflow auth status. If authenticated is false, run inflow auth login again. Add --probe to validate the stored token against the server.
Run inflow vault unlock. Check the state with inflow vault status.
The owner has not approved it yet. Approval expires after 900 seconds.Check the state with inflow mpp status or inflow x402 status. Cancel with inflow mpp cancel or inflow x402 cancel.
Run inflow inspect <url> first. An MPP buyer cannot pay an x402 endpoint, and an x402 buyer cannot pay an MPP endpoint.
For other errors, see Errors.

​
Go deeper

CLI reference

Read every command, argument, and flag.

Ask in Discord

Tell the team which step failed and give the error.
Last modified on October 15, 2026