# Windsurf + Keel

Paste this into your assistant:

```
Read https://usekeel.io/agents and walk me through connecting Keel (usekeel.io) here, then help me run my first backtest.
```

Add the Keel server to Windsurf and it can search components, compose and validate strategies in the Keel DSL, and run backtests on real Hyperliquid history — from the session you already have open.

- Client: Cognition · Config file · Editor
- Keel MCP server: https://mcp.usekeel.io/mcp
- Guide: https://usekeel.io/agents/windsurf
- Not verified yet: Not yet verified against a Windsurf version. These steps follow Cognition's own documentation, read on 2026-09-16.

## Quick start

1. **Add the Keel server to your config** — Add it to ~/.codeium/windsurf/mcp_config.json.

   ```json
   {
     "mcpServers": {
       "keel": {
         "serverUrl": "https://mcp.usekeel.io/mcp"
       }
     }
   }
   ```

2. **Sign in** — Windsurf asks you to sign in on first use. Sign in with your Keel account on the page that opens; there is no API key to paste.
3. **Check it worked** — Windsurf does not report the connection separately, so the agent's own answer is the check — a connection that is already live is not improved by signing in again.

   Ask the agent — keel_account_status answers with the Keel account the session is signed in as, which nothing but a live connection can return. If the agent says it has no Keel tools, the sign-in did not finish.

   ```
   Use keel_account_status and tell me which Keel account this session is signed in as.
   ```

4. **Ask for a strategy** — The first prompt to try. The agent reads Keel's instructions and starts from the strategy-creation skill.

   ```
   Connect to Keel (usekeel.io), then compose a carry strategy and backtest it.
   ```

## What Windsurf gets

Every client gets the same thing — the tools, the knowledge and the skills — behind one sign-in. Windsurf is no exception.

- **29 tools** — The tool list, with schemas your client reads by name.
- **7 skills** — Keel's own method, loaded the moment the agent needs it, through keel_help in every client.
- **14 knowledge topics** — The DSL reference and the component knowledge base, read by the agent as it works.

## Prompts to try

- Connect to Keel (usekeel.io), then compose a carry strategy and backtest it.
- Search Keel components for a volatility filter and show me how to wire it.
- Fork the Keel library's carry entry and run a backtest on it.
- Summarize my last backtest and tell me what to change next.
- Read https://usekeel.io/agents and tell me what Keel (usekeel.io) is and why I would use it. If I want to try it, tell me how to add it here.

## Troubleshooting

The first request to https://mcp.usekeel.io/mcp answers 401 with sign-in metadata. That is the handshake, not an error: Windsurf opens the Keel consent page, you approve, and the tools appear in the session. Nothing to install and no API key to paste.

**The tools do not appear after connecting**

The sign-in did not finish. Remove and re-add the connection, then sign in or sign up on the Keel page that opens.

**A tool answers with an authentication error**

Reconnect from your client; its OAuth flow refreshes the token. Nothing to install and no key to paste.

**You want to run the strategy on your account**

The agent builds, tests and reads. When you want to run a strategy on your account, it hands it to the Keel app and you take it from there.

## Docs

- Agent setup: https://usekeel.io/docs/agents/setup
- Agent briefing: https://usekeel.io/agents.md
- All agents: https://usekeel.io/agents

## Related guides

- Cursor: https://usekeel.io/agents/cursor
- VS Code: https://usekeel.io/agents/vscode
- Claude: https://usekeel.io/agents/claude