Skip to main content
MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external tools and data sources. Instead of copy-pasting data into a chat window, the AI can fetch it directly — in real time, with the right context — using tools that you authorize. Think of it as a secure plugin system for AI. Maestra Platform exposes an MCP endpoint that lets an AI assistant — Claude, ChatGPT, and others — query your account data and run analytics tools directly inside your chat session.

​
What you can do with MCP

Once connected, your AI assistant can pull Maestra data on demand — no copy-pasting numbers from reports. Currently available tools:
ToolWhat it does
campaign_reportReturns campaign performance: revenue, orders, sends, delivery rate, open rate, click rate, conversion rate, unsubscribe rate, spam rate, bounce rate. Supports filters by date range, channel, activation type, brand, and goal. Includes summary totals, optional timeline, and per-campaign or per-folder breakdown.
flow_reportReturns flow performance with the same metric set as campaign_report, plus per-flow grouping. Includes summary totals, optional timeline, and per-flow breakdown sorted by your chosen metric.
New tools are added over time. You don’t need to reconnect or reinstall the connector — your AI assistant picks up new tools automatically (an app restart may be needed to refresh the list).

​
Before you start

1

Enable MCP for your account

MCP is off by default. Contact your Maestra Customer Success Manager to request access.
2

Check your permission

You need the MCP Access permission in Maestra Platform. It’s granted by default to Owners, Analysts, and Marketers.
3

Find your account's System Name

It’s the subdomain in your Maestra admin URL. For example, if you log in at demo.maestra.io, your System Name is demo.
Your connector URL: 
https://mcp.omega.maestra.io/c/{accountSystemName}
Replace {accountSystemName} with your account’s actual System Name.
This URL is for configuring your AI assistant — don’t open it in a browser.

​
Connect Claude

Claude (claude.ai, desktop, and mobile apps) supports custom MCP connectors. How you add it depends on your Claude plan:
Go to Customize → Connectors → + → Add custom connector and paste the URL above.See Anthropic’s guide →

​
Connect via Claude Code (terminal)

Run this command: 
claude mcp add \
  --transport http \
  "Maestra CDP" \
  "https://mcp.omega.maestra.io/c/{accountSystemName}"
Or add this block manually to your Claude Code config file: 
"Maestra CDP": {
  "type": "http",
  "url": "https://mcp.omega.maestra.io/c/{accountSystemName}"
}
The server uses OAuth2 — no Bearer token required.

​
Connect ChatGPT

ChatGPT supports MCP connectors in a similar way. Use the same URL above. Refer to OpenAI’s documentation for setup steps in your ChatGPT account.

​
Other AI agents

The MCP spec is open, and other clients (Cursor, Cline, and custom agents) should work with the same URL and OAuth flow. That said, Maestra Platform has only been tested end-to-end with Claude and ChatGPT. Treat other clients as exploratory — not yet a supported integration.

​
Security and data privacy

  • Authentication. The MCP endpoint uses your existing Maestra staff login. The same role-based permissions that apply in the admin panel apply through MCP — if an action requires additional permissions, they’re enforced the same way.
  • No customer PII is exposed. The MCP tools return aggregated performance metrics only. No personal data belonging to your customers is transmitted.
  • No third-party sharing. Maestra does not share your session data with third parties, including LLM providers. The data that passes through your MCP session (request parameters and results) is stored temporarily for debugging and quality improvement, and is purged when your account is offboarded.
  • You control your AI provider’s data policy. How your AI assistant (Claude, ChatGPT, etc.) handles the data it receives is governed by your agreement with that provider — manage this through your Anthropic or OpenAI account settings.

​
Troubleshooting

Make sure the Mcp feature is enabled for your account.
Contact your account Owner to grant you the MCP Access permission.
Restart your AI assistant app. Tool lists refresh on startup.
Only your Claude organization Owner can add connectors for Team/Enterprise plans. Reach out to whoever manages your organization’s Claude account.