GroupTrack Model Context Protocol (MCP) Server
The GroupTrack CRM Model Context Protocol (MCP) Server bridges modern AI agent platforms—such as Meta Muse, Claude Desktop, Cursor, Windsurf, and custom LLM workflows—directly with GroupTrack CRM.
By standardizing access through the open Model Context Protocol (MCP), AI assistants can dynamically inspect contacts, query sales pipelines, move leads through stages, apply tags, log activities, and manage team tasks using real-time CRM data.
Architecture & How It Works
The GroupTrack MCP server is hosted as a cloud service accessible via Server-Sent Events (SSE):
+-----------------------------------------------------------------------------------+
| AI Agents |
| +-----------------------+ +------------------------------------+ |
| | Remote Cloud Agents | | Desktop & IDE Agents | |
| | (Meta Muse, etc.) | | (Claude Desktop, Cursor, Windsurf) | |
| +-----------+-----------+ +-----------------+------------------+ |
+---------------|--------------------------------------------|----------------------+
| |
+---------------------+----------------------+
| (HTTPS SSE Stream)
v
+-----------------------------------------------------------------------------------+
| GroupTrack Hosted MCP Server |
| https://mcp.grouptrackcrm.com/sse |
| |
| - 17 Built-in Tools for complete CRM operations |
| - Smart name resolution for Pipelines, Stages, and Tags |
| - Session handling and real-time event streaming |
+-----------------------------------------------------------------------------------+
|
| (Authenticated REST API)
v
+-----------------------------------------------------------------------------------+
| GroupTrack CRM REST API (v2) |
| https://api.grouptrackcrm.com/v2/rest |
+-----------------------------------------------------------------------------------+
- SSE Stream Endpoint:
https://mcp.grouptrackcrm.com/sse - Session Message Endpoint:
https://mcp.grouptrackcrm.com/message?sessionId=<SESSION_ID> - Health Check:
https://mcp.grouptrackcrm.com/health
Quick Reference
| Endpoint | Method | Purpose | Auth Required |
|---|---|---|---|
/ | GET | Server info & connection instructions | No |
/health | GET | Health check & service status | No |
/sse | GET | Server-Sent Events stream for AI clients | Yes |
/message | POST | JSON-RPC message endpoint (?sessionId=<UUID>) | Handled via Session |
Authentication & API Keys
Every connection to the GroupTrack MCP server must be authenticated with your GroupTrack API key.
Where to Find Your API Key
- Log in to the GroupTrack CRM web app at https://app.grouptrackcrm.com.
- Go to your Team Profile page: https://app.grouptrackcrm.com/profile/team.
- Under the API section, copy your active API Key (or generate a new one if not yet created).
Supported Authorization Formats
When initiating the /sse connection, the server accepts the API key in any of the following formats:
- Authorization Header (Recommended):
Authorization: Bearer <YOUR_API_KEY> - Custom API Key Headers:
x-api-key: <YOUR_API_KEY>
# or
x-gt-api-key: <YOUR_API_KEY>
# or
api-key: <YOUR_API_KEY> - URL Query Parameter (useful for clients that don't support custom headers):
https://mcp.grouptrackcrm.com/sse?api-key=<YOUR_API_KEY>
If no key or an invalid key is supplied, the server returns 401 Unauthorized with a WWW-Authenticate: Bearer challenge.
Next Steps
- Explore Available Tools — View the full catalog of 17 CRM tools, parameters, and input schemas.
- Connect Meta Muse — Step-by-step instructions to add GroupTrack as a custom connector in Meta Muse.
- Connect Desktop Clients — Configure Claude Desktop, Cursor, and Windsurf via SSE.
- Troubleshooting & FAQ — Common questions and solutions for authentication, sessions, and searches.