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

# Windsurf

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

Windsurf connects to Appeeky over **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="Open the MCP config">
    In Windsurf, open **Settings → Cascade → MCP Servers → Manage → View raw config**, or edit `~/.codeium/windsurf/mcp_config.json` directly.
  </Step>

  <Step title="Add the Appeeky server">
    ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
    {
      "mcpServers": {
        "appeeky": {
          "serverUrl": "https://mcp.appeeky.com/mcp",
          "headers": {
            "Authorization": "Bearer apk_your_key_here"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Refresh">
    Click **Refresh** in the MCP Servers panel and confirm the `appeeky` tools are listed.
  </Step>
</Steps>

## Build with Appeeky

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

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

```
Compare keyword overlap between Headspace (id: 493145008) and Calm (id: 571800810).
What keywords is Calm ranking for that Headspace is missing?
```

```
Which apps gained the most ranks in the top-free chart today?
```

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

## Troubleshooting

* **Tools missing or "not connected"** — click **Refresh** in the MCP Servers panel, then restart Windsurf.
* **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.
* **429 / "rate limit"** — you hit a plan or burst limit. See [Rate Limits](/docs/rate-limits).