engagelab-sms-mcp

An MCP server that lets AI assistants send SMS messages through EngageLab.

Add it to your MCP client (Cursor, Claude Desktop, etc.) and the AI can send template-based SMS on your behalf.

Prerequisites

• Node.js 18+
• An EngageLab account with SMS API credentials (dev_key and dev_secret)
• At least one approved SMS template in your EngageLab console

Quick Start

Cursor

Go to Settings > MCP, click Add new MCP server, and paste:

{
  "mcpServers": {
    "engagelab-sms": {
      "command": "npx",
      "args": ["-y", "engagelab-sms-mcp"],
      "env": {
        "ENGAGELAB_DEV_KEY": "<your_dev_key>",
        "ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
      }
    }
  }
}

Claude Desktop

Open Settings > Developer > Edit Config and add to mcpServers:

{
  "mcpServers": {
    "engagelab-sms": {
      "command": "npx",
      "args": ["-y", "engagelab-sms-mcp"],
      "env": {
        "ENGAGELAB_DEV_KEY": "<your_dev_key>",
        "ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
      }
    }
  }
}

Other MCP Clients

Any MCP client that supports stdio transport can use this server. Point the command to npx -y engagelab-sms-mcp and pass the two required environment variables.

Available Tools

send_sms

Send SMS messages through EngageLab using a pre-approved template.

Input:

| Field | Type | Required | Description | |-------|------|----------|-------------| | to | string[] | Yes | Target phone numbers (international format recommended, e.g. +8618700001111) | | template.id | string | Yes | Approved EngageLab SMS template ID | | template.params | object | Yes | Template variable values, e.g. {"code": "123456"} |

Example input:

{
  "to": ["+8618700001111"],
  "template": {
    "id": "your-template-id",
    "params": {
      "code": "123456"
    }
  }
}

Output:

| Field | Type | Description | |-------|------|-------------| | success | boolean | Whether the request was accepted | | plan_id | string | EngageLab plan ID for tracking | | total_count | number | Total recipients submitted | | accepted_count | number | Recipients accepted for delivery | | message_id | string | Message identifier (if available) | | message | string | Status or error description | | code | number | EngageLab response code (0 = success) |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | ENGAGELAB_DEV_KEY | Yes | — | Your EngageLab dev key | | ENGAGELAB_DEV_SECRET | Yes | — | Your EngageLab dev secret | | ENGAGELAB_BASE_URL | No | https://smsapi.engagelab.com | API base URL | | ENGAGELAB_REQUEST_TIMEOUT_MS | No | 10000 | Request timeout in milliseconds | | ENGAGELAB_MAX_RETRIES | No | 1 | Max retry attempts for transient failures |

Troubleshooting

Server fails to start with "Missing required environment variable"

• Make sure both ENGAGELAB_DEV_KEY and ENGAGELAB_DEV_SECRET are set in the env block of your MCP client config.

send_sms returns error code 3002 ("invalid template id format")

• Check that your template ID matches an approved template in the EngageLab console.

send_sms returns error code related to template params

• Verify that template.params keys match the variable names defined in your EngageLab template.

SMS not received

• Use international phone number format (e.g. +8618700001111).
• Confirm the template is approved and not suspended.

Links

• EngageLab SMS API Documentation
• Model Context Protocol

License

MIT