mcp-delightloop

Model Context Protocol (MCP) server for Delightloop Manage contacts, campaigns, and webhooks from any AI assistant that supports MCP.

Live server: https://mcp.delightloop.vip

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants (Claude, Cursor, Windsurf, Continue, Cline, Zed, and more) securely connect to external tools and APIs. Once configured, your AI assistant can interact with Delightloop directly — no copy-pasting, no switching tabs.

Prerequisites

• Node.js 18+
• A Delightloop API key → get it from Settings → API Keys

Quick setup (all clients)

Option A — Remote server (no install needed)

Connect directly to the hosted server. Just replace YOUR_API_KEY_HERE:

{
  "mcpServers": {
    "delightloop": {
      "url": "https://mcp.delightloop.vip/sse?apiKey=YOUR_API_KEY_HERE"
    }
  }
}

Option B — Local via npx

Runs the server locally on your machine:

{
  "mcpServers": {
    "delightloop": {
      "command": "npx",
      "args": ["-y", "mcp-delightloop"],
      "env": {
        "DELIGHTLOOP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Paste your key, drop it in the right file for your tool, and restart.

Setup by AI client

Claude Desktop

{
  "mcpServers": {
    "delightloop": {
      "command": "npx",
      "args": ["-y", "mcp-delightloop"],
      "env": {
        "DELIGHTLOOP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop. You'll see a 🔌 icon in the toolbar confirming MCP is active.

Cursor

• Global (all projects): ~/.cursor/mcp.json
• Per-project: .cursor/mcp.json in the project root

{
  "mcpServers": {
    "delightloop": {
      "command": "npx",
      "args": ["-y", "mcp-delightloop"],
      "env": {
        "DELIGHTLOOP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Or via Cursor UI: Settings → Cursor Settings → MCP → Add new global MCP server

Windsurf (by Codeium)

Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "delightloop": {
      "command": "npx",
      "args": ["-y", "mcp-delightloop"],
      "env": {
        "DELIGHTLOOP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Or via Windsurf UI: Windsurf Settings → Cascade → MCP Servers → Add Server

Continue.dev (VS Code / JetBrains)

Config file: ~/.continue/config.json

Add inside the "mcpServers" array:

{
  "mcpServers": [
    {
      "name": "delightloop",
      "command": "npx",
      "args": ["-y", "mcp-delightloop"],
      "env": {
        "DELIGHTLOOP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  ]
}

Cline (VS Code extension)

1. Open VS Code → Cline sidebar → MCP Servers tab → Edit MCP Settings
2. Add to cline_mcp_settings.json:

{
  "mcpServers": {
    "delightloop": {
      "command": "npx",
      "args": ["-y", "mcp-delightloop"],
      "env": {
        "DELIGHTLOOP_API_KEY": "YOUR_API_KEY_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Zed Editor

Config file: ~/.config/zed/settings.json

Add inside the "context_servers" block:

{
  "context_servers": {
    "delightloop": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-delightloop"],
        "env": {
          "DELIGHTLOOP_API_KEY": "YOUR_API_KEY_HERE"
        }
      }
    }
  }
}

Claude Code (CLI)

claude mcp add delightloop \
  -e DELIGHTLOOP_API_KEY=YOUR_API_KEY_HERE \
  -- npx -y mcp-delightloop

Or add to ~/.claude/settings.json under "mcpServers" using the same JSON format as Claude Desktop above.

What you can ask your AI after setup

Once configured, just talk to your AI naturally:

"List all my live campaigns"
"Create a contact — john@acme.com, John Smith, Acme Corp, VP of Sales"
"Add contact_abc123 to campaign camp_xyz789"
"Show me all contacts named Sarah"
"Set up a webhook on https://myapp.com/hooks for campaign.status_changed and recipient.email_sent"
"Bulk import these 50 contacts from this CSV..."
"What campaigns are currently paused?"

Available tools (22 total)

Contacts

Campaigns

Recipients

Enrichment

Gifts

Email

Webhooks

Webhook events available:

• campaign.created · campaign.updated · campaign.status_changed
• campaign.deleted · campaign.recipients_added
• recipient.created · recipient.status_changed
• recipient.email_sent · recipient.feedback_submitted

Authentication

The server reads DELIGHTLOOP_API_KEY from the environment and validates it against the Delightloop API on startup. If the key is missing, invalid, or expired the server exits immediately with a clear error message — no silent failures.

Get your API key from Settings → API Keys in the Delightloop dashboard.

License

MIT © Delightloop