mailsocket SDKs & MCP server

mailsocket is an email-testing API: test inboxes for your app's signup, login and password-reset emails. Email in, JSON out. GET /inboxes/{id}/messages/wait?require=otp blocks and returns the OTP the instant it arrives — no polling, no IMAP. Built for E2E tests, CI, QA, and AI agents testing your app.

For testing apps you own or are authorized to test. Not for creating accounts on services you don't control.

This repo holds the official client packages.

Package	Install	Docs
Python	pip install mailsocket	python/
TypeScript / Node	npm i mailsocket-sdk	typescript/
MCP server (AI agents)	uvx mailsocket-mcp	mcp/

Full docs: mailsocket.app · dash.mailsocket.app/docs/

MCP config

Point any MCP-compatible client (Claude Desktop, Cursor, Claude Code) at the mailsocket-mcp server over stdio:

{
  "mcpServers": {
    "mailsocket": {
      "command": "uvx",
      "args": ["mailsocket-mcp"],
      "env": {
        "MAILSOCKET_API_KEY": "ms_live_..."
      }
    }
  }
}

See mcp/README.md for per-client config file locations and the full tool list.

Examples

examples/playwright/ — a reference Playwright test that fills a signup form with a mailsocket inbox address and blocks on the wait endpoint until the OTP arrives.

License

MIT — see LICENSE.