Changelog

9 October 2026

MCP server: protocol version 2026-07-28

The MCP server now speaks the stateless 2026-07-28 revision of the protocol next to the older ones. A client on the new version needs no initialize call: each request carries its protocol version in _meta, and server/discover returns the supported versions and capabilities. The Mcp-Method and Mcp-Name headers are checked against the request body, and tools/list says how long it may be cached. Clients on 2025-11-25 and earlier connect exactly as before.

MCP server: output schemas and clearer argument errors

Every tool now publishes an outputSchema, so a client can validate and type the result. A missing or wrong argument comes back as a tool error that names the argument, before the API is called, so it does not use a request. The server also reports its icon, description and website to clients that show them.

27 September 2026

New: pay as you go

Monthly plans are replaced by a prepaid balance. Top up from $5, any amount, and each new inbox costs $0.01; reading mail, waiting for it and pulling codes are free. The free tier is now 250 requests a month and is used first. When the balance is empty, POST /v1/inboxes returns 402 insufficient_balance, and responses carry X-Balance-Cents while the balance is paying. Existing plans keep working until they end.

25 September 2026

New: MCP server for AI agents

https://api.mailfornet.com/mcp lets Claude, Cursor, Windsurf, VS Code and any MCP client create inboxes and read verification codes. It has seven tools, uses the same API key and quota, and needs nothing installed. Setup guide.

New: GET /v1/inboxes/{address}/code

One request waits for a verification code or confirm link and returns just that: {"code": "482913", "link": "https://…"}. Mail with neither, such as a welcome newsletter, is skipped. Supports wait, since, from and subject.

New: code and link extraction on every message

GET /v1/messages/{id} now also returns code, links (each URL with its anchor text) and verificationLink. You no longer need your own regex.

Fixed: since filter

?since= on the messages endpoint could filter out every message, including new ones. It now returns only mail newer than the given time, as documented. This also fixes waitForMessage() and waitForCode() in the Node client, which send since on every call. No upgrade is needed.

New: developer docs

Guides for Playwright, Cypress and Selenium & Python, a webhooks page, code examples in five languages, and a live status page.

24 September 2026

Node client 1.0.2

The npm package now links to its own public source repository, github.com/CodewithAsif396/mailfornet-node.

22 September 2026

New: free tier

100 requests a month and 3 addresses, with no card. Enough to try the API or run a small project.

New: API key controls

Keys can be read-only (GET requests only), can expire on a date you choose, and can be limited to an IP allowlist (IPv4, IPv6 and CIDR ranges). A blocked call does not count against your quota.

New: request log

Your last 14 days of API calls, with status, error code and timing. It's in your account under Request log. You can filter it to errors only.

Node client 1.0.1

npm install mailfornet: createInbox, waitForCode, waitForMessage, webhooks and verifyWebhook, with TypeScript types.

19 September 2026

API launch

REST API at api.mailfornet.com/v1: disposable inboxes with a chosen username and lifetime, long-polling with ?wait=, from/subject filters, HMAC-signed webhooks, idempotency keys, stable error codes, request ids, rate-limit headers and an OpenAPI spec.