Connect to Mail MCP

Mail exposes a stateless Streamable HTTP MCP endpoint. Every request requires a client bearer token.

Remote endpoint

POST https://mail.astrixion.ai/mcp — stateless MCP requests; requires a client bearer token.
GET https://mail.astrixion.ai/health — unauthenticated liveness check.

Missing or invalid credentials return 401. The token is operator-managed and is not published in these docs; obtain it through the team credential channel.

claude mcp add --transport http mail https://mail.astrixion.ai/mcp \
  --header "Authorization: Bearer <MAIL_MCP_TOKEN>"

Tools

`get_inbound_emails`

Read inbound mail, newest first.

argument	type	notes
`to`	string, optional	Filter by recipient (recommended). Without it you read the whole catch-all.
`since`	string, optional	ISO-8601; only mail received after this timestamp.
`limit`	number, optional	Max messages (1–100, default 20).

Each item carries ageSeconds and receivedAgo, so a stale code is easy to skip.

`wait_for_email`

Block until a matching message arrives, then return it — for verification / one-time-code flows.

argument	type	notes
`to`	string	Recipient to wait for.
`since`	string, optional	Only accept mail newer than this (e.g. the moment you requested the code).
`timeoutSeconds`	number, optional	How long to wait (1–120, default 60).

Returns the matches, or an empty list if none arrived within the timeout.

Typical use

Address a labelled recipient

Trigger the signup or code request using a labelled address such as [email protected]. The domain is catch-all, so any label works and keeps this flow's mail separate from everything else.

Wait for the message

Call wait_for_email with that recipient and the moment you made the request. It blocks until a matching message arrives (up to timeoutSeconds).

wait_for_email(to = "[email protected]", since = "<request time, ISO-8601>")

Extract the code

Pull the one-time code or verification link out of the returned subject / text.

Filter by recipient

Always pass to. The domain accepts every address, so an unfiltered read returns the whole catch-all — including unrelated mail and spam.

Cloudflare Email Routing is the MX for astrixion.ai. A catch-all rule sends every message to an Email Worker, which parses it and POSTs {to, from, subject, text, html} to https://mail.astrixion.ai/inbound with the shared X-Mail-Secret. The service stores it; the MCP tools above read it back. This ingest path is infrastructure, not a client API.