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

# Codex

> Connect the Appeeky MCP server to Codex and query live App Store & Google Play intelligence by chat.

Codex connects to Appeeky over **Streamable HTTP** at `https://mcp.appeeky.com/mcp`, authenticated with your API key.

<Note>
  Get your API key from [appeeky.com → Settings → API Key](https://appeeky.com) or the [API Dashboard](https://dashboard.appeeky.com).
</Note>

## Connect Appeeky

<Steps>
  <Step title="Add the Appeeky server">
    Register the server with the Codex CLI:

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    codex mcp add appeeky --transport http https://mcp.appeeky.com/mcp
    ```
  </Step>

  <Step title="Add your API key">
    Codex reads headers from `~/.codex/config.toml`. Add your key there:

    ```toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
    [mcp_servers.appeeky.http_headers]
    Authorization = "Bearer apk_your_key_here"
    ```
  </Step>

  <Step title="Confirm the connection">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    codex mcp list
    ```

    You should see `appeeky` listed.
  </Step>
</Steps>

## Build with Appeeky

Ask Codex in plain language and it calls the right Appeeky tools:

```
What apps are featured on the App Store today?
What's the App of the Day and Game of the Day?
```

```
Find keyword opportunities for Headspace (id: 493145008).
Which keywords should they target next?
```

```
What keywords are trending on the App Store this week?
Show me keywords with the highest growth in the US.
```

See the full [tool reference](/docs/mcp#available-tools) for everything Appeeky exposes.

## Troubleshooting

* **Tools missing or "not connected"** — run `codex mcp list` to confirm the server registered, then restart Codex.
* **401 / "authentication required"** — check the `Authorization` header in `~/.codex/config.toml`. Regenerate your key at [appeeky.com → Settings → API Key](https://appeeky.com) if needed.
* **429 / "rate limit"** — you hit a plan or burst limit. See [Rate Limits](/docs/rate-limits).