Skip to main content

​
Connect to the MCP Server

Supersonic exposes an MCP server that any compatible AI agent can connect to. Once connected, your agent can call any of the 91 available tools.

​
MCP Configuration

Add Supersonic to your MCP client: 
{
  "mcpServers": {
    "supersonic": {
      "url": "https://mcp.supersonic.so/sse",
      "headers": {
        "Authorization": "Bearer <your_api_key>",
        "X-Workspace-Id": "<your_workspace_id>"
      }
    }
  }
}
Get your API key and workspace ID from the Supersonic dashboard.

​
Authentication

Every request requires two pieces of context:
  • API Key — identifies the user. Your agent inherits this user’s role and permissions.
  • Workspace ID — identifies which workspace to operate in. A user can belong to multiple workspaces.

​
Permissions

Your agent’s access is determined by the user role attached to the API key:
RoleLevelAccess
Owner3Everything, including destructive operations
Admin2Most operations, manage integrations
Member1Standard CRUD on records, tasks, views
Each tool declares a required role. If your API key belongs to a member, you cannot call admin-only tools.

​
After Connecting

Once connected, your agent should:
  1. Call objects.list to discover all data types and their fields
  2. Call lists.list to see available pipelines and boards
  3. Start operating — create records, move deals through stages, run analytics
All tool calls return structured results. All mutations are atomic and audit-logged.