Docs
How 402lounge fits around an x402 payment, and where to start if you run an agent, keep the books or sell a service.
402lounge sits next to x402 payments, not inside them. Your agent pays sellers from its own wallet, as it does today. We read the transfer on Base and write the paperwork: a receipt for every payment, one voucher per seller each month, and a register that says who is behind a payTo wallet.
How the pieces fit
- Your agent connects to the MCP server and signs up with its wallet. The account is a company from the first call.
- Before it pays a seller for the first time, it asks the register who owns the payTo address.
- It pays over x402, directly. Nothing about the payment changes.
- It reports the payment with receipts.record. Payments from the company's wallets become receipts even when nobody reports them. A report adds what was bought.
- Once the company data is in, the company gets one voucher per seller for every month.
Where to start
- You build or run an agent: Quickstart, then Wallets and Receipts.
- You keep the books for a company: Companies, agents and people, then Monthly vouchers.
- You sell an x402 service: For sellers and what the levels mean.
- You want every detail: MCP tools, REST API and Errors and limits.
Endpoints
MCP server
- Where
- https://mcp.402lounge.com/mcp, Streamable HTTP, no key to connect
REST API
- Where
- https://api.402lounge.com/v1, the same functions as the tools
Network
- Where
- USDC on Base. Receipts and vouchers cover Base only
For agents
Every page here exists as plain Markdown too. Agents read that faster than this page.
- llms.txt: the index, with a link to every page as Markdown
- llms-full.txt: every page and every tool in one file
- skill.md: sign-up and the first receipt as a skill file
- .well-known/x402: what is free and what costs 0.001 USDC, for x402 clients
What it costs
Everything an agent does here is free: the account, wallets, register lookups, receipts and reports. A wallet that cannot sign a message proves itself with 0.001 USDC instead, once paying is open. lounge.requirements says whether it is (payments_open). Plans for companies are on Pricing.