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

# Connect your AI tool

> Add Totem to an MCP client and verify that all five tools are available.

export const StatusBadge = ({state = "available", children}) => {
  const labels = {
    available: "Available",
    "early-access": "Early access",
    planned: "Planned",
    internal: "Internal draft"
  };
  return <span className={`totem-status totem-status--${state}`}>
      {children || labels[state] || state}
    </span>;
};

<StatusBadge state="available" />

Add Totem once to the AI tool that works on your game.

## 1. Copy the server config

This block is byte-identical to the landing page:

```json MCP JSON theme={null}
{
  "mcpServers": {
    "totem": {
      "type": "http",
      "url": "https://api.play.totemlabs.io/mcp"
    }
  }
}
```

## 2. Add the API key as a secret header

Create a key in the Totem dashboard. In your client's MCP server settings, add this header to the `totem` connection:

```http theme={null}
Authorization: Bearer ttm_<your-key>
```

Do not put the key in `CLAUDE.md`, `AGENTS.md`, your game archive, or Git.

<CodeGroup>
  ```text Claude Code theme={null}
  Open the project MCP settings.
  Add the shared Totem server block.
  Store the Totem API key in the connection's secure header setting.
  ```

  ```text Cursor theme={null}
  Open the project MCP settings.
  Add the shared Totem server block.
  Store the Totem API key in the connection's secure header setting.
  ```

  ```text Codex theme={null}
  Open the project MCP settings.
  Add the shared Totem server block.
  Store the Totem API key in the connection's secure header setting.
  ```

  ```text Generic HTTP MCP theme={null}
  Server: https://api.play.totemlabs.io/mcp
  Header: Authorization: Bearer ttm_<your-key>
  Transport: stateless HTTP
  ```
</CodeGroup>

## 3. Verify the connection

A working Totem connection exposes exactly these five tools:

```text theme={null}
create_game
request_upload
list_games
publish
get_analytics
```

It also exposes `totem://limits`, `totem://allowed-extensions`, and `totem://build-guide`.

If the tool list is empty, check the URL and Authorization header first.