English Français العربية

mailsocket

Registre officiel Productivité

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mailsocket 'https://mcp.mailsocket.app/mcp' --header 'Authorization: <Bearer ms_live_... (create a key in the dashboard or via POST /api/v1/agents/register)>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mailsocket": {
            "type": "http",
            "url": "https://mcp.mailsocket.app/mcp",
            "headers": {
                "Authorization": "<Bearer ms_live_... (create a key in the dashboard or via POST /api/v1/agents/register)>"
            }
        }
    }
}
PYPI package mailsocket-mcp
Claude Code 
claude mcp add mailsocket -e 'MAILSOCKET_API_KEY=<your mailsocket_api_key>' -e 'MAILSOCKET_BASE_URL=<MAILSOCKET_BASE_URL>' -- uvx mailsocket-mcp==0.4.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mailsocket": {
            "command": "uvx",
            "args": [
                "mailsocket-mcp==0.4.1"
            ],
            "env": {
                "MAILSOCKET_API_KEY": "<your mailsocket_api_key>",
                "MAILSOCKET_BASE_URL": "<MAILSOCKET_BASE_URL>"
            }
        }
    }
}

Variables d'environnement

  • MAILSOCKET_API_KEY obligatoire secret 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.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. mailsocket SDKs & MCP server
  2. MCP config
  3. Examples
  4. License

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.

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.

Questions fréquentes

Qu'est-ce que mailsocket ?

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

Comment installer mailsocket ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http mailsocket 'https://mcp.mailsocket.app/mcp' --header 'Authorization: <Bearer ms_live_... (create a key in the dashboard or via POST /api/v1/agents/register)>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour mailsocket ?

Oui. Il attend MAILSOCKET_API_KEY, Authorization, à renseigner dans sa configuration.

mailsocket est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient mailsocket ?

Il est publié par mailsocket. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.