bots.st/402lounge
402lounge
USDC-based invoices, receipts, and billing records
2685 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 59
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://mcp.402lounge.com/mcp
What it can do
| Tool | What it says it does |
|---|---|
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… |
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… |
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. |
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… |
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.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.agents | Every agent with its role, its wallets and what it paid this month (receipts, USDC, EUR). |
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… |
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.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.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.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… |
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… |
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… |
company.vat_check | Asks VIES again and updates the tier. Admins, owners and finance. |
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. |
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… |
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.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.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.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. |
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. |
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.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… |
invoices.list | Monthly vouchers per seller (and later invoices), newest first. Optional month like 2026-10. |
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). |
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.agent.update | Your name inside the company, 1 to 40 characters, unique in the company. Company data lives in company.update. |
lounge.apps | Which clients this agent has used. deactivate ends their sessions, activate turns them back on, disconnect forgets them. |
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.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.notices | Terms changes, moderation decisions, deletion and security notes, for you and for your company. ack marks one as read. |
lounge.requirements | Rules, prices, the current terms and the exact sentences you will sign. Free, no account. |
lounge.session | create: a new lg_ token (needs a signature or an existing token). list and revoke manage them. |
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… |
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.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.list | All wallets of your company, each with the agent that operates it. mine: true lists only yours. |
lounge.wallet.primary | The wallet you sign in with. It has to be assigned to you. |
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. |
receipts.get | A single receipt of your company by id or transaction hash. |
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.name_wallet | Your company's own name for a payTo wallet the register does not know, so its receipts say who was paid (e.g. a receipt that needs you because the wallet has no name). The name shows on your company's receipts only, marked as your name, never in the register. name null forgets it. Everyone in the… |
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.refunds | USDC a seller sent back to one of your wallets, read from Base. 402lounge links a refund to the payments it pays back when the amount matches one payment or the newest ones exactly, the receipts then show it under refunded. list (default, month or state narrow it), get (id), link (id plus… |
receipts.set_supply | Mark a payment as a gift card purchase (gift_card) or as a service (service). Gift card purchases go onto a monthly document of their own without reverse charge, because selling a multi-purpose voucher is no supply. An eSIM or a single-purpose voucher bought through a gift card seller is a… |
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. |
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… |
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.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. |
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… |
seller.prices | Admin agents and owners. What your listing costs, in your words: up to 12 lines, each a label, a price in USDC and whether it is per call or the minimum top-up of a balance. All lines at once, they replace the ones before. The listing page shows them instead of what the nightly check read from… |
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… |
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). |
In its maker's words
Receipts, invoices and a payTo register for AI agents that pay with x402 (USDC on Base).
- Website
- 402lounge.com
- Publisher
- 402lounge.com
- Listed from
- the official MCP Registry as
com.402lounge/mcp - Version
- 0.5.1, updated 7 Nov 2026
- Kinds of work
- Shops and payments, Documents and files, Finance and markets
The domain it lives on
- 402lounge.com
- registered 25 Oct 2026 (1 months ago), at Cloudflare, Inc., its name does not resolve now
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 2685 ms | |
| Answered | 3390 ms | |
| Answered | 682 ms |
Next door
Is this your bot? Claim its address to add a verified badge and keep the listing current.