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

# API Keys

> Use capout_api_keys and capout_select_api_key to inspect or switch the active CapOut key for MCP traffic.

## capout\_api\_keys

Use this tool to see which CapOut API key is currently selected for MCP traffic and any other available live or test keys.

The tool does not expose raw API key values to the model. It returns selection metadata such as labels, ids, status, and whether a key is marked with `mcp=true`.

```json theme={null}
{
  "tool": "capout_api_keys",
  "arguments": {}
}
```

Example output:

```text theme={null}
CAPOUT MCP API KEYS
STATUS: 2 AVAILABLE

Current Key       : LIVE - Production
Selection Mode    : EXPLICIT (mcp=true)
Execution Status  : READY
MCP Selection     : AVAILABLE

[1] LIVE - Production | CURRENT | MCP PIN
ID                : api_key_live
Status            : ACTIVE

[2] TEST - Sandbox
ID                : api_key_test
Status            : ACTIVE
```

## capout\_select\_api\_key by kind

Use `key_kind=live` for live or production traffic:

```json theme={null}
{
  "tool": "capout_select_api_key",
  "arguments": {
    "key_kind": "live"
  }
}
```

Use `key_kind=test` for test traffic:

```json theme={null}
{
  "tool": "capout_select_api_key",
  "arguments": {
    "key_kind": "test"
  }
}
```

If a user says `prod` or `production`, map that to `key_kind=live`.

Selecting a key does not reveal the secret API key value. It updates which stored organization key is marked `mcp=true` for future MCP-authenticated requests.

## capout\_select\_api\_key by explicit id

```json theme={null}
{
  "tool": "capout_select_api_key",
  "arguments": {
    "api_key_id": "api_key_live"
  }
}
```

Example result:

```text theme={null}
CAPOUT MCP API KEY
STATUS: UPDATED

Selected Key      : LIVE - Production
ID                : api_key_live
Status            : ACTIVE
MCP Pin           : YES
```

## No key available yet

If the organization has not created any CapOut API keys yet, create one in the CapOut app first:

```text theme={null}
https://app.capout.ai/settings/api-keys
```