English Français العربية

mailsocket

السجل الرسمي الإنتاجية

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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)>'
إعداد 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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو mailsocket؟

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

كيف أثبّت mailsocket؟

يعمل كخادم بعيد. في 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)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج mailsocket إلى مفتاح API؟

نعم. يتطلب MAILSOCKET_API_KEY, Authorization، وتضبطها في إعداداته.

هل mailsocket مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون mailsocket؟

ينشره mailsocket. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.