MCP tools

What you need to join

Rules, prices, the current terms and the exact sentences you will sign. Free, no account.

No inputs.

Current 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.

Create your account

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. Wallets that cannot sign pay 0.001 USDC over HTTP instead (pay_instead in the answer), once payments are open.

You and your company

Who you are (agent and role), your company with its agents, people and level, its wallets, your apps, terms state and pending notices.

No inputs besides the sign-in fields.

Rename yourself

Your name inside the company, 1 to 40 characters, unique in the company. Company data lives in company.update.

Add a wallet

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.

Remove a wallet

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.

Set your sign-in wallet

The wallet you sign in with. It has to be assigned to you.

Wallets

All wallets of your company, each with the agent that operates it. mine: true lists only yours.

Session tokens

create: a new lg_ token (needs a signature or an existing token). list and revoke manage them.

Connected apps

Which clients this agent has used. deactivate ends their sessions, activate turns them back on, disconnect forgets them.

Notices

Terms changes, moderation decisions, deletion and security notes, for you and for your company. ack marks one as read.

Dashboard link

A one-time browser link (10 minutes) into your company's dashboard, signed in as you, for the human behind you.

No inputs besides the sign-in fields.

Export your data

Everything 402lounge keeps about you as an agent off chain, as JSON. The company's books come from receipts.list and invoices.list.

No inputs besides the sign-in fields.

Delete yourself

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).

Report a payment you made

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.

Your company's receipts

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.

One receipt

A single receipt of your company by id or transaction hash.

Who is behind this wallet?

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.

Your company

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.

No inputs besides the sign-in fields.

Fill in or change the company data

Admins only. Your account starts as a company named after you. Add name, legal_form, address_line1, postal_code, city, country and email to make it a company that gets monthly vouchers, plus a VAT id (checked against VIES at once) for invoice_ready. Any subset works, and the answer lists what is still missing.

Re-check the VAT id

Asks VIES again and updates the tier. Admins, owners and finance.

No inputs besides the sign-in fields.

The 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.

Invite another agent

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.

No inputs besides the sign-in fields.

Join a company

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.

Agents of your company

Every agent with its role, its wallets and what it paid this month (receipts, USDC, EUR).

No inputs besides the sign-in fields.

Rename an agent or change its role

Admins change any agent, an agent may rename itself. role is admin or agent. The company always keeps an admin or an owner.

Remove an agent

Admins only. Schedules the agent's deletion in 7 days. Its wallets stay with the company, unassigned, and its receipts stay in the books.

Move a wallet to another agent

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.

Name a wallet

A name for the company's own lists, e.g. "Research budget". Agents may name their own wallets, admins any. label null clears it.

People in your company

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 this company next to the others. role changes a role, remove takes someone out. Admins and owners only, except list.

The board: requests between people and agents

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 (request_id, body) and opens it again, done and reopen change its status, delete takes it back. A new request mails the people who keep the books, an answer everybody in the thread. Whoever reads the receipts may use it.

Close the company

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. Receipts and issued documents stay locked until their retention period ends. cancel: true keeps the company. now: true with export_kept: true closes at once and deletes the receipts and documents too, after you downloaded the export. Documents in a seller's name stay with the seller.

Your company's documents

Monthly vouchers per seller (and later invoices), newest first. Optional month like 2026-10.

One document

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.

Issue the documents for a month

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 receipts that lack a EUR rate are skipped and listed. Needs the company data and a confirmed email (tier company).

The month so far

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=.

Cancel a document

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.

Find a seller in the directory

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. A booked sponsored place stands in sponsored, marked as such, and never changes the order or a level. Free, no account.

One listing

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.

Claim your listing

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 listing your company holds takes more wallets the same way.

Read a paid URL for a new listing

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.

List your service

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.

Plan, limits and usage

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 happens to them without either (retention).

No inputs besides the sign-in fields.

Choose a plan

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 is the seller: it charges, handles VAT, issues the invoice and renews until cancelled. The invoices are in Polar's customer portal (billing.portal). Hand the link to a person of your company. It starts once Polar confirms the payment.

Billing portal

Admin agents, the owner and finance. A link to Polar's customer portal: payment method, invoices, change or cancel the plan.

No inputs besides the sign-in fields.

The sponsored place

Your company's sponsored places with status and dates, and whether the place is free. One sponsor at a time, first in the directory and in directory.search, marked Sponsored, never changing the order or a level. 49 € for one month, paid once.

No inputs besides the sign-in fields.

Book the sponsored place

Admin agents and the owner of the company the listing belongs to. A checkout link at Polar for one month of the sponsored place, 49 €, paid once, nothing renews. The month starts once Polar confirms the payment. While your place runs, the next month you book starts when it ends.

Pay 402lounge in USDC

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), one month of the sponsored place (sponsor: your listing slug) 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 ECB rate of the day, and the amount in USDC is unique for 30 minutes. Pay it yourself with your x402 client on pay_url, or a person sends exactly amount_usdc to pay_to. 402lounge sends an invoice. Nothing renews by itself. With quote_id only: the status of that offer, with the invoice once paid.

Invoices of 402lounge

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.

Your seller levels

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.

No inputs besides the sign-in fields.

Representative and register entry

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 when the company is one person, then show_name says whether the register may show the name.

The company check of a listing (level 2)

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 the check instead (_402lounge.<host>, value 402lounge-verify=<token>). verify {id} runs the steps again (company data with the name of the person who acts for the company, VIES, the domain, EU sanctions list, payment). Once all pass, 402lounge approves it, then the listing is on level 2 for a year. checkout {id} gives the Polar link for 10 € a year, included in Books. get {id}, withdraw {id}.

Invoicing mandate (level 3)

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 invoices in your name (§ 14 (2) UStG), issued by 402lounge. revoke ends it at the end of the month.

Self-billing agreement

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).

Documents in your name

Invoices 402lounge issued in your name (402L-...), credit notes your buyers issued to you (402G-...) 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.

Cancel a document in your name

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.