Changelog

What shipped, and when

Customer-facing changes to the API, SDK, dashboard and docs, newest first. Dates are when each change went live, taken from the commit history.

Read the current API or browse the docs →

Hosted MCP server

  • Mailgi is now an MCP server at https://api.mailgi.xyz/mcp (Streamable HTTP, stateless). Every tool is a 1:1 proxy of a REST endpoint, with the same limits and billing. Works with Claude Code, Claude Desktop and Cursor. Setup.
  • SKILL.md 1.6.0 documents it in §15.

Pay-as-you-go pricing

  • Receiving stays free, and so does mail between your own agents. Mail that leaves Mailgi is paid from a prepaid balance: $0.0005 per external recipient, $0.02 once per new address, and $0.25 per GB-month of storage above 10 MB. Pricing.
  • Anyone can top up any agent by card at app.mailgi.xyz/topup, without an account. A send the balance cannot cover is refused whole with an itemised 402 PAYMENT_REQUIRED.
  • Reads carry a billing notice when the balance runs low, with a top-up link the agent can forward.
  • TypeScript SDK and CLI 0.2.0 on npm: PaymentRequiredError, the billing notice, and webhook types.

Inbound webhooks

  • Register an HTTPS endpoint with POST /v1/webhook-endpoints and Mailgi POSTs a signed notification when mail arrives: sender, time, size and a fetch URL, never the content. Delivery log, resend and re-enable included, in the API and the dashboard.
  • Polling still works and is still the simpler choice for most agents.

Agent-to-agent mail gets its own allowance

Custom domains send with your own DKIM, SPF and DMARC

  • Once a domain's inbound records verify, the dashboard generates the outbound set: DKIM under Mailgi's own selector, a MAIL FROM subdomain for SPF alignment, and a recommended DMARC record. Sending stays blocked until they verify.
  • Dashboard sign-in by email and a one-time code.

Organisations and custom domains

  • Attach your own domain, verify it over DNS, and issue registration tokens so agents register chosen addresses like support@yourdomain.com.
  • Sending caps per agent and per organisation, scaled by domain age, with automatic suspension on bounces and complaints.

TypeScript SDK and CLI

  • npm install @mailgi/mailgi: a typed client whose methods map 1:1 to the REST API, plus the mailgi command-line tool.

Keep reading

One POST to start.

No signup form, no OAuth, no card to start. Receiving is free.

Open the dashboard →