# 402lounge (remote · mcp.402lounge.com)

Receipts, invoices and a payTo register for AI agents that pay with x402 (USDC on Base).

- Trust score: 64/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `mcp.402lounge.com`: 64/100 (this document), [markdown](https://verifymcp.io/servers/com-402lounge-mcp/mcp.md), [page](https://verifymcp.io/servers/com-402lounge-mcp/mcp)

## Channel facts

- Endpoint: `https://mcp.402lounge.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.5.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (lounge.wallet.remove).
  - HTTPS enforcement could not be verified: the plaintext port answered with HTTP 405, which proves neither a plaintext path nor enforcement.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 59/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 10924 tokens (~185/item across 59 items; 59 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 53/100
  - Stability observed for 16 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 60 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the 402lounge MCP server?

402lounge is a hosted endpoint at https://mcp.402lounge.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http com-402lounge-mcp 'https://mcp.402lounge.com/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "com-402lounge-mcp": {
      "url": "https://mcp.402lounge.com/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "com-402lounge-mcp": {
      "type": "http",
      "url": "https://mcp.402lounge.com/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.com-402lounge-mcp]
url = "https://mcp.402lounge.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-402lounge-mcp": {
      "type": "remote",
      "url": "https://mcp.402lounge.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-402lounge-mcp --url 'https://mcp.402lounge.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-402lounge-mcp:
    url: "https://mcp.402lounge.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "com-402lounge-mcp": {
      "Transport": "http",
      "Url": "https://mcp.402lounge.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add com-402lounge-mcp -t streamable-http -u 'https://mcp.402lounge.com/mcp'
```

### Other

```json
{
  "mcpServers": {
    "com-402lounge-mcp": {
      "type": "http",
      "url": "https://mcp.402lounge.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-19 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 63, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-15 (score 62, +1)

No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-13 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-11 (score 60, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-09 (score 59, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-07 (score 58, +1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: 0.5.0 → 0.5.1
- [functional] Server version: 0.4.0 → 0.5.0
- [functional] New tool “receipts.refunds”
- [functional] New tool “receipts.set_supply”
- [cosmetic] “receipts.record” added an optional parameter “supply”
- [cosmetic] “company.update” reworded the description of “own_accounts”

### 2026-11-06 (score 57, 0)

- [functional improvement] Stability: unverified → 0.03

## MCP tools (59)

### `lounge.requirements` (~29 tokens)

What you need to join

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

### `lounge.terms` (~148 tokens)

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.

Input parameters:

- `accept` (boolean): true confirms the current terms and privacy notice. The first call returns the challenge to sign, the second call sends it as proof
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.signup` (~297 tokens)

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.

Input parameters:

- `accept` (object, required): What you accept: the terms and privacy versions from lounge.requirements, and business: true, because 402lounge is for businesses only
- `address` (string): Your wallet address, so the challenge comes back as a finished message
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `email` (string): Optional: where documents and notices of your new company go. Ignored with invite_code.
- `invite_code` (string): From company.invite, to join that company
- `name` (string, required): Your name as an agent, unique inside your company, e.g. "Research"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `provider` (string): awal, cdp, viem, other
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.me` (~104 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.agent.update` (~122 tokens)

Rename yourself

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `name` (string, required): Your new name, 1 to 40 characters, unique in your company
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.wallet.add` (~213 tokens)

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.

Input parameters:

- `address` (string, required): The wallet to add, 0x followed by 40 hex characters
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `provider` (string): Optional: what holds the key: awal, cdp, viem or other
- `session_token` (string): A lounge session token (lg_...) if you have one
- `wallet_proof` (object): Second call only: the challenge message the first call returned, and the signature of that wallet over it

### `lounge.wallet.remove` (~123 tokens)

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.

Input parameters:

- `address` (string, required): The wallet to remove
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.wallet.primary` (~114 tokens)

Set your sign-in wallet

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

Input parameters:

- `address` (string, required): The wallet you sign in with from now on. It has to be assigned to you
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.wallet.list` (~110 tokens)

Wallets

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `mine` (boolean): true lists only the wallets you operate
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.session` (~133 tokens)

Session tokens

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

Input parameters:

- `action` (string, required): create a new lg_ token, list your sessions or revoke one
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_id` (string): revoke: the session to end, from list
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.apps` (~149 tokens)

Connected apps

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

Input parameters:

- `action` (string): list (default) shows the clients. deactivate ends a client's sessions, activate turns it back on, disconnect forgets it
- `app_client` (string): The client as list names it. Needed for every action but list
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.notices` (~153 tokens)

Notices

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

Input parameters:

- `action` (string): list (default) shows the notices, ack marks one as read
- `all` (boolean): list: also the notices you have read already
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `id` (integer): ack: the notice to mark as read, from list
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.dashboard.link` (~100 tokens)

Dashboard link

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.account.export` (~103 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `lounge.account.delete` (~156 tokens)

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

Input parameters:

- `cancel` (boolean): true keeps you: it cancels a deletion that is scheduled
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `confirm` (boolean, required): Must be true: you want this agent deleted in 7 days
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `receipts.record` (~333 tokens)

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.

Input parameters:

- `amount` (string): What you paid, in USDC, e.g. "0.002"
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `description` (string): What you bought, in your words. The seller's catalogue wins when it knows the URL.
- `network` (string): base or base-sepolia. Default: the network 402lounge runs on, base
- `pay_to` (string): The payTo address from the payment requirements
- `payment_response`: The raw PAYMENT-RESPONSE header, if you still have it
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `resource_url` (string): The URL you paid for (the 402 resource)
- `session_token` (string): A lounge session token (lg_...) if you have one
- `supply` (string): What you bought: gift_card for a gift card or other voucher (a Bitrefill order of a gift card, for example), service for everything else, an eSIM included. Leave it out when unsure, the seller's rout…
- `tx_hash` (string, required): The settlement transaction, 0x plus 64 hex characters

### `receipts.list` (~230 tokens)

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.

Input parameters:

- `agent_id` (string): Only one agent of the company
- `before` (integer): Page: the smallest receipt id of the previous page
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `limit` (integer): How many receipts, 1 to 200
- `mine` (boolean): Only the receipts of wallets you operated
- `month` (string): Like 2026-10
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one
- `status` (string): Only receipts with this seller status
- `wallet` (string): Only one paying wallet

### `receipts.get` (~101 tokens)

One receipt

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `id` (string, required): Receipt id or 0x transaction hash
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `receipts.set_supply` (~197 tokens)

Say what a payment bought

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 service. Owner, admin and finance, while no valid document lists the payment (error receipt_on_document names it, cancel it first). Your choice stays, nothing overwrites it.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `id` (string, required): Receipt id or 0x transaction hash
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one
- `supply` (string, required): gift_card or service

### `receipts.name_wallet` (~193 tokens)

Name a wallet you paid

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 company but viewers and the adviser.

Input parameters:

- `address` (string, required): The payTo wallet you paid, 0x followed by 40 hex characters
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `name` (required): Who that wallet belongs to, up to 60 characters. null forgets the name
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `receipts.refunds` (~354 tokens)

Refunds sellers paid back

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 payments, each a receipt id or tx hash with an optional usdc part), dismiss (id plus reason, when the transfer is no refund, finance), reopen (id). Refunds go onto the documents of the month the money came back, the original documents stay.

Input parameters:

- `action` (string): list (default), get, link, dismiss or reopen
- `before` (integer): list: page, the smallest refund id of the previous page
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `id` (string): get, link, dismiss, reopen: the refund by id or 0x transaction hash
- `limit` (integer): list: how many, 1 to 200
- `month` (string): list: refunds that came back in this month, like 2026-11
- `payments` (array): link: the payments the refund pays back
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `reason` (string): dismiss: why the transfer is no refund, 3 to 500 characters
- `session_token` (string): A lounge session token (lg_...) if you have one
- `state` (string): list: only refunds in this state, open ones need you

### `register.lookup` (~62 tokens)

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.

Input parameters:

- `address` (string, required): A payTo address on Base

### `company.get` (~105 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.update` (~756 tokens)

Fill in or change the company data

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 the EU a VAT id VIES confirms (checked at once), or the tax_number for small businesses and VAT-exempt companies. Until then it gets receipts and a preview of its monthly documents, and buying a plan waits. Any subset works, and the answer lists what is still missing (missing_for_company).

Input parameters:

- `address_line1` (string): Street and number of the registered address
- `address_line2` (string): Optional second line of the address
- `address_state` (string): State or province, written after the city in the USA, Canada and Australia (TX, ON, NSW)
- `city` (string): City of the registered address
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `country` (string): ISO 3166 two-letter code, e.g. DE
- `currency` (string): The currency amounts are shown in, next to USDC: EUR (default, the currency of the documents), USD, or any currency with an ECB reference rate
- `email` (string): Where documents and notices go. A code confirms it
- `fx_method` (string): How USDC becomes EUR on documents. Today only ecb_daily (ECB reference rate of the payment day)
- `language` (string|null): Language of documents and mails: en, de, fr, it, es, nl, pt, sv, da, fi or nb. Null takes the language of the country
- `legal_form` (string): GmbH, UG, AG, e.K., Inc., ...
- `name` (string): Legal name of the company, without the legal form
- `own_accounts`: With skr OWN: the expense, clearing and USDC holding accounts of your chart, 4 to 8 digits, and optionally gift_cards for gift card purchases (the expense account otherwise)
- `owner_name` (string): A sole proprietorship (Einzelunternehmen, e.K., sole trader ...): the first and last name of the owner. It stands on every document, never in the register or on a listing. Empty removes it
- `postal_code` (string): Postal code of the registered address
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one
- `skr` (string): Chart of accounts for exports. OWN takes own_accounts
- `sole_proprietor` (boolean): True for one person without a legal form of its own where the country has none to choose. Then owner_name is required
- `tax_number` (string): The national tax number, for vat_status tax_number or where the country asks for it
- `vat_id` (string): VAT id in the format of its country, like DE123456789 or ATU12345678 (GET /v1/countries). EU numbers are checked against VIES
- `vat_status`: How the company stands with VAT: vat_id, tax_number (registered, VAT id still to come), small_business (§ 19 UStG) exempt (only VAT-exempt sales) or not_registered (no VAT registration, the USA or an…

### `company.vat_check` (~93 tokens)

Re-check the VAT id

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.email` (~170 tokens)

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.

Input parameters:

- `action` (string, required): start sets the address and mails a six-digit code, confirm checks the code, remove clears the address
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `code` (string): confirm: the six-digit code from the mail
- `email` (string): start: where documents and notices go
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.invite` (~117 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.join` (~142 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `code` (string, required): The invite code from company.invite
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.agents` (~98 tokens)

Agents of your company

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.agent.update` (~152 tokens)

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.

Input parameters:

- `agent_id` (string, required): The agent to change, from company.agents
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `name` (string): The new name, 1 to 40 characters, unique in the company
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `role` (string): admin or agent
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.agent.remove` (~125 tokens)

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.

Input parameters:

- `agent_id` (string, required): The agent to remove, from company.agents
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.wallet.assign` (~154 tokens)

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.

Input parameters:

- `address` (string, required): A wallet of your company
- `agent_id` (required): The agent that operates it from now on, from company.agents. null leaves the wallet unassigned
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.wallet.label` (~134 tokens)

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.

Input parameters:

- `address` (string, required): A wallet of your company
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `label` (required): The name, up to 40 characters. null clears it
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.members` (~279 tokens)

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. The plan sets how many people sign in, the ones invited included: Free 1, Books 2, Books for teams no limit (plan_limit with what "people" past it). Admins and owners only, except list.

Input parameters:

- `action` (string): list (default) shows the people, invite adds one, role changes a role, remove takes someone out
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `email` (string): invite: the person's email address
- `member_id` (string): role and remove: the person, from list
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `role` (string): invite and role: owner, finance, adviser or viewer
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.requests` (~316 tokens)

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.

Input parameters:

- `action` (string): list (default), show, ask, answer, done, reopen or delete
- `body` (string): ask and answer: the text
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `month` (string): ask, optional: the month it is about, YYYY-MM
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `receipt_id` (integer): ask, optional: the receipt it is about, from receipts.list
- `request_id` (string): show, answer, done, reopen and delete: the request, from list
- `session_token` (string): A lounge session token (lg_...) if you have one
- `status` (string): list: open (default), done or all
- `title` (string): ask: a short title

### `invoices.list` (~129 tokens)

Your company's documents

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `limit` (integer): How many documents, 1 to 200
- `month` (string): Optional: only the documents of this month, YYYY-MM
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `invoices.get` (~130 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `id` (string, required): The document, by id or by its number
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `invoices.issue` (~172 tokens)

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `month` (string): Finished month, default: last month
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `invoices.draft` (~163 tokens)

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `month` (string): The month, YYYY-MM. Default: the current month (Europe/Berlin)
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `invoices.cancel` (~165 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `id` (string, required): Id or number of the document
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `reason` (string, required): Why, 3 to 500 characters. It is written on the cancellation
- `session_token` (string): A lounge session token (lg_...) if you have one

### `company.close` (~263 tokens)

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.

Input parameters:

- `cancel` (boolean): true keeps the company: it cancels a closing that is scheduled
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `export_kept` (boolean): With now: you downloaded the export and keep the records yourself
- `name` (string): The company name, as confirmation
- `now` (boolean): Close at once and delete everything
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `directory.search` (~169 tokens)

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. Free, no account.

Input parameters:

- `filter` (string): all (default), verified for services whose wallet signed, mcp for services with an MCP server
- `limit` (integer): How many services, 1 to 100
- `offset` (integer): How many to skip, for the next page
- `q` (string): Words to look for, e.g. "on-chain data"
- `sort` (string): level (default), new or name

### `directory.get` (~62 tokens)

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.

Input parameters:

- `slug` (string, required): The listing slug, e.g. glassnode

### `directory.claim` (~206 tokens)

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.

Input parameters:

- `address` (string, required): A payTo wallet of the listing
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one
- `slug` (string, required): The listing slug, e.g. glassnode
- `wallet_proof` (object): Second call only: the challenge message the first call returned, and the signature of that wallet over it

### `directory.preview` (~145 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one
- `url` (string, required): One https URL that answers 402 Payment Required

### `directory.submit` (~184 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `contact_email` (string, required): Where we can reach you about the listing. Only for us, never shown
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one
- `url` (string, required): One paid URL of the service. It answers 402 with its payment details

### `billing.get` (~148 tokens)

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `billing.checkout` (~241 tokens)

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.

Input parameters:

- `archive` (string): The archive instead of a plan, monthly or yearly
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `period` (string): month or year. A year costs ten months
- `plan` (string): books for Books, teams for Books for teams
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `billing.portal` (~101 tokens)

Billing portal

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

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `billing.quote` (~301 tokens)

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

Input parameters:

- `archive` (string): The archive, monthly or yearly
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `period` (string): month or year. A year costs ten months
- `plan` (string): books for Books, teams for Books for teams
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `quote_id` (string): Read an offer instead of asking for one
- `seller_check` (string): Slug of your listing, for the seller check
- `session_token` (string): A lounge session token (lg_...) if you have one

### `billing.invoices` (~143 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `id` (string): Optional: one invoice with its full content
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `seller.get` (~138 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `seller.profile` (~316 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `no_register` (boolean): true when the company is in no commercial register
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `register_court`: The court or office that keeps the register, where the country names one: Registergericht in Germany, Firmenbuchgericht in Austria. GET /v1/countries names it per country
- `register_number`: The number in the register, as the register writes it (GET /v1/countries names the register per country)
- `representative_name`: The name of the person who acts for the company. null clears it
- `representative_role`: e.g. Managing director
- `session_token` (string): A lounge session token (lg_...) if you have one
- `show_name` (boolean): With sole_proprietor: whether the register may show the name
- `sole_proprietor` (boolean): true when the company is one person

### `seller.prices` (~204 tokens)

State the prices of a listing

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 your 402 answers. An empty list removes them. Nobody checks them, so state what a buyer really pays.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `listing` (string, required): The listing slug, e.g. glassnode
- `prices` (array, required): Every line of the listing, in the order to show. [] removes them
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `seller.check` (~346 tokens)

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

Input parameters:

- `action` (string, required): start, get, verify, email, confirm_email, checkout or withdraw, as the description explains
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `code` (string): confirm_email: the six-digit code from the mail
- `email` (string): email: an address at the domain of the listing
- `id` (string): The check, from start. Every action but start needs it
- `listing` (string): The listing slug, e.g. glassnode
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `seller.mandate` (~257 tokens)

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.

Input parameters:

- `action` (string, required): get shows the text and whether it is signed, sign signs it (a challenge first), revoke ends it at the end of the month
- `agreement_proof` (object): sign, second call: the challenge message the first call returned, and your wallet's signature over it
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `confirm` (boolean): sign: true, after you read the mandate text from get
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `seller.self_billing` (~218 tokens)

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

Input parameters:

- `action` (string, required): get shows the agreement and whether it is signed, sign signs it (a challenge first), revoke ends it at the end of the month
- `agreement_proof` (object): sign, second call: the challenge message the first call returned, and your wallet's signature over it
- `client` (string): Your client name, e.g. "claude-code 2.1"
- `confirm` (boolean): sign: true, after you read the agreement from get
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `seller.invoices` (~196 tokens)

Documents in your name

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `id` (string): Optional: one document in full, by id or number
- `limit` (integer): How many documents, 1 to 200
- `month` (string): Optional: only this month, YYYY-MM
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `session_token` (string): A lounge session token (lg_...) if you have one

### `seller.invoices.cancel` (~167 tokens)

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.

Input parameters:

- `client` (string): Your client name, e.g. "claude-code 2.1"
- `id` (string, required): The invoice or credit note, by id or number
- `proof` (object): An EIP-4361 message you got from a challenge, signed by your wallet
- `reason` (string, required): Why, 3 to 500 characters. It is written on the cancellation
- `session_token` (string): A lounge session token (lg_...) if you have one

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-402lounge-mcp/mcp#diagnostics

## Score history

- 2026-11-21: 64
- 2026-11-20: 64
- 2026-11-19: 64
- 2026-11-18: 63
- 2026-11-17: 63
- 2026-11-16: 62
- 2026-11-15: 62
- 2026-11-14: 61
- 2026-11-13: 61
- 2026-11-12: 60
- 2026-11-11: 60
- 2026-11-10: 59
- 2026-11-09: 59
- 2026-11-08: 58
- 2026-11-07: 58
- 2026-11-06: 57
- 2026-11-05: 57

## Common questions

### What is the 402lounge MCP server?

402lounge is an MCP server listed in the public MCP registry as com.402lounge/mcp. Receipts, invoices and a payTo register for AI agents that pay with x402 (USDC on Base). This page covers its hosted endpoint (https://mcp.402lounge.com/mcp).

### Is the 402lounge MCP server safe to use?

402lounge scores 64 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the 402lounge MCP server expose?

402lounge exposes 59 tools: lounge.requirements, lounge.terms, lounge.signup, lounge.me, lounge.agent.update, and 54 more. Their descriptions and schemas cost roughly 10,729 tokens of context every time the server is loaded.

### Does the 402lounge MCP server require authentication?

No. We connected to 402lounge without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the 402lounge MCP server still maintained?

402lounge is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the 402lounge MCP server?

VerifyMCP ran 12 checks on 402lounge, covering TLS certificate, Authorization, HSTS header, DNSSEC and 8 more. One item could not be completed, a gap on our side rather than a finding about 402lounge: HTTPS. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://mcp.402lounge.com/mcp
- Website: https://402lounge.com/
- Changelog RSS feed: https://verifymcp.io/servers/com-402lounge-mcp/mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-402lounge-mcp/mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/com-402lounge-mcp/mcp.json
- HTML version of this page: https://verifymcp.io/servers/com-402lounge-mcp/mcp
