ahel
Start free

mailsocket SDKs & MCP server

MCP serverCommunication

Lets your agent create a temporary email inbox and wait for verification codes or links to arrive.

Use mailsocket SDKs & MCP server in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add mailsocket SDKs & MCP server and connect your AI. About a minute.

ClaudeChatGPTAhel Desktop

Also: Claude Code · Cursor · Codex

Then ask your AI: use mailsocket SDKs & MCP server

Details

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

mailsocket SDKs & MCP serverStart free
About this server

Email inboxes for AI agents: create an inbox, then block until the OTP or magic link arrives.

Install mailsocket SDKs & MCP server

The server’s own address, for the clients that take one directly. Or connect ahel once and every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user mailsocket-sdks-mcp-server 'https://mcp.mailsocket.app/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://mcp.mailsocket.app/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=mailsocket-sdks-mcp-server&config=eyJ1cmwiOiJodHRwczovL21jcC5tYWlsc29ja2V0LmFwcC9tY3AifQ==

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://mcp.mailsocket.app/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add mailsocket-sdks-mcp-server --url 'https://mcp.mailsocket.app/mcp'

    Run it once, then sign in with codex mcp login mailsocket-sdks-mcp-server if the server asks for an account.

From the project's README

As published by mailsocket/mailsocket-sdk in README.md.

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.

PackageInstallDocs
Pythonpip install mailsocketpython/
TypeScript / Nodenpm i mailsocket-sdktypescript/
MCP server (AI agents)uvx mailsocket-mcpmcp/

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.

Signals

Last commit
Sep 2026
Advanced
Delivery
mailsocket-mcp MCP server → your ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
app-mailsocket-mailsocket-mcp
Source
github.com/mailsocket/mailsocket-sdk
Hosted endpoint
https://mcp.mailsocket.app/mcp

github.com/mailsocket/mailsocket-sdk

More in Communication

agent-native-mail
MCP server · builderio
More in Communicationagent-native-brain
MCP server · builderio
More in Communicationpalisade
MCP server · palisadeemail
More in Communicationimpreza-mcp
MCP server · imprezahost
More in Communicationqr-generator
MCP server · modelcontextprotocol
More in Communicationshipmail-mcp
MCP server · shipmail-to
More in Communication