P2Flux MCP
OfficialManage a local P2Flux wallet and pay for web content in USDC on Base within set limits.
Create/set up the wallet and show its address and funding instructions.
Check wallet balance, last-24h spending, and configured limits.
Search the P2Flux directory for sites selling content to AI agents.
Check a page's price without paying.
Read a paid page, paying in USDC if required, respecting max_price and daily/per-payment limits.
Withdraw unused prepaid balance from a site back to the wallet.
List spending history (when, which page, how much).
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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)
Download
p2flux.mcpband double-click it. Claude Desktop asks you to install it.In the form, leave Money on
testthe first time, and set your limits (default: 0.50 USDC per page, 5 USDC per day).Ask Claude: "Set up my P2Flux wallet." Claude shows the wallet's address and how to add money.
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. Send a small amount. Treat it like cash in a pocket.
Use it: "Find articles about soup recipes I can buy", "Read this page: https://…", "How much have I spent?"
If the computer is lost, the wallet on it is lost. Keep small amounts.
Related MCP server: zunivo-mcp
Claude Code, Cursor and other MCP clients
claude mcp add p2flux -e P2FLUX_NETWORK=test -- npx -y @p2flux/mcp
# real USDC on Base:
claude mcp add p2flux -e P2FLUX_NETWORK=live -- npx -y @p2flux/mcpVariable | Default | Meaning |
|
|
|
|
| most for one page |
|
| most in 24 hours |
|
| most to put aside at one site; |
|
| most for one payment you confirm in a dialog (see below) |
|
| where the wallet, the spending log and access tokens are kept |
| P2Flux API of the network | another P2Flux API (https, or http://localhost) |
| public Base RPC | your own Base RPC (https, or http://localhost) |
P2FLUX_MAX_CONFIRMED, P2FLUX_API_URL and P2FLUX_RPC_URL are set in the environment only. The
Claude Desktop form does not show them.
Access tokens a site gives for a subscription are kept in access.json in P2FLUX_MCP_DIR, per
site, until they expire. Delete that file to forget them all.
Listed in the MCP Registry as io.github.P2Flux/mcp, on
Smithery and on Glama.
What it does, and does not
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 changes the price between the check and the payment gets nothing.
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 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.
Your limits are a budget: inside it (default 0.50 USDC per payment, 5 USDC a day) payments go 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
P2FLUX_MAX_CONFIRMED(default 1000 USDC). Apps that cannot show such a dialog refuse the payment instead.Some sites sell a period instead of one page - for example a tipster's subscription for 30 days, 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_priceshows what the site says a payment buys.The key is in one file only you can read. It is never sent anywhere, and no tool can reveal it - 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-keyin a terminal yourself.ChatGPT and the claude.ai website cannot run a program on your computer. For them there is the remote server below: no wallet is kept anywhere; you approve each payment in your own browser wallet.
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.mcpbChatGPT and claude.ai (remote server)
p2flux-mcp-remote is the same idea for assistants that only connect to servers on the internet. It
holds no wallet, no balance and no history, and needs no login. Tools: find_paid_content,
check_price, request_paid_page, get_paid_page.
Hosted server
P2Flux runs this server. Add it as a custom connector in claude.ai or ChatGPT (developer mode), authentication: none.
Real USDC on Base:
https://agent.p2flux.com/mcpTest money on Base Sepolia:
https://agent-test.p2flux.com/mcp
Each payment is approved by you in your own browser wallet. The server never holds your money or a key.
How it works
The assistant asks for a paid page. It gets a link, and shows it to you.
You open the link. The page shows the amount, the page and the seller's address. 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.
Only sites paid through P2Flux can be paid, only in USDC on Base, and never more than
P2FLUX_REMOTE_MAX_PRICE (default 1000 USDC). Above P2FLUX_REMOTE_CONFIRM_ABOVE (default 5 USDC) -
a subscription, say - the person is asked twice: the assistant must first ask them and pass their
budget as max_price, and the approval page shows the amount and what the site says it sells, with
a box to tick before the wallet opens. P2FLUX_REMOTE_SECRET (32+ characters) seals access tokens to
their site across restarts. The server reads only public https websites.
Run your own
P2FLUX_PUBLIC_URL=https://agent.example.com P2FLUX_NETWORK=test PORT=8787 npx -p @p2flux/mcp p2flux-mcp-remotePut it behind https (nginx) with P2FLUX_TRUST_PROXY=1, then add https://agent.example.com/mcp as a
custom connector in claude.ai or ChatGPT (developer mode), authentication: none.
Variable | Default | Meaning |
| (required) | the https address this server is reachable at |
|
|
|
|
| most for one payment |
|
| above this the person is asked twice |
| (random per start) | 32+ characters; keeps access tokens valid across restarts |
| off |
|
| off |
|
| P2Flux API of the network | another P2Flux API |
| public Base RPC | your own Base RPC |
|
| where it listens |
Limits today: a browser wallet extension is needed (no WalletConnect / phone wallets yet); one approval per page (no prepaid balance).
Available Tools
7 toolscheck_priceBInspect
See what a web page costs for an AI agent, without paying.
Inputs: url (required).
find_paid_contentBInspect
Search the P2Flux directory for websites that sell content to AI agents. Returns site names, what they offer and the price per page. Costs nothing.
Inputs: query (required).
read_paidAInspect
Read a web page, paying for it in USDC from the wallet if the page asks. Never pays more than max_price, the limit per payment or the daily limit. Returns the page text and what was paid.
Inputs: url (required), max_price.
spending_reportAInspect
List what the wallet paid for: when, which page, how much.
Inputs: no named parameters.
wallet_balanceAInspect
Show how much USDC the wallet holds, what was spent in the last 24 hours, and the limits.
Inputs: no named parameters.
wallet_setupAInspect
Create the P2Flux wallet on this computer (if there is none) and show its address and how to add money. Run this first.
Inputs: no named parameters.
withdraw_prepaidAInspect
Take the unused prepaid balance for a website back into the wallet. Costs nothing. Use when the user is done with a site that was paid from a prepaid balance.
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct action in the payment lifecycle: setup, balance, history, discovery, price check, paid read, and withdrawal. There is no meaningful overlap; check_price vs read_paid is clearly differentiated as 'look without paying' vs 'pay and read'.
All seven tools use a consistent snake_case verb_noun pattern (wallet_setup, wallet_balance, spending_report, find_paid_content, check_price, read_paid, withdraw_prepaid). No mixed conventions or casing styles.
Seven tools is well-scoped for a wallet-plus-paid-content server, with each tool covering a necessary step. Nothing feels redundant or missing from a count perspective.
The surface covers wallet creation, funding guidance, balance, spend history, discovery, price inspection, paid reading, and refunds, which is a complete workflow. The only minor gap is no explicit programmatic deposit/top-up tool, though wallet_setup explains how to add money.
Maintenance
Related MCP Connectors
Pay-per-use MCP tools for AI agents. USDC on Base via x402. No API keys.
Paid MCP tools for URL payment-safety scanning and provider recommendations; USDC on Base via x402.
MCP server for X420's pay-per-call agent services (x402, USDC on Base, paid from your own wallet).
371Monetize any MCP server: x402 paywall, pay-per-call billing in USDC on Base, agent marketplace.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that enables AI agents to automatically pay for and access paywalled content via the x402 payment protocol.15 npmMIT

zunivo-mcpofficial
AlicenseAqualityCmaintenanceMCP server that lets AI agents discover and pay for .agent services using USDC over x402, with daily budget controls and payment link creation.6MIT
halowerk-mcpofficial
AlicenseAqualityDmaintenanceProvides access to 70 paid APIs as MCP tools with per-call and session budgets, paying via x402/USDC on Base without requiring an account or login. Includes a built-in allowlist of hosts and safe defaults to prevent unintended payments.1482 npmMIT- AlicenseAqualityBmaintenanceEnables AI agents to make non-custodial USDC payments on Base through an MCP endpoint, with server-enforced per-payment and daily caps, human approval bands, and recipient allowlists.739 npmMIT