MoEngage offers a hosted Model Context Protocol (MCP) server that enables AI assistants to access your MoEngage campaign data directly. You can search campaigns, analyze performance metrics, review content, and diagnose delivery issues, all through natural language conversations with your preferred AI assistant.
The MoEngage MCP server is currently available as a custom connector. We are actively working to list it on the Claude and ChatGPT marketplaces for one-click installation.
Available Tools
The MoEngage MCP server provides nine read-only tools organized into two categories:
Campaign Search
Search and browse campaigns across channels. Filter by name, status, or campaign ID.
| Tool | Description |
|---|---|
search_email_campaigns |
|
search_push_campaigns |
|
search_sms_campaigns |
|
Supported status filters: DRAFT, SCHEDULED, ACTIVE, PAUSED, COMPLETED, STOPPED
Campaign Analytics
Retrieve performance metrics, delivery diagnostics, and content for your campaigns.
| Tool | Description |
|---|---|
get_campaign_stats |
Fetch aggregate performance statistics - delivery rates, opens, clicks, click-through rate (CTR), and channel-specific metrics. Supports up to 50 campaigns at once. |
get_detailed_campaign_stats |
Fetch comprehensive stats with breakdowns by conversion goals, device/platform, locale, and A/B test variations. |
get_delivery_stats |
Analyze the delivery funnel - reachable users, frequency cap removals, send/delivery failures, and per-platform device stats. |
get_click_performance |
Fetch per-URL click breakdown - see which links were clicked, with total and unique click counts. |
get_device_analytics |
Analyze performance by device dimensions - OEM manufacturer, app version, or device dormancy. Supports multi-dimensional splits. |
get_campaign_content |
Retrieve full campaign content - HTML body for email, message text for push, or SMS template content. |
| info |
Information All analytics tools enforce a maximum date range of 30 days. |
Authentication
The MoEngage MCP server uses OAuth-based authentication tied to your MoEngage account.
When you connect for the first time, you will be redirected to authenticate with your MoEngage credentials. If you are already logged into MoEngage, you will see an authorization prompt requesting permission to access your workspace data.
The authorization screen displays:
- Account - Your MoEngage email
- Workspace - The workspace you are currently logged into
- Role - Your role in the current workspace (for example, Manager, Admin)
- Data Center - Your data center environment
- Permissions requested - The scopes the MCP server requires (for example, Campaigns:read)
Click Accept to grant access.
Key Authentication Behaviors
- The MCP server inherits the environment, workspace, and role of your current MoEngage session.
- Authentication tokens are derived from your active MoEngage session.
- If you log out or switch workspaces in MoEngage, you will be prompted to re-authenticate the MCP connection.
- All data access respects your existing MoEngage role-based permissions.
Setup
https://mcp.moengage.com
- Open Claude Desktop or go to claude.ai.
- In the sidebar, click Settings.
- Under the settings menu, click Connectors.
- Click Add Connector, and then click Custom Connector.
-
Enter the MCP server URL:
https://mcp.moengage.cominfo Information
For the MoEngage docs MCP, add https://www.moengage.com/docs/mcp.
- Click Connect. You will be redirected to authenticate with your MoEngage account.
- After authentication, return to Claude. You should see the MoEngage tools listed under Connectors in Settings.
- Configure Tool permissions to control when Claude can use each tool - choose between Automatic, Ask first, or Disabled for each tool.
Once connected, you can start asking Claude questions like:
- "Show me all active email campaigns"
- "What's the delivery rate for my last push campaign?"
- "Compare click performance across my SMS campaigns from last week"
- Open ChatGPT.
- In the sidebar, click Settings.
- Select Connected apps or Plugins (depending on your plan).
- Click Add, and then choose Custom MCP Connector.
-
Enter the MCP server URL:
https://mcp.moengage.cominfo Information
For the MoEngage docs MCP, add https://www.moengage.com/docs/mcp.
- Click Connect. You will be redirected to authenticate with your MoEngage account.
- After authentication, return to ChatGPT. The MoEngage tools will be available in your conversations.
Once connected, you can start asking ChatGPT questions like:
- "Search for all completed email campaigns with 'Welcome' in the name"
- "Get detailed stats for campaign ID abc123 for the last 7 days"
- "Show me which devices performed best for my latest push campaign"
Example Queries
Here are some things you can ask your AI assistant once connected:
| What you want to do | Example prompt |
|---|---|
| Find campaigns | "List all active push campaigns" |
| Check performance | "What's the CTR for my email campaigns from the last 2 weeks?" |
| Diagnose delivery | "Why did my last push campaign have a low delivery rate?" |
| Analyze A/B tests | "Which variation won in campaign XYZ?" |
| Review content | "Show me the email content for campaign ABC" |
| Device insights | "How does Android vs iOS performance compare for my push campaigns?" |
| Click analysis | "Which links got the most clicks in my latest email campaign?" |
Security and Permissions
- The MCP server provides read-only access to your campaign data. It cannot create, modify, or delete campaigns.
- All data access is scoped to the workspace and role of the authenticated user.
- Data shared with AI assistants is subject to the respective AI provider's data handling policies.
- Review MoEngage's Privacy Policy and Terms of Use for more information.
Limitations
- Date range: Analytics queries are limited to a maximum of 30 days.
-
Batch size:
get_campaign_statssupports up to 50 campaign IDs per request. -
Content size: Email HTML content can be large (10-50KB). The
get_campaign_contenttool should be used only when you need to analyze actual campaign content.
Troubleshooting
Cannot access the MCP server
If you cannot access the MCP server or your campaign data, check your workspace connection. The MCP server inherits the active session from your MoEngage account.
To resolve this issue:
- Verify that you are signed in to the correct MoEngage workspace.
- If you have signed out or switched to a different workspace, re-authenticate your MCP server connection to restore access to your campaign data.
Feedback and Suggestions
Have ideas for new tools or activities you'd like to see in the MoEngage MCP server? We'd love to hear from you.
Reach out to us at product@moengage.com with your suggestions.