P2Flux MCP server

P2Flux MCP — let your AI assistant pay for web content

Some websites ask AI assistants to pay a few cents to read an article or use their data. This gives your assistant a small wallet on your own computer and lets it pay those sites for you — never more than the limits you set. P2Flux never holds your money or your key.

Claude Desktop (no technical knowledge needed)

(default: 0.50 USDC per page, 5 USDC per day).

1. Download p2flux.mcpb and double-click it. Claude Desktop asks you to install it.
2. In the form, leave Money on test the first time, and set your limits

1. Ask Claude: "Set up my P2Flux wallet." Claude shows the wallet's address and how to add money.

Send a small amount. Treat it like cash in a pocket.

• Test: free test money from https://faucet.circle.com (choose Base Sepolia).
• Real money: in the Coinbase app choose Send → USDC → Base network and paste the address.

"How much have I spent?"

1. Use it: "Find articles about soup recipes I can buy", "Read this page: https://…",

If the computer is lost, the wallet on it is lost. Keep small amounts.

Claude Code, Cursor and other MCP clients

claude mcp add p2flux -e P2FLUX_NETWORK=test -- npx -y @p2flux/mcp

What it does, and does not

changes the price between the check and the payment gets nothing.

• Pays pages that ask with HTTP 402 (the x402 standard) in USDC on Base. Nothing else.
• Checks the price against your limits before signing, and signs exactly that price. A site that

site back"*) once 0.10 USDC of it was used or after a day without use, and on its own after a week without use when it is 0.50 USDC or more.

• Keeps a spending log on your computer; the daily limit survives restarts.
• Money put aside at a site and not used comes back when you ask (*"take my unused balance at that

through on their own. Above it, your app asks YOU in a dialog - the assistant cannot answer it - with the amount, the site and what the site says it sells; nothing is paid unless you confirm, and never more than P2FLUXMAXCONFIRMED (default 1000 USDC). Apps that cannot show such a dialog refuse the payment instead.

• Your limits are a budget: inside it (default 0.50 USDC per payment, 5 USDC a day) payments go

at the price people pay for it. The site answers with an access token, which is kept on your computer for that site only and sent back to it, so later pages there are read without paying until it expires. check_price shows what the site says a payment buys.

• Some sites sell a period instead of one page - for example a tipster's subscription for 30 days,

so nothing an assistant reads on the web can talk it into giving the key away. To move the wallet elsewhere, run npx -p @p2flux/mcp p2flux-mcp export-key in a terminal yourself.

• The key is in one file only you can read. It is never sent anywhere, and no tool can reveal it -

remote server below: no wallet is kept anywhere; you approve each payment in your own browser wallet.

• ChatGPT and the claude.ai website cannot run a program on your computer. For them there is the

Development

npm install && npm test          # unit tests
npm run build
node test/live.mjs               # live on Base Sepolia (see the file)
npx @anthropic-ai/mcpb pack . p2flux.mcpb

ChatGPT and claude.ai (remote server)

Shortened. The full README is on GitHub.