MCPModel Context Protocol

Inbox Check · MCP server

Let Claude, Cursor and other MCP-compatible agents run inbox-placement tests as tool calls. We publish ldm-inbox-check-mcp on npm — no install required, your MCP client will npx-run it on demand.

View on GitHub

1 · Get an API key

Go to the REST API docs and contact the operator for an icp_live_... key. You receive it once — store in a secret manager.

2 · 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_..." }
    }
  }
}

Claude Code (CLI)

Add via claude mcp add or edit ~/.config/claude/mcp.json:

claude mcp add inbox-check npx -- -y ldm-inbox-check-mcp \
  --env INBOX_CHECK_API_KEY=icp_live_...

3 · Tools exposed

Tool	Does
inbox_check_create	Create a placement test; returns seeds to send your email to.
inbox_check_status	Per-provider placement, SPF/DKIM/DMARC, screenshots.
inbox_check_list	List your tests with cursor pagination.
inbox_check_delete	Delete a test (and its screenshots).
inbox_check_me	Key metadata + quota usage.

4 · Example prompt

Use inbox-check to create a test against Gmail and Outlook. Give me the seed addresses, then after I tell you I’ve sent my email, poll the status and report where it landed.

The agent will call inbox_check_create, show you the seed addresses, and then inbox_check_status on a loop until placement is resolved.

Environment variables

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