Wait for the OTP. One API call.

curl -X PATCH "https://dash.mailsocket.app/api/v1/messages/msg_xxx" \
  -H "Authorization: Bearer ms_live_..." \
  -H "Content-Type: application/json" \
  -d '{"read": true}'
# → 200 {"data": {"id": "msg_xxx", "read": true, ...}}

import requests
from mailsocket import Client

client = Client("***")
requests.post("https://app.example.com/signup", json={"email": "you@in.inboxpipe.net"})
result = client.wait_for_otp("inbox_xxx", timeout=60)  # raises WaitTimeout after 60s
print(result.otp)   # → "482193"

import { MailsocketClient } from "mailsocket-sdk";

const client = new MailsocketClient("***");
await fetch("https://app.example.com/signup", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "you@in.inboxpipe.net" }),
});
const { otp } = await client.waitForOtp("inbox_xxx", { timeout: 60_000 });
console.log(otp);   // → "482193"

# 1. submit your signup form with a mailsocket address
curl -X POST https://app.example.com/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"you@in.inboxpipe.net"}'

# 2. wait up to 25s; repeat while the status is 204
curl "https://dash.mailsocket.app/api/v1/inboxes/inbox_xxx/messages/wait?require=otp&timeout=25" \
  -H "Authorization: Bearer ***"

import time
import requests

requests.post("https://app.example.com/signup", json={"email": "you@in.inboxpipe.net"})

deadline = time.monotonic() + 60
otp = None
while otp is None and time.monotonic() < deadline:
    r = requests.get(
        "https://dash.mailsocket.app/api/v1/inboxes/inbox_xxx/messages/wait",
        params={"require": "otp", "timeout": 25},
        headers={"Authorization": "Bearer ***"},
        timeout=35,
    )
    if r.status_code == 200:
        otp = r.json()["data"]["otp"]   # → "482193"
    elif r.status_code != 204:   # 204 = no code yet, loop again
        r.raise_for_status()

// 1. submit your signup form with a mailsocket address
await fetch("https://app.example.com/signup", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "you@in.inboxpipe.net" }),
});

// 2. wait up to 25s per call; 204 means no code yet, so call again
const url = new URL("https://dash.mailsocket.app/api/v1/inboxes/inbox_xxx/messages/wait");
url.searchParams.set("require", "otp");
url.searchParams.set("timeout", "25");
const deadline = Date.now() + 60_000;
let otp = null;
while (otp === null && Date.now() < deadline) {
  const res = await fetch(url, {
    headers: { Authorization: "Bearer ***" },
  });
  if (res.status === 200) otp = (await res.json()).data.otp;   // → "482193"
  else if (res.status !== 204) throw new Error(`wait failed: ${res.status}`);
}

pip install mailsocket

from mailsocket import Client

client = Client("ms_live_...")
inbox = client.create_inbox()
otp = client.wait_for_otp(inbox["id"]).otp

npm i mailsocket-sdk

import { MailsocketClient } from "mailsocket-sdk";

const client = new MailsocketClient("ms_live_...");
const inbox = await client.createInbox();
const { otp } = await client.waitForOtp(inbox.id);

uvx mailsocket-mcp

{
  "mcpServers": {
    "mailsocket": {
      "command": "uvx",
      "args": ["mailsocket-mcp"],
      "env": { "MAILSOCKET_API_KEY": "ms_live_..." }
    }
  }
}

Requires Python 3.10+. Tools: create_inbox, wait_for_otp, wait_for_link, list_inboxes, list_messages, get_latest, delete_inbox. Listed on the Official MCP Registry as app.mailsocket/mailsocket-mcp.

The same tools are hosted at https://mcp.mailsocket.app/mcp over Streamable HTTP. Send your key as a header on every request. A key in the URL (?api_key=) is rejected.

Claude Code CLI:

claude mcp add --transport http mailsocket https://mcp.mailsocket.app/mcp \
  --header "Authorization: Bearer ***"

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "mailsocket": {
      "url": "https://mcp.mailsocket.app/mcp",
      "headers": { "Authorization": "Bearer ms_live_..." }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "mailsocket": {
      "type": "http",
      "url": "https://mcp.mailsocket.app/mcp",
      "headers": { "Authorization": "Bearer ms_live_..." }
    }
  }
}

The remote server is stateless, with per-key limits of 3 waits and 8 other calls in flight. See how long a wait blocks.

Claude.ai, Claude Desktop connectors and Smithery need OAuth, which is planned but not available yet. Use the local stdio server in those clients.