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

Go to https://check.live-direct-marketing.online/docs.
Contact the operator for a key (self-service issuance coming later).
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

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.
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.
Template change review — compare placement of an old vs new email template across 9 providers in a single agent run.
Shared-IP reputation monitoring — schedule periodic tests and have the agent alert when Spam rate crosses a threshold.
Transactional mail audit — verify that password-reset / receipt emails actually reach the Inbox (not Promotions) on every major provider.

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.

Inbox Check — Email Deliverability TestInbox Check — доставляемость email