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 62 available tools.

​
MCP Configuration

Add Supersonic to your MCP client: 
{
  "mcpServers": {
    "supersonic": {
      "url": "https://mcp.supersonic.cv/",
      "headers": {
        "Authorization": "Bearer <your_api_key>"
      }
    }
  }
}
Get your API key from the Supersonic dashboard.

​
Authentication

Every request requires an API key:
  • API Key — identifies the user and workspace. Your agent inherits this user’s role and permissions. The workspace is derived from the API key automatically.
No additional headers are needed.

​
REST Bridge

If your client does not support MCP natively, you can call tools via the REST bridge: 
POST https://mcp.supersonic.cv/api/developers/mcp/call/
Authorization: Bearer supersonic_live_...
Content-Type: application/json

{
  "tool": "records.list",
  "params": { "object_type_slug": "company" }
}

​
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.