How do I install Mailsocket?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Mailsocket need an API key?

The publisher lists these environment variables: MAILSOCKET_API_KEY, MAILSOCKET_BASE_URL.

What transport does Mailsocket use?

Mailsocket is reached over HTTP.

Mailsocket

by app.mailsocket

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

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Server URL

https://mcp.mailsocket.app/mcp

Credentials from the publisher

MAILSOCKET_API_KEY — mailsocket API key (ms_live_...). Create one in the dashboard or via POST /api/v1/agents/register.
MAILSOCKET_BASE_URL — Override the API base URL. Defaults to https://dash.mailsocket.app/api/v1.

Provider

Add in Claude

Claude opens with the name and URL filled in. You still confirm it there.

Claude Code

claude mcp add --transport http app.mailsocket-mailsocket-mcp https://mcp.mailsocket.app/mcp

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "app.mailsocket-mailsocket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mailsocket.app/mcp"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

Questions

How do I install Mailsocket?: Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Mailsocket need an API key?: The publisher lists these environment variables: MAILSOCKET_API_KEY, MAILSOCKET_BASE_URL.
What transport does Mailsocket use?: Mailsocket is reached over HTTP.
When was Mailsocket last checked?: Last checked 2026-10-16. Email inboxes for AI agents: create an inbox, then block until the OTP or magic link arrives.

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.

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.