MCP
Give AI agents access to Enigma and your connected tools through one MCP endpoint.
The Enigma MCP gateway exposes Enigma, Gmail, Google Calendar and CashiPay as Model Context Protocol servers. Any MCP client, such as Claude, Cursor or your own agent, can connect with your Enigma API key.
- Transport: Streamable HTTP
- URL:
https://mcp.enigma-ai.com/mcp/{id} - Auth:
Authorization: Bearer <API key with the mcp:access scope>
Enigma Platform
The Enigma Platform server acts with your own API key, so it needs no setup. Point your client at its integration ID:
{
"mcpServers": {
"enigma": {
"url": "https://mcp.enigma-ai.com/mcp/6ab8d0f1f815a6bb5ebfb13c",
"headers": { "Authorization": "Bearer <ENIGMA_API_KEY>" }
}
}
}Its tools call the REST API, so the key also needs
the scopes for the tools you use, for example tickets:create.
| Tool | Does |
|---|---|
get_ticket, list_tickets, create_ticket, update_ticket | Tickets |
request_handover | Hand a conversation to a human |
get_conversation_history | Read message history |
send_text_message, send_buttons_message, send_media_message | Send messages |
Other integrations
Gmail, Google Calendar and CashiPay act with your credentials for those services. Connect each
once to create a tool, then use /mcp/{tool_id}. Tools belong to your organization and are
never visible to another one.
| Integration | ID | Tools |
|---|---|---|
| Gmail | 6ab8d0f1f815a6bb5ebfb13d | list_emails, search_emails, get_email, send_email, reply_email, create_draft, list_labels, modify_email |
| Google Calendar | 6ab8d0f1f815a6bb5ebfb13e | list_calendars, check_availability, list_events, get_event, create_event, update_event, delete_event |
| CashiPay | 6ab8d0f1f815a6bb5ebfb13f | create_payment_request, check_payment_status, cancel_payment, get_payment_instructions |
Connect
curl -X POST https://mcp.enigma-ai.com/v1/integrations/<integration ID>/connect \
-H "Authorization: Bearer $ENIGMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Support inbox" }'- Gmail and Google Calendar respond with a
redirect_url. Open it, sign in with Google and approve access. Add"return_url"to the body to be redirected back to your app withtool_idandstatusin the query string; ask Enigma to allow your app's origin first. - CashiPay takes your credentials in
data:{ "data": { "api_key": "…", "webhook_secret": "…", "return_url": "…", "merchant_name": "…" } }. Onlyapi_keyis required.
The response's id is the tool ID and mcp_url the URL to give your MCP client. Google tools
turn active once access is approved.
Manage tools
| Request | Does |
|---|---|
GET /v1/integrations | List integrations and their actions |
GET /v1/tools | List your organization's tools |
GET /v1/tools/{id} | Get one tool |
DELETE /v1/tools/{id} | Disconnect a tool and delete its stored credentials |