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.