Mailfornet

Changelog

New endpoints, features and fixes in the API, the MCP server and the Node client, newest first. Changes are additive. Nothing that works today will break without notice here first.

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.