MCP Server

The anon.li Model Context Protocol server lets AI agents read and modify your aliases, recipients, and drops through a standard MCP transport. It uses OAuth 2.1 with PKCE, so you never paste an API key into a third-party tool — the agent connects, you approve it from a normal anon.li sign-in, and it gets a short-lived bearer token scoped to your account.

Endpoint

Code

https://anon.li/api/mcp

The transport is Streamable HTTP (the modern MCP transport).

Adding the server to Claude

In Claude Desktop or Claude on the web:

Open Settings → Connectors → Add custom connector.
Set the URL to https://anon.li/api/mcp.
Claude opens a browser tab — sign in to anon.li (and complete 2FA if you have it enabled) and approve the consent screen.
Once connected, ask Claude things like "list my anon.li aliases" or "create a custom alias newsletters@anon.li and forward it to my default recipient."

The same flow works for any MCP-compatible client. With the MCP Inspector:

Document	Path
RFC 8414 — Authorization Server Metadata	`/.well-known/oauth-authorization-server`
RFC 9728 — OAuth Protected Resource Metadata	`/.well-known/oauth-protected-resource`

Tool	What it does
`list_aliases`	List every alias on the account. Returns `id`, `email`, `active`, forwarded/blocked counters, and timestamps. Encrypted labels and notes are intentionally omitted — they are vault-encrypted client-side and unreadable to a third-party client.
`create_alias`	Create an alias. `format: "random"` auto-generates the local part; `format: "custom"` takes `local_part`. Optional `recipient_ids` or `recipient_email` chooses the forwarding destination — defaults to your primary recipient. Labels/notes cannot be set here; edit them from the web UI after creation.
`toggle_alias`	Flip an alias between active and inactive. Accepts an alias ID or the full email address.
`delete_alias`	Permanently delete an alias. Future mail to that address is rejected.

Tool	What it does
`list_recipients`	List your recipient inboxes (the addresses aliases can forward to). Includes `verified` and `is_default` flags.
`add_recipient`	Add a new recipient email. The recipient must click the verification link before any alias can forward to them.

Tool	What it does
`list_drops`	List file drops with metadata only — size, expiry, downloads, max downloads, disabled/taken-down state. Filenames and file contents are end-to-end encrypted and cannot be returned through this API.
`toggle_drop`	Disable or re-enable a drop. Disabled drops reject all downloads until toggled back on.
`delete_drop`	Permanently delete a drop and reclaim its storage quota.

Endpoint

Adding the server to Claude

On this page

OAuth discovery

Tools

Aliases

Recipients

Drops

What the AI cannot see

Quota and rate limits

Account safety

Need help?