PAYMENTS/ASSISTANT WALLET

Assistant wallet (MCP)

Let your AI assistant pay for web content, within limits you set. The wallet stays on your computer.

PACKAGE@p2flux/mcp

RUNSOn your computer

WALLETYours, local

PAYSx402 · USDC on Base

What it is

A small program that gives your AI assistant a wallet for paid web content. Some sites ask AI assistants to pay a few cents to read a page; with this, the assistant can find such sites, see the price and pay — never more than the limits you set. The wallet and its key stay on your computer. P2Flux never holds either.

Claude Desktop

Download p2flux.mcpb and double-click it. Claude Desktop installs it.
In the form, leave Money on test the first time and set your limits.
Ask Claude: “Set up my P2Flux wallet.” It shows the wallet address and how to add money.
Then: “Find articles about … I can buy”, “Read this page: https://…”, “How much have I spent?”

MONEY

Test mode uses free test USDC from Circle’s faucet (Base Sepolia). For real money, send USDC on the Base network to the wallet address — a small amount. If the computer is lost, the wallet on it is lost.

Other MCP clients

Claude Code

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

VariableDefaultMeaning

P2FLUX_NETWORKtesttest = Base Sepolia, live = Base with real USDC

P2FLUX_MAX_PER_PAYMENT0.50Most for one page, USDC

P2FLUX_MAX_PER_DAY5Most in 24 hours, USDC

P2FLUX_MAX_PREPAID1Most to put aside at one site; 0 pays every page on its own

P2FLUX_MCP_DIR~/.p2flux-mcpWhere the wallet and the spending log are kept

Tools

ToolDoes

wallet_setupCreates the wallet if there is none; shows the address and how to add money.

wallet_balanceBalance, what was spent in the last 24 hours, the limits.

find_paid_contentSearches the P2Flux directory.

check_priceWhat a page costs. Pays nothing.

read_paidReads a page, paying within the limits and an optional max_price.

withdraw_prepaidTakes an unused prepaid balance at a site back into the wallet, once 0.10 USDC of it was used or after a day without use. Costs nothing.

spending_reportWhat was paid, when, where.

No tool reveals the wallet key: text on a web page can tell an assistant anything, so the one action that would lose the whole wallet is not one it can take. To move the wallet elsewhere, run p2flux-mcp export-key in a terminal yourself.

Limits and safety

The price a page asks is checked against your limits before anything is signed, and exactly that price is signed. A site that raises the price between the check and the payment gets nothing.
Only USDC on the configured network is paid. Only https addresses.
Every payment is written to a log on your computer before it is made; the daily limit survives restarts.
Text from pages and from the directory is marked as untrusted for the assistant.

ChatGPT and claude.ai

ChatGPT and the claude.ai website cannot run a program on your computer; they connect only to servers on the internet. For them there is a second, remote server. It holds no wallet, no balance and no history, and has no login. You approve each payment yourself:

The assistant asks for a paid page and shows you a link.
You open the link. The page shows the amount, the page and the seller’s address, and you approve in your own wallet (Coinbase Wallet, MetaMask, …) — one signature for exactly that amount, no network fee.
The page is paid and fetched at once; the assistant reads it.

ToolDoes

find_paid_contentSearches the P2Flux directory.

check_priceWhat a page costs. Pays nothing.

request_paid_pageOpens a payment request and returns the link for you to approve.

get_paid_pageThe page text, once you have approved.

Only sites paid through P2Flux can be paid, only in USDC on Base, and the server reads only public https websites. A browser wallet extension is needed; one approval per page.

Where it works

The local server: Claude Desktop, Claude Code, Cursor and other clients that run MCP servers on your computer. The remote server: claude.ai and ChatGPT, added as a custom connector without authentication.

Something more than a standard integration?

Marketplace flows, platform billing and custom settlement logic.

Discuss an integration