Back to Browse

Mailsocket Sdk MCP Server

Developer ToolsLow Risk8.0MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

Test inboxes for AI agents testing your app: block until the OTP or magic link arrives.

About

Test inboxes for AI agents testing your app: block until the OTP or magic link arrives.

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

Security Report

8.0
Low Risk8.0Low Risk

Valid MCP server (2 strong, 2 medium validity signals). 4 known CVEs in dependencies Package registry verified. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 6 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.

env_vars

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

HTTP Network Access

Connects to external APIs or services over the internet.

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 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.

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!