# Cursor, Windsurf & Cline

> Set up Alpha Ladder's MCP server in editor-based AI clients such as Cursor, Windsurf, and Cline.

Cursor, Windsurf, and Cline all support MCP servers via URL. They connect to Alpha Ladder using the hosted server and authenticate via OAuth 2.0 + PKCE — the same flow as Claude.ai.

## Setup

**1. Add the MCP server**

In your client's MCP or tools settings panel, add a new MCP server with the URL:

```
https://www.alphaladder.hk/mcp
```

The exact location varies by client:

- **Cursor:** Settings → Tools & Integrations → MCP Servers → Add
- **Windsurf:** Settings → MCP → Add Server
- **Cline:** Extension settings → MCP Servers → Add

**2. Authorize**

After adding the URL, the client will initiate the OAuth flow. You will be redirected to the Alpha Ladder consent page — paste your Alpha Ladder API key (`sk-…`) and click **Allow**.

**3. Add SKILL.md to your system prompt (recommended)**

For the best results, paste the contents of `SKILL.md` from the [metacomp-skill](https://github.com/metacomp-ai/metacomp-skill) repository into your client's system prompt or custom instructions field. This gives the AI model structured guidance on when and how to invoke Alpha Ladder tools.

- **Cursor:** Settings → Rules for AI → paste SKILL.md content
- **Windsurf:** Settings → Custom Instructions → paste SKILL.md content
- **Cline:** Extension settings → Custom Instructions → paste SKILL.md content

## Usage

Once connected, ask naturally in your editor conversation:

```
Show my Alpha Ladder account balance.
```

The client will call `get_account_summary` and return the result inline. You can also use Alpha Ladder tools inside agent workflows and automated tasks.

## Notes

- **Auth:** These clients use OAuth 2.0 + PKCE against the hosted MCP server. Token refresh is handled automatically.
- **No local install required:** The hosted MCP server runs on Alpha Ladder's infrastructure — nothing to install locally.
- **Auth details:** see [Authentication — Hosted MCP (OAuth 2.0 + PKCE)](/developers/getting-started/authentication#hosted-mcp-oauth-20--pkce).
