com.402lounge/mcp · v0.4.0 · finance-and-payments
402lounge is healthy: it completed an MCP handshake in 1123 ms and exposes 55 tools.
Receipts, invoices and a payTo register for AI agents that pay with x402 (USDC on Base).
Endpoint: https://mcp.402lounge.com/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 55 |
| Latency | 1123 ms |
| Last checked (UTC) | 2026-11-05T02:50:44.974Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-11-05T02:50:44.974Z | Healthy | 1123 |
lounge.requirements | Rules, prices, the current terms and the exact sentences you will sign. Free, no account. |
lounge.terms | Versions, hashes and links of the terms and the privacy notice. With accept: true you confirm a new version: first call returns a challenge, second call with proof {message, signature} records it. |
lounge.signup | Free. Your account is a company from the first call, named after you until company.update adds the legal data. With invite_code you join an existing company instead. Proves your wallet with a signature: first call returns a challenge, second call with proof {message, signature} creates the account. |
lounge.me | Who you are (agent and role), your company with its agents, people and level, its wallets, your apps, terms state and pending notices. |
lounge.agent.update | Your name inside the company, 1 to 40 characters, unique in the company. Company data lives in company.update. |
lounge.wallet.add | The new wallet proves itself: first call returns a challenge for it, second call with wallet_proof {message, signature} adds it. It belongs to your company and you operate it. How many follows the plan: Free 1, Books 5 per agent and 15 in all, Books for teams without limit. |
lounge.wallet.remove | Your own wallets (admins: any wallet of the company). Not the one you sign in with, and never your last one. Sessions made with that wallet end. Its receipts stay. |
lounge.wallet.primary | The wallet you sign in with. It has to be assigned to you. |
lounge.wallet.list | All wallets of your company, each with the agent that operates it. mine: true lists only yours. |
lounge.session | create: a new lg_ token (needs a signature or an existing token). list and revoke manage them. |
lounge.apps | Which clients this agent has used. deactivate ends their sessions, activate turns them back on, disconnect forgets them. |
lounge.notices | Terms changes, moderation decisions, deletion and security notes, for you and for your company. ack marks one as read. |
lounge.dashboard.link | A one-time browser link (10 minutes) into your company's dashboard, signed in as you, for the human behind you. |
lounge.account.export | Everything 402lounge keeps about you as an agent off chain, as JSON. The company's books come from receipts.list and invoices.list. |
lounge.account.delete | Schedules your deletion as an agent in 7 days. cancel: true keeps you. Your wallets and receipts stay with the company. Needs a fresh signature with the delete statement (first call returns the challenge). |
receipts.record | Call this after every x402 payment: the transaction hash from the PAYMENT-RESPONSE header plus the URL you paid. 402lounge matches it with the transfer on Base and writes a receipt with the seller from the register, the catalogue description and a provisional EUR value. Free. |
receipts.list | Receipts of your company for one month (default: the current month, Europe/Berlin), newest first, each with the agent that paid. Totals per seller and per agent, and the reports still waiting for the chain. mine: true, agent_id or wallet narrow it. |
receipts.get | A single receipt of your company by id or transaction hash. |
register.lookup | Wallet in, seller out: the listing that owns a payTo address, its verification level, its paid endpoints and the last health check. Free, no account. Call it before you pay someone new. |
company.get | Legal data, VAT status, tier and level, what is missing for the next tier, its agents with this month's spending, its people and your role. |
company.update | Admins only. Your account starts as a company named after you. A company is ready for invoices (tier invoice_ready) once it has name, legal_form (or sole_proprietor), owner_name for a sole proprietor, address_line1, postal_code, city, country, a confirmed email and its VAT status with the number: in |
company.vat_check | Asks VIES again and updates the tier. Admins, owners and finance. |
company.email | Where documents and notices go. start sets the address and mails a 6-digit code, confirm checks it, remove clears it (only while the account has no company data). Admins only. |
company.invite | Admins only. A code valid for seven days. A new agent signs up with lounge.signup {invite_code}, an agent with its own account calls company.join {code} and brings its wallets and receipts. |
company.join | With an invite code. Works while your own account has no company data, no vouchers and no other agents: your wallets, receipts and reports move into that company and your own account goes away. You join as an agent, and an admin there can make you admin. |
company.agents | Every agent with its role, its wallets and what it paid this month (receipts, USDC, EUR). |
company.agent.update | Admins change any agent, an agent may rename itself. role is admin or agent. The company always keeps an admin or an owner. |
company.agent.remove | Admins only. Schedules the agent's deletion in 7 days. Its wallets stay with the company, unassigned, and its receipts stay in the books. |
company.wallet.assign | Admins only. agent_id null leaves the wallet unassigned. Receipts already written keep the agent that paid, new ones get the new agent. Sessions of the previous agent made with that wallet end. |
company.wallet.label | A name for the company's own lists, e.g. "Research budget". Agents may name their own wallets, admins any. label null clears it. |
company.members | list shows them. invite adds a person by email with a role: owner (everything), finance (documents, VAT check, plan), adviser (reads and exports, changes nothing, for a tax adviser), viewer (reads). They sign in by email link. An address that is in another company already keeps its login and gets th |
company.requests | Where the tax adviser or the team ask for things, like a receipt that is missing or a purchase nobody described. list shows open ones (status: done or all for more), show one with its answers (request_id), ask writes one (title, body, optional month like 2026-10 and receipt_id), answer replies (requ |
invoices.list | Monthly vouchers per seller (and later invoices), newest first. Optional month like 2026-10. |
invoices.get | The full document as JSON, by id or number, with where its archived files lie and their sha256. The PDF is at /v1/invoices/{id}/pdf with your session token. |
invoices.issue | Admins, owners and finance. Runs by itself every night for last month. Call it for an older finished month or after a cancellation. One document per seller: the monthly overview on Free, the voucher with the tax note on Books. Payments that arrive after a document get a supplement. Pairs with receip |
invoices.draft | Drafts of the documents the month would get today, one per seller, with lines, totals and the tax case. Nothing is stored and there is no number. Default: the current month (Europe/Berlin). The PDF of a draft is at /v1/invoices/draft/pdf?month=&seller=. |
invoices.cancel | Admins, owners and finance. Issues a cancellation for a document, with your reason. The original keeps its number and turns to cancelled. Its payments are open again, so invoices.issue for that month (or the nightly run for last month) puts them in a new document. |
company.close | Admin agents and the owner. Closes the company in 30 days: name confirms it with the company name. Until then everything can be read and the export works (GET /v1/company/export), calls that write are refused with company_closing. Then agents, people, sign-ins, sessions and wallets are removed. Rece |
directory.search | Services that take x402 payments, with their level (0 listed, 1 wallet verified), what they offer (MCP, .well-known/x402, llms.txt) and a link. Search by name, description or host. filter: all, verified or mcp. sort: level, new or name. Free, no account. |
directory.get | A listing with its wallets (network and level), what its calls cost, other networks it takes and its links. Company and location show from level 2 on. Free, no account. |
directory.claim | Admin agents and owners. A wallet the listing names proves the service is your company's: first call returns a challenge for that wallet, second call with wallet_proof {message, signature} signed by it claims the listing. The wallet moves to level 1 and payments to it name the listing on receipts. A |
directory.preview | We call one paid URL once without paying, read its 402 answer and show the listing it would make: name, description, price, logo and the wallet you get paid on. Says so when the host or the wallet is listed already, then claim that listing instead. |
directory.submit | Admin agents and owners. Puts the service behind one paid URL into the directory on level 0, under your company: its payTo wallet on Base, the call and its price from the 402 answer. contact_email is only for us, never shown. Then prove the wallet with directory.claim for level 1. |
billing.get | Your company's plan with its period and end, its limits (null means no limit), what it uses this month (transactions, agents, wallets), whether the one-time 20 % over the limit is used, whether the month is locked, the archive (keeps receipts and documents without a paid plan, archive) and what happ |
billing.checkout | Admin agents, the owner and finance. A checkout link at Polar for Books or Books for teams (plan + period), monthly or yearly (a year costs ten months), or for the archive (archive: month or year, €5 a month or €50 a year), which keeps receipts and documents of a company without a paid plan. Polar i |
billing.portal | Admin agents, the owner and finance. A link to Polar's customer portal: payment method, invoices, change or cancel the plan. |
billing.quote | Admin agents, the owner and finance. An offer to pay in USDC on Base: a plan (plan + period), the archive for a company without a paid plan (archive: month or year) or the seller check for level 2 (seller_check: your listing slug, one year). The price is net in EUR, with VAT for your company and the |
billing.invoices | The invoices 402lounge issued to your company for payments in USDC, newest first, each with a PDF link (add ?lang=de for German). With id: one invoice with its full content. Plans bought through Polar get their invoice from Polar. |
seller.get | Your company as a seller: every listing with its level (0 listed, 1 wallet verified, 2 company verified, 3 invoicing), the company check and its steps, the seller profile (register entry, representative), the invoicing mandate and self-billing, and what is missing for the next level. |
seller.profile | Admin agents and owners. What level 2 needs on top of the company data: the name of the person who acts for the company (representative_name, the role is optional). The commercial register court and number help the check but are optional, no_register: true where there is none. sole_proprietor: true |
seller.check | Level 2 for a listing of your company on level 1: action start {listing} opens the check and returns its steps. The domain of the listing is proved by an email address at it: email {id, email} sends a code there, confirm_email {id, code} confirms it. Without a mailbox, add the DNS TXT record from th |
seller.mandate | Admin agents and owners. get shows the mandate text (link, version, sha256) and whether it is signed. sign: first call returns a challenge, sign it with your wallet and call again with agreement_proof {message, signature}. Then, with a listing on level 2 and Books, buyers on level 3 get monthly invo |
seller.self_billing | Admin agents and owners. Without a mandate, a company on level 2 can agree that its buyers on level 3 issue credit notes (Gutschriften) for what they paid, on any plan. get, sign (challenge, then agreement_proof), revoke (at the end of the month). |
seller.invoices | Invoices 402lounge issued in your name (L-2610-10427-01), credit notes your buyers issued to you (G-...) and their cancellations, newest first, each with its e-invoice. With id the whole document. PDF and XML: GET /v1/seller/invoices/{id}/pdf and /xml. |
seller.invoices.cancel | Admin agents, the owner and finance. Cancels an invoice in your name or a credit note you received, with a reason: a cancellation in your number range follows, the original stays. The payments are open again and the next monthly run issues them anew. |