ldm-inbox-check-mcp

MCP server for Inbox Check — programmatic email deliverability testing across 9 providers (Gmail, Outlook, Yahoo, iCloud, AOL, GMX, T-Online, Mail.ru, Yandex) for AI agents.

📦 npm · 🌐 check.live-direct-marketing.online · ✨ awesome-mcp-servers · 🔍 Glama

Plug real inbox-placement testing into Claude Desktop, Cursor, Windsurf, Cline, or any other MCP-compatible AI client. The server wraps the Inbox Check REST API and exposes 5 tools your agent can call directly — create a test, send your email to the returned seed addresses, and read back per-provider placement (Inbox / Spam / Promotions / Updates), authentication results (SPF, DKIM, DMARC), headers, and screenshots.

Why use this?

• 9 real provider mailboxes — Gmail, Outlook, Yahoo, iCloud, AOL, GMX, T-Online, Mail.ru, Yandex. Not simulations: actual IMAP-backed seed accounts, actual filter verdicts.
• Authentication verification — SPF, DKIM, DMARC alignment reported per delivery, parsed from Authentication-Results headers.
• Folder detection — Inbox, Spam, Promotions, Updates, Social, Forums, Category-specific tabs where providers expose them.
• Screenshots — rendered inbox/spam list view for Gmail, Outlook and others, so the agent can show the user what the recipient sees.
• No flaky scraping — the service runs its own seed mailboxes; your agent only talks to a stable REST API.
• Built for AI agents — strict JSON schema via Zod, deterministic tool names, cursor pagination, idempotent keys.

What it does

Exposes 5 tools that wrap the Inbox Check REST API:

| Tool | Description | | --- | --- | | inbox_check_create | Create a placement test; returns seed addresses to send your email to. | | inbox_check_status | Get per-provider placement, SPF/DKIM/DMARC, screenshots. | | inbox_check_list | List recent tests with cursor pagination. | | inbox_check_delete | Delete a test and its screenshots. | | inbox_check_me | Inspect API key metadata, features, quota usage. |

Install

npx ldm-inbox-check-mcp

No global install needed — Claude Desktop / Cursor / Windsurf / Cline will npx-run it on demand.

Get an API key

1. Go to https://check.live-direct-marketing.online/docs.
2. Contact the operator for a key (self-service issuance coming later).
3. Copy the icp_live_... string — it's shown exactly once.

Configure your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "inbox-check": {
      "command": "npx",
      "args": ["-y", "ldm-inbox-check-mcp"],
      "env": {
        "INBOX_CHECK_API_KEY": "icp_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "inbox-check": {
      "command": "npx",
      "args": ["-y", "ldm-inbox-check-mcp"],
      "env": { "INBOX_CHECK_API_KEY": "icp_live_..." }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "inbox-check": {
      "command": "npx",
      "args": ["-y", "ldm-inbox-check-mcp"],
      "env": { "INBOX_CHECK_API_KEY": "icp_live_..." }
    }
  }
}

Cline (VS Code)

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json (macOS) or the equivalent on your platform:

{
  "mcpServers": {
    "inbox-check": {
      "command": "npx",
      "args": ["-y", "ldm-inbox-check-mcp"],
      "env": { "INBOX_CHECK_API_KEY": "icp_live_..." }
    }
  }
}

Environment variables

| Variable | Required | Default | | --- | --- | --- | | INBOX_CHECK_API_KEY | yes | — | | INBOX_CHECK_BASE_URL | no | https://check.live-direct-marketing.online |

Override the base URL only for self-hosted deployments or testing.

Example prompts

"Use inbox-check to create a test against Gmail, Outlook and Yahoo, then wait 90 seconds and tell me where the email landed."

"List my last 10 inbox-check tests and summarise the spam rate per provider."

"Create a test, I'll send the email, then show me the SPF/DKIM/DMARC results and tell me which record is misaligned."

Use cases

1. Cold-email warm-up QA — before a campaign, send a draft to the seed addresses and have the agent verify Inbox placement on Gmail + Outlook.
2. Authentication debugging — when a domain starts landing in Spam, ask the agent to run a test and point to the failing SPF/DKIM/DMARC check.
3. Template change review — compare placement of an old vs new email template across 9 providers in a single agent run.
4. Shared-IP reputation monitoring — schedule periodic tests and have the agent alert when Spam rate crosses a threshold.
5. Transactional mail audit — verify that password-reset / receipt emails actually reach the Inbox (not Promotions) on every major provider.

Related

• check.live-direct-marketing.online — the hosted Inbox Check service behind this MCP server.
• live-direct-marketing/ldm-sdk-js — official TypeScript SDK + MCP server for LDM.delivery (email delivery API for AI agents).
• live-direct-marketing/awesome-email-deliverability — curated list of tools, resources, and best practices for email deliverability.

License

MIT © Live Direct Marketing