Documentation
Integrations

MCP Integration

LDM provides an MCP server so you can send email directly from Claude, Cursor, Continue, and other MCP-compatible tools.

What is MCP?

MCP (Model Context Protocol) is an open standard by Anthropic that lets AI applications connect to external tools and data sources through a unified interface. Think of it as a USB-C port for AI — one protocol, many tools.


Installation

Install the LDM MCP server globally:

npm install -g @ldm/mcp-server

Claude Desktop setup

Add LDM to your Claude Desktop configuration. Edit claude_desktop_config.json:

{
  "mcpServers": {
    "ldm": {
      "command": "npx",
      "args": ["-y", "@ldm/mcp-server"],
      "env": {
        "LDM_API_KEY": "ldm_live_sk_abc123..."
      }
    }
  }
}

Restart Claude Desktop after saving. The LDM tools will appear automatically.


Cursor / Continue setup

For Cursor, Continue, or other MCP-compatible editors, add to your MCP configuration:

{
  "mcpServers": {
    "ldm": {
      "command": "npx",
      "args": ["-y", "@ldm/mcp-server"],
      "env": {
        "LDM_API_KEY": "ldm_live_sk_abc123..."
      }
    }
  }
}

Available tools

The LDM MCP server exposes the following tools:

ToolDescription
ldm.send_messageSend an email message with inbox verification.
ldm.check_deliveryCheck the delivery status of a sent message.
ldm.list_creativesList your creatives and their moderation status.
ldm.get_repliesRetrieve replies received for your messages.

Remote MCP (hosted)

Web-based MCP clients — claude.ai custom connectors, ChatGPT developer mode, Gemini custom apps — cannot spawn a local process. For them LDM hosts a remote MCP server (streamable HTTP) with the same tool surface:

https://api.live-direct-marketing.online/mcp
  • claude.ai / Claude Desktop (connectors): Settings → Connectors → Add custom connector → paste the URL and add a request header Authorization: Bearer ldm_...
  • ChatGPT (developer mode) and other clients without custom headers: use the personal URL form https://api.live-direct-marketing.online/mcp/k/<your-key> with authentication set to “None”. The URL embeds your key — treat it as a secret and rotate the key if it leaks.

Sessions are bound to the key they were initialized with; concurrent sessions per key and new-session rates are limited. The local stdio server remains the recommended option for desktop clients.


Example usage in Claude

Once configured, you can ask Claude to send messages directly:

“Send an email to cto@acme.com introducing our infrastructure monitoring tool and ask if they'd like a demo.”

Claude will use the ldm.send_message tool to compose and send the email, then report the message ID and delivery status.


Security note

Always pass your API key via the LDM_API_KEY environment variable. Never hardcode your key in configuration files or commit it to version control. Use a .env file or your system's secret manager.