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

# OpenCode

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

OpenCode connects to Appeeky as a **remote** MCP server 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 MCP server">
    Create or update `opencode.json` in your project root:

    ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "appeeky": {
          "type": "remote",
          "url": "https://mcp.appeeky.com/mcp",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer apk_your_key_here"
          }
        }
      }
    }
    ```

    <Tip>
      You can also use OpenCode's environment syntax to keep the key out of the file: set `"Authorization": "Bearer {env:APPEEKY_API_KEY}"` and export `APPEEKY_API_KEY` in your shell. OpenCode resolves it before the request goes out.
    </Tip>
  </Step>

  <Step title="Restart OpenCode">
    Restart OpenCode so it picks up the new server, then confirm the `appeeky` tools are available.
  </Step>
</Steps>

## Build with Appeeky

Describe what you want in chat and OpenCode calls the right Appeeky tools:

```
Show me the top 10 apps for "meditation" and analyze their ratings and review counts.
```

```
Run a full ASO audit on Duolingo (id: 570060128). What's its score and what should they improve?
```

```
What's happening in the App Store right now?
Show me the latest chart activity for the US free apps chart.
```

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

## Troubleshooting

* **Tools missing or "not connected"** — verify `opencode.json` is valid JSON and restart OpenCode.
* **401 / "authentication required"** — your API key is missing or invalid. Regenerate it at [appeeky.com → Settings → API Key](https://appeeky.com) and update the `Authorization` header. Note the `{env:...}` form is resolved by OpenCode, not the shell — a literal `${VAR}` will fail.
* **429 / "rate limit"** — you hit a plan or burst limit. See [Rate Limits](/docs/rate-limits).