Your p2pai trading agent

Set up once in your terminal. Then just talk — your agent browses orders, executes trades, and handles settlement as you, within the spending limit you control.

Moderato testnetClaude Code + MCP0.1 USDC per order or match

How it works

Your wallet, your identity

The Tempo Wallet you connect to the CLI is the same wallet you use on p2pai.xyz. Your agent never has a separate identity — it acts as you with your address on every order and trade.

Spending limit = your agent's budget

When you log into Tempo, you set a spending limit (e.g. 10 USDC). Your agent draws from that limit — 0.1 USDC per order placed, 0.1 USDC per trade matched. You stay in full control of the ceiling.

You confirm the critical step

Browsing, checking status, marking payment sent — fully automatic. Releasing USDC to a buyer (confirm_payment) always requires you to explicitly tell your agent. That trust anchor is always yours.

Quick start

One command. Claude installs Tempo CLI, opens your browser to connect your wallet, reads your address automatically, and wires up the p2pai MCP server.

claude -p "Read https://p2pai.xyz/SKILL.md and set up p2pai"

Connect here to see your wallet address, or find it at wallet.tempo.xyz after login.

Requires Claude Code: npm install -g @anthropic-ai/claude-code

Example flows

This is what a real session looks like — from first setup to a completed trade.

Run this once. Claude handles everything — installs CLI, opens browser auth, reads your wallet, wires up the MCP.

claude

›Read https://p2pai.xyz/SKILL.md and set up p2pai

⏺Fetching p2pai setup guide...

⏺Fetch(https://p2pai.xyz/SKILL.md)

⎿ Received 3.2KB (200 OK)

⏺Step 1 — Installing Tempo CLI

⏺Bash(curl -fsSL https://tempo.xyz/install | bash)

⎿ Tempo v1.6.0 installed at ~/.tempo/bin/tempo

⏺Step 2 — Connecting your wallet (browser will open)

⏺Bash("$HOME/.tempo/bin/tempo" wallet login)

⎿ Auth URL: https://wallet.tempo.xyz/cli-auth?code=8K2XMQPT Waiting for browser authentication... ✓ Authenticated

⏺Step 3 — Reading wallet address and spending limit

⏺Bash("$HOME/.tempo/bin/tempo" wallet -t whoami)

⎿ ready: true wallet: "0x512c384e6648daed20793bc41142dc91f7a8b0bd" balance: 2.50 USDC (available) spending_limit: 10.00 USDC remaining

⏺Step 4 — Installing p2pai MCP with your wallet address

⏺Bash(claude mcp add p2pai -e P2PAI_BUYER_ADDRESS=0x512c... -- npx -y p2pai-mcp)

⎿ MCP server "p2pai" added

Your p2pai agent is ready.

Wallet: 0x512c384e...dc91f7a8b0bd

Balance: 2.50 USDC

Spending limit: 10.00 USDC (covers up to 50 order/trade actions at 0.1 USDC each)

Your agent acts as you — your wallet, your trades, your limits.

Try: "Show me open sell orders" or "Post a sell order: 100 USDC at $1.04"

Your spending limit

Your spending limit is set when you log into Tempo — it controls the maximum your agent can spend autonomously. Check it anytime:

"$HOME/.tempo/bin/tempo" wallet -t whoami

Place an order (maker)0.1 USDC — forfeited on cancel or expiry

Match an order (taker)0.1 USDC — forfeited on cancel or expiry

Mark payment sentFree

Confirm payment receivedFree — irreversible, releases USDC on-chain

Browse orders, check status, historyFree

To add funds or raise your limit, run "$HOME/.tempo/bin/tempo" wallet fund or visit wallet.tempo.xyz.

8 tools available to your agent

ToolWhat it doesFee

list_ordersBrowse open buy/sell ordersfree

get_tradeFetch trade status and detailsfree

get_my_tradesYour full trade historyfree

get_trade_status_descriptionHuman-readable next step for a tradefree

mark_payment_sentBuyer marks fiat sent — method + reference + prooffree

confirm_paymentSeller confirms receipt → USDC released on-chainfree

create_orderPost a BUY or SELL order0.1 USDC

match_orderMatch an open order to start a trade0.1 USDC

Docs for your agent

SKILL.mdBootstrap guide — Claude reads this on setup

llms-full.txtFull API reference — all endpoints and schemas

llms.txtShort index for discovery