Skip to main content
MoEngage offers a hosted Model Context Protocol (MCP) server that lets AI assistants work with your workspace directly. Your assistant can build campaign drafts, create and count segments, read and analyze flows, browse dashboards, and analyze performance — all through natural-language conversation. The MoEngage MCP server is available as a custom connector for any MCP-compatible client. We are actively working to list it on the Claude and ChatGPT marketplaces for one-click installation.
The MoEngage AI Connector (MCP server) is available in DC01, DC02, DC03, and DC04.

​
MCP server URL

Use this URL wherever a client asks for a remote MCP server or custom connector:
For the MoEngage docs MCP (search the documentation site), use https://www.moengage.com/docs/mcp.
The connector runs from the AI provider’s cloud (for example, Anthropic’s cloud for Claude), not from your local device, so the server must be reachable over the public internet. https://mcp.moengage.com is publicly reachable, so no firewall or allowlist changes are needed.

​
Setup

There are two ways to make the connector available:
  • Organization-wide setup — an admin adds MoEngage once for the whole organization, so every member only has to click Connect. Recommended for teams.
  • Personal setup — an individual adds the connector to their own account.
In both cases, each user still authenticates individually with their own MoEngage account, so the assistant only ever sees data and tools that user already has access to.

​
Organization-wide setup (admin, one-time)

Set this up once so anyone in your organization can connect without pasting the URL themselves.
Only a Primary Owner or Owner of a Claude Team or Enterprise organization can add an organization connector.
  1. Go to Settings → Connectors (organization settings).
  2. Click Add.
  3. Enter the MCP server URL: https://mcp.moengage.com.
  4. Leave Advanced settings (OAuth Client ID and Client Secret) blank — MoEngage handles OAuth automatically.
  5. Click Add.
The connector now appears in every member’s Connectors list. Each member clicks Connect once to authenticate with their own MoEngage account.

​
Personal setup (per user)

Use this if you are connecting your own account, or if the connector has not been added organization-wide.
  1. Open Claude Desktop or go to claude.ai.
  2. In the sidebar, click Settings.
  3. Click Connectors.
  4. Click Add custom connector.
  5. Enter the MCP server URL: https://mcp.moengage.com.
  6. Click Add, then Connect. You are redirected to authenticate with your MoEngage account.
  7. After authentication, the MoEngage tools appear under Connectors in Settings.
  8. Configure Tool permissions (Automatic, Ask first, or Disabled) per tool. See Enable the tools you need.

​
Use it in a conversation

After connecting, turn the MoEngage tools on for a chat:
  1. In a new conversation, open the tools or connectors menu (in Claude, the + icon → Connectors).
  2. Toggle MoEngage on.
  3. Ask for what you want in plain language (see Example prompts).

​
Authentication

The MoEngage MCP server uses OAuth-based authentication tied to your MoEngage account. The first time you connect, you authenticate with your MoEngage credentials; if you are already signed in, you see an authorization prompt. The screen shows:
  • Account — your MoEngage email
  • Workspace — the workspace you are currently signed into
  • Role — your role in that workspace (for example, Manager, Admin)
  • Data Center — your data center environment
  • Permissions requested — the scopes the server needs
Click Accept to grant access. MoEngage MCP OAuth authorization screen showing account, workspace, role, data center, and requested permissions

​
Key authentication behaviors

  • The server inherits the environment, workspace, and role of your active MoEngage session.
  • Authentication tokens are derived from your active MoEngage session.
  • If you log out or switch workspaces, you are prompted to re-authenticate.
  • All actions respect your existing MoEngage role-based permissions — including which tools your role can use. Reading data requires read access; building or editing requires the matching create/manage permission.
The authorization screen may list a read scope (for example, campaign read) even though the connector exposes many more tools, including write tools. This is a display limitation, not a restriction on what you can do. Which tools actually run is governed by your MoEngage role and by the tools you enable in your client. See Enable the tools you need.

​
Built for agents

The server is designed so that any AI assistant — not just one vendor’s — can act correctly on the first try. Two capabilities make that possible:
  • discover_schema returns the exact, current request shape for whatever you’re building (required fields, allowed values, a working example) — so the assistant doesn’t guess.
  • get_content_guide serves validated, on-demand guidance for writing content (Jinja personalization, email HTML) — so the content is correct, not trial-and-error.
The MCP builds and validates drafts. Publishing a campaign, and starting or stopping a flow, remain human actions in the MoEngage dashboard for anything the tools don’t explicitly cover.

​
What you can do

Build campaigns

Draft push and email campaigns — including A/B variants, multi-locale, scheduling, segmentation, and content blocks.

Author content

Get validated patterns for Jinja personalization and email HTML, and preview how content renders for sample users.

Manage segments

Create custom segments, browse existing ones, and get live user counts with channel reachability.

Work with flows

Search flows, read their configuration and versions, analyze flow and per-channel performance, and pause or resume them.

Search & review

Find campaigns across every channel; read a campaign’s full configuration and content.

Analyze performance

Pull campaign performance, delivery funnels, click breakdowns, device analytics, and dashboard charts.

Analyze behavior (beta)

Run behavior, funnel, and retention analyses on product events, and discover the events and attributes to use.

​
Available tools

Create, edit, and test-send are supported for Push and Email. Search and analytics work for all channels (Push, Email, SMS, WhatsApp, Webhook); SMS and other non‑Push/Email channels are read-only for campaign creation. Which tools you can use depends on your MoEngage role. If a tool you expect is missing, refresh the tools list.

​
Build a campaign

​
Author content

​
Content blocks

​
Segments

​
Flows

​
Dashboards

​
Search & read

Supported status filters: ACTIVE, DRAFT, EXPIRED, NOT_SENT, PAUSED, SCHEDULED, SENDING, SENT, STOPPED, UNDER_REVIEW, REJECTED.

​
Campaign analytics

All analytics tools enforce a maximum date range of 30 days.

​
Product behavior analytics (beta)

These tools are newer and still in beta — names and response shapes may still change. If you don’t see them yet, refresh the tools list.

​
Catalog discovery

Use these to find the right events and attributes before building a segment or running a behavior analysis.

​
Feedback

​
Building a campaign, step by step

1

Discover the shape

The assistant calls discover_schema for your channel and delivery type to get the exact payload structure.
2

Find the audience

Use find_events / find_user_attributes and create_custom_segment (with start_segment_count to confirm reach) to target the right users.
3

Author the content

For email HTML or Jinja personalization, it calls get_content_guide for validated patterns.
4

Create the draft

create_campaign_draft (or patch_campaign_components to refine an existing draft).
5

Preview personalization

create_personalization_preview confirms the content renders correctly for sample users.
6

Validate

validate_campaign_draft runs the full publish check and reports any field-level issues.
7

Publish

Review and publish the draft from the MoEngage dashboard.

​
Example prompts

​
Known behaviors and limitations

We document known quirks so you and your assistant can work around them instead of hitting them unexpectedly.

​
Enable the tools you need

Write tools (for example, creating campaigns, editing content blocks, creating segments) may be off by default in your client. If the assistant says it lacks access to do something, enable that tool in your client’s connector settings — in Claude, under Settings → Connectors → MoEngage → Tool permissions. Which tools you can enable is still bounded by your MoEngage role.

​
Refresh the tools list

New tools are added to the connector over time. If a newly shipped tool doesn’t appear, refresh the connector’s tools list in your client. If the refresh option isn’t available, disconnect and reconnect (re-authenticate) the MoEngage connector to pick up the latest tools.

​
Other limitations

  • Publishing a campaign is not available through the MCP — drafts are published from the MoEngage dashboard.
  • SMS and other non-Push/Email channels are read-only for creation: searchable and analyzable, but not creatable.
  • Date range for analytics is limited to 30 days per query.
  • Batch size: get_campaign_stats accepts up to 50 campaign IDs per request.
  • Content size: email HTML can be large (10–50 KB); fetch full content deliberately.
  • Campaign-name date format: campaign names often encode dates as DDMMYY (for example, 230326 = 23 March 2026). If analytics return all zeros, check your date range first.
  • Analytics response shape: stats are returned as a single cross-channel structure — metrics that don’t apply to a campaign’s channel come back as 0, not absent. Don’t infer a campaign’s channel from which fields are non-zero.

​
Security and permissions

  • The MCP server can build and validate drafts, create segments, and read and analyze campaigns, flows, and dashboards. It does not publish campaigns — publishing is a human action in the dashboard.
  • Every action is scoped to the workspace and role of the authenticated user. Tools your role lacks permission for are not available to you.
  • Data shared with AI assistants is subject to the respective AI provider’s data-handling policies. MoEngage lists its AI sub-processors (including Anthropic and OpenAI) on its website.
  • Review MoEngage’s Privacy Policy and Terms of Use for more information.

​
Troubleshooting

The server inherits the active session from your MoEngage account.
  1. Verify you are signed in to the correct MoEngage workspace.
  2. If you signed out or switched workspaces, re-authenticate the MCP connection to restore access.
First, make sure the tool is enabled in your client’s connector settings — see Enable the tools you need. Then confirm your MoEngage role has the matching permission (for example, campaign create/manage for build tools). If it’s a newly announced tool, refresh the tools list.
Refresh the connector’s tools list, or disconnect and reconnect the MoEngage connector to re-authenticate. See Refresh the tools list.
Switching the workspace or database on an active connection can briefly error. Wait a short while and re-authenticate — the connection typically succeeds on retry.