ldm-crm-mcp

Multi-tenant CRM + outbound email mailing — as MCP tools.

Lets any Model Context Protocol client (Claude Desktop, Cursor, VS Code, n8n, custom agents) drive the entire LDM platform the way the human web UI does — search and create companies / contacts / leads, manage pipelines, run mailing campaigns with self-approve, anti-spam guardrails, AI generation, exports, webhooks.

UI = MCP: every tool here is a thin wrapper over the same HTTP endpoint that the LDM web UI calls. Authorisation is enforced server-side via scopes attached to your bearer key — your agent gets exactly the permissions you grant.

Install

The server runs as a tiny stdio process — your MCP client spawns it on demand. No port, no daemon.

Claude Desktop

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

{
  "mcpServers": {
    "ldm-crm": {
      "command": "npx",
      "args": ["-y", "ldm-crm-mcp"],
      "env": {
        "LDM_API_KEY": "ldm_pk_..."
      }
    }
  }
}

Cursor / VS Code Continue / any MCP client

Same shape — adjust to whatever config syntax the client uses.

Get a key

curl -X POST https://api.live-direct-marketing.online/v1/signup \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","org":"Your SaaS","use_case":"Automated CRM ops via MCP"}'

The response includes api_key (returned exactly once) and a waitlist_id. Once an admin approves your waitlist entry, your scopes unlock and moderation_status flips to approved.

Full self-approve flow and scope list: https://developers.live-direct-marketing.online/.

What's inside (~30 tools)

| Group | Tools | |---|---| | Discovery | agent_card | | Companies | search_companies, get_company, create_company, update_company | | Contacts | search_contacts, create_contact | | Leads & pipelines | list_pipelines, get_pipeline_stats, create_pipeline, hide_stage, search_leads, create_lead, move_lead, lead_kanban, lead_dossier | | Activities | add_activity | | Dialogs | search_dialogs, dialog_stats, reply_dialog, compose_dialog | | Mailing | create_creative, create_mailing_task, approve_mailing_task (agent self-approve), start_mailing_task, task_analytics | | Anti-spam | add_suppression, check_suppression, add_stop_list, add_marking_pattern | | Custom fields | create_custom_field, set_custom_field_value | | Exports | export_columns, create_export, get_export_status | | Webhooks | create_webhook, list_webhook_deliveries | | AI | list_ai_providers, ai_generate | | Mailing helpers | best_send_time |

The tool inputSchemas mirror the underlying REST DTOs verbatim — see https://developers.live-direct-marketing.online/ for the canonical curl examples.

Configuration

| Env var | Required | Default | Notes | |---|:-:|---|---| | LDM_API_KEY | yes | — | Bearer key starting with ldm_pk_. | | LDM_BASE_URL | no | https://api.live-direct-marketing.online | For self-hosted / staging deployments. |

Develop

git clone https://github.com/live-direct-marketing/ldm-crm-mcp.git
cd ldm-crm-mcp
npm install
npm run build
LDM_API_KEY=ldm_pk_... node dist/index.js  # speaks MCP on stdio

License

MIT © Live Direct Marketing