> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supersonic.cv/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Connect via the Model Context Protocol for tools that support it.

Supersonic runs a standard MCP server. Clients that support MCP (Claude Desktop, Cursor, Windsurf, Cline) can connect and discover all 62 tools automatically.

<Note>
  If you're using an AI coding agent like Claude Code or Codex, the [CLI](/connect/cli) uses 10–30x fewer tokens per operation since it doesn't load tool schemas into context.
</Note>

## Configuration

Add this to your MCP client config:

```json theme={null}
{
  "mcpServers": {
    "supersonic": {
      "url": "https://mcp.supersonic.cv/",
      "headers": {
        "Authorization": "Bearer supersonic_live_YOUR_KEY"
      }
    }
  }
}
```

Get your API key from the [Supersonic dashboard](https://supersonic.cv/keys).

## What happens when you connect

1. Your client sends `tools/list` and receives 62 tools, each with a full JSON input schema
2. When the agent calls a tool, your client sends `tools/call` with the tool name and parameters
3. The server executes the tool, checks permissions, logs the call, and returns the result

## Permissions

The API key inherits its creator's role:

| Role       | Access        |
| ---------- | ------------- |
| **Owner**  | All tools     |
| **Admin**  | Most tools    |
| **Member** | Standard CRUD |

Tools that require a higher role will return a `permission_denied` error.