encharge-mcp

MCP server for the Encharge email marketing and automation platform.

Encharge doesn't provide an official MCP server — this is a community implementation covering the full REST API.

Setup

Prerequisites

• Node.js 18+ or Bun
• An Encharge API key

Install

npm install -g encharge-mcp

Or run directly:

npx encharge-mcp

Configure your MCP client

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "encharge": {
      "command": "npx",
      "args": ["-y", "encharge-mcp"],
      "env": {
        "ENCHARGE_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "encharge": {
      "command": "npx",
      "args": ["-y", "encharge-mcp"],
      "env": {
        "ENCHARGE_API_KEY": "your-api-key"
      }
    }
  }
}

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | ENCHARGE_API_KEY | Yes | Your Encharge API key | | ENCHARGE_WRITE_KEY | No | Separate write key for ingest endpoints (falls back to API key) |

Tools

People

| Tool | Description | |------|-------------| | list_people | List all people with pagination and segment filter | | search_people | Search people by text query | | upsert_person | Create or update a person | | get_person | Get a person by email or userId | | delete_person | Permanently delete a person | | unsubscribe_person | Unsubscribe a person from all emails | | alias_person | Change a person's email or userId | | bulk_upsert_people | Upsert multiple people at once |

Tags

| Tool | Description | |------|-------------| | add_tag | Add a tag to a person | | remove_tag | Remove a tag from a person |

Events

| Tool | Description | |------|-------------| | track_event | Track a custom event for a person |

Event Schemas

| Tool | Description | |------|-------------| | list_event_schemas | List all event schemas | | get_event_schema | Get an event schema by ID | | create_event_schema | Create a new event schema | | update_event_schema | Update an event schema | | delete_event_schema | Delete an event schema |

Email

| Tool | Description | |------|-------------| | send_email | Send a transactional email | | list_email_templates | List all email templates | | create_email_template | Create an email template | | get_email_template | Get an email template by ID | | update_email_template | Update an email template | | delete_email_template | Delete an email template |

Segments

| Tool | Description | |------|-------------| | list_segments | List all segments | | create_segment | Create a new segment | | update_segment | Update a segment | | delete_segment | Delete a segment | | get_segment_people | Get all people in a segment |

Broadcasts

| Tool | Description | |------|-------------| | list_broadcasts | List all broadcasts | | create_broadcast | Create a broadcast (draft) | | update_broadcast | Update a broadcast | | delete_broadcast | Delete a broadcast |

Custom Objects

| Tool | Description | |------|-------------| | create_object | Create a custom object | | update_object | Update a custom object | | get_object | Get a custom object by type and ID | | list_objects | List all objects of a type | | delete_object | Delete a custom object |

Fields

| Tool | Description | |------|-------------| | list_fields | List all fields for people or a custom object | | create_field | Create a custom field | | update_field | Update a custom field | | delete_field | Delete a custom field |

Forms

| Tool | Description | |------|-------------| | list_forms | List all forms | | create_form | Create a new form | | delete_form | Delete a form |

Snippets

| Tool | Description | |------|-------------| | list_snippets | List all content snippets | | create_snippet | Create a content snippet | | get_snippet | Get a snippet by ID | | delete_snippet | Delete a snippet |

Account

| Tool | Description | |------|-------------| | get_account_info | Get account info (name, site, timezone, status) |

Notes

• send_email requires the Transactional Email API add-on enabled on your Encharge account. It will not work on standard plans without it.

License

MIT