Back to Browse

Mailsocket Sdk MCP Server

Developer ToolsLow Risk8.6MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://mcp.mailsocket.app/mcp

Security Report

8.6
Low Risk8.6Low Risk

The mailsocket MCP server is a remote-capable inbox/OTP client that requires a per-request bearer API key, forwards it only to the configured upstream, and includes extensive tests for key leakage, tenant isolation, header hygiene, and concurrency limits. No malicious patterns, hardcoded secrets, or shell execution were observed in the provided code; the only notable items are the truncated scope of the review and minor test-coverage/quality observations. Network access to the mailsocket API is expected for this server's purpose. Package verification found 1 issue.

6 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

mailsocket API key (ms_live_...). Create one in the dashboard or via POST /api/v1/agents/register.Required

Environment variable: MAILSOCKET_API_KEY

Override the API base URL. Defaults to https://dash.mailsocket.app/api/v1.Optional

Environment variable: MAILSOCKET_BASE_URL

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

mailsocket SDKs & MCP server

PyPI - mailsocket PyPI - mailsocket-mcp npm - mailsocket-sdk License: MIT

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.

Reviews

No reviews yet

Be the first to review this server!