Skip to main content
Glama
mailsocket

mailsocket

Official
by mailsocket
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

mailsocket SDKs & MCP server

mailsocket is an inbox API for OTP and magic-link signup automation: 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 signup automation, E2E tests, and AI agents.

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.

Related MCP server: AgenticMail

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • SandMail — Disposable Email

    brobin002
    A
    license
    A
    quality
    D
    maintenance
    Create disposable email inboxes, extract OTP codes in 15 languages, and receive webhooks — all from your AI agent. One call: create inbox → wait for email → get the verification code. Supports 7 domains, email forwarding, and HMAC-signed webhooks with OTP included in payload. Free tier available.
    8
    5 npm
    MIT
  • AgenticMail by agenticmail

    AgenticMailofficial

    agenticmail
    A
    license
    A
    quality
    A
    maintenance
    Real email and SMS for AI agents. Run a local mail server with disposable inboxes — agents send and receive real email, fetch verification codes, and drive a real inbox without going through any third-party email API.
    100
    229
    MIT

  • courier-mcp

    antonioac1
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to create disposable email inboxes and automatically extract OTPs, magic links, and verification codes from incoming emails.
    10 npm
    MIT

  • voidmail

    voidly-ai
    A
    license
    Not graded
    quality
    D
    maintenance
    Email for AI agents. Create inboxes, send and receive emails without phone or CAPTCHA.
    693 npm
    MIT