Keel

Build, backtest and paper-run Hyperliquid strategies from your AI assistant.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)

Claude Code

claude mcp add --transport http keel 'https://mcp.usekeel.io/mcp'

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "keel": {
            "type": "http",
            "url": "https://mcp.usekeel.io/mcp"
        }
    }
}

PYPI package keel-trade

Claude Code

claude mcp add keel -- uvx keel-trade==0.9.0 keel mcp serve

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "keel": {
            "command": "uvx",
            "args": [
                "keel-trade==0.9.0",
                "keel",
                "mcp",
                "serve"
            ]
        }
    }
}

MCPB package https://github.com/keel-trade/keel-trade/releases/download/v0.9.0/keel-trade-0.9.0.mcpb

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

keel-trade
What is Keel?
Why agents create strategies, not trade them
Quick start — the hosted MCP, nothing to install
Choose your surface
Install
First conversation with your agent
What the MCP exposes
CLI usage
What you can do with Keel
Documentation
Status
How to contribute / report a bug
Related
License

keel-trade

The Keel CLI and stdio MCP server.

Build and backtest Hyperliquid perpetual-futures strategies with your AI assistant — typed strategy composition and deterministic backtests on real Hyperliquid market history. Running a strategy with real capital happens in the Keel web app.

Website · Product page · Docs · Sample backtest · Discussions

What is Keel?

Keel is a quantitative crypto trading platform built around Hyperliquid — strategy development, backtesting, live execution, and portfolio management on the venue with the deepest on-chain perpetual order book. The full platform includes:

A web app for composing strategies, running backtests, and deploying live (app.usekeel.io)
A deterministic backtest engine with real Hyperliquid funding, price and slippage
Bit-for-bit live execution — the same compiled strategy artifact runs in backtest and on Hyperliquid
A strategy library of documented, forkable trading strategies
A screener + calculator suite at usekeel.io/lab (funding leaderboard, momentum, overfit-check, walk-forward visualizer, more)
This package — keel-trade — the agent-native research surface

This repository is the public mirror of the keel-trade Python package: a single pipx install gives you both a CLI and a stdio MCP server, so the same tools work from a terminal or from any MCP-capable agent.

Why agents create strategies, not trade them

Most agent-trading projects put an LLM in the execution loop. That makes systems slow, inconsistent, and hard to audit. Keel does the opposite:

You ──── compose ────► Strategy graph ──── compile ────► Deterministic artifact
                              ▲                                    │
                              │                                    ▼
                          Agent edits                          Backtest engine
                          via MCP tools                        (real HL data)
                                                                   │
                                                                   ▼
                                                              Live execution
                                                              (same artifact)

Three properties drive the design:

Bit-for-bit parity between backtest and live. Same compiled artifact, same engine, same data path. There is no second implementation that can drift.
Typed composition over freeform code. Strategies are graphs of versioned components. Compile errors catch bugs at author time instead of in production.
Agents compose, the deterministic engine executes. Claude / Cursor / Codex help you build the strategy. They are not in the trade loop.

Quick start — the hosted MCP, nothing to install

Paste one URL into the client you already use. You sign in through your client's own OAuth flow; no API key to copy, no local install.

Hosted endpoint URL: https://mcp.usekeel.io/mcp — one endpoint, a 29-tool research/backtest/read surface, nothing to install. Sign in or sign up on the Keel page that opens (no account needed beforehand); authentication is your MCP client's OAuth flow, never a tool call.

Claude: Customize → Connectors → Add custom connector. Paste https://mcp.usekeel.io/mcp and choose Connect.
ChatGPT: Settings → Security and login → turn on Developer mode (a paid ChatGPT plan; on Business/Enterprise an admin must allow it). Open chatgpt.com/plugins, choose +, give the connector a name and a description, and enter https://mcp.usekeel.io/mcp as the MCP server URL (the /mcp path included).
Claude Code: claude mcp add --transport http keel https://mcp.usekeel.io/mcp. Inside Claude Code run /mcp and choose Authenticate.
Cursor: Add the server to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global): {"mcpServers": {"keel": {"url": "https://mcp.usekeel.io/mcp"}}}. Cursor asks you to sign in on first use.
Codex: codex mcp add keel --url https://mcp.usekeel.io/mcp then codex mcp login keel. Codex opens your browser for the sign-in.
Windsurf: Add the server to Windsurf's mcp_config.json: {"mcpServers": {"keel": {"serverUrl": "https://mcp.usekeel.io/mcp"}}}. Windsurf asks you to sign in on first use.
VS Code: Add the server to .vscode/mcp.json, or open the install link: {"servers": {"keel": {"type": "http", "url": "https://mcp.usekeel.io/mcp"}}}. VS Code asks you to sign in on first use.
Other: Use your client's own add remote / HTTP MCP server flow with https://mcp.usekeel.io/mcp. The first request answers 401 with OAuth 2.1 metadata, so a compliant client discovers the sign-in step by itself.

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.

Setup guide: https://usekeel.io/docs/agents/setup · Per-client runbook: https://usekeel.io/agents

No Keel account yet? Create one free — then connect the endpoint above and ask your agent to build something.

Choose your surface

Keel is one product with several places to use it. The hosted MCP above is the default; this package is the CLI + local MCP path.

You are…	Default path (shown first)	Also works
Using Claude/ChatGPT on web or phone	Hosted endpoint — paste the URL (directory one-click coming)	CLI + local MCP
Working in Claude Code / Cursor / terminal	Hosted endpoint — one command, or paste the URL	CLI + local MCP
Running a strategy from the Keel app	Keel web app (connect an account, review sizing, start it there)	reads on every surface
Trying a strategy forward without a connected exchange account	Paper run (simulated) — Keel web app, or `keel paper` on the CLI	in-app chat, local MCP
Building your own agent/scripts	SDK + API key	CLI
Just browsing/running strategies	Web app + library	hosted endpoint

CLI + local MCP — this package (install below).
SDK + API key — the REST API for building your own agents and scripts.

Per-surface zero-to-first-backtest runbook: usekeel.io/agents.

Install

Claude Desktop — one-click (MCPB)

Download keel-trade-<version>.mcpb from the latest release and drag onto Claude Desktop. Cross-platform single bundle — works on macOS, Windows, and Linux.

The MCPB bundle requires system Python 3.11+ (same prerequisite as the terminal install path below). First launch takes ~10-30 seconds while the bundle pip-installs runtime deps to ~/.keel/mcpb-lib/py3.X/; subsequent launches are instant.

The bundle runs this package's local MCP server: your assistant composes and validates strategies, backtests them on real Hyperliquid history, browses the strategy library, compares runs, and shares results. Sign in once with keel_auth_login. By default it cannot place orders or move funds — running a strategy with real capital happens in the Keel web app, and the local tools that act on a live account stay off unless you enable them and arm them on your machine (details below). Prefer nothing to install? Claude Desktop also works with the hosted connector in the quick start.

Terminal — pipx / uv (Claude Code, Codex, Cursor, Windsurf, etc.)

pipx install keel-trade

uv tool install keel-trade also works. Python 3.11+.

Then register the stdio MCP command with your agent host:

# Claude Code
claude mcp add keel -- keel mcp serve

# Codex
codex mcp add keel -- keel mcp serve

For Cursor, Windsurf, and generic MCP clients, see usekeel.io/keel-mcp#install or the agent setup guide.

First conversation with your agent

After install, sign in once via the agent (no terminal commands needed):

You: "Connect to Keel."

Agent: Calls keel_auth_login. Browser opens to app.usekeel.io, you click Allow, tokens land in ~/.keel/config.yaml. Authenticated for 30 days with transparent refresh.

Then describe what you want:

You: "Find me momentum signals for Hyperliquid top-30 perps and compose a backtest from 2024-08-15 to today."

Agent: Calls keel_components_search → keel_components_get_many → keel_strategy_compose → keel_backtest_run. Returns a share URL with the full tearsheet (equity curve, Sharpe, max drawdown, per-asset attribution).

Concrete example: this share URL is a funding-carry backtest produced through exactly this flow — Sharpe 2.17 over 2024-08-15 → 2026-04-30 on real Hyperliquid data.

What the MCP exposes

The default local toolsets (always, read-only, backtest, share, live-read) span status, auth, components, strategy lifecycle, backtest, audit, accounts, sharing, and read-only live monitoring.

Live-write tools (keel_live_deploy, keel_live_control, keel_live_update) are off unless you opt in with KEEL_TOOLSETS. Even then, going live is a hand-off: keel_live_deploy places no orders and returns a link into the Keel web app, where you choose the account, review sizing, and start the strategy. Acting on a live account from your machine (keel_live_control, or the operator-only direct deploy) also requires local arming (keel arm live set). The hosted connector at mcp.usekeel.io has no live-write tools at all.

Full per-tool reference: usekeel.io/docs/sdk/tool-reference.

CLI usage

Every MCP outcome tool has a CLI mirror. Useful for terminals, SSH sessions, CI, scripts, or agents that prefer subprocess calls:

# Auth + status
keel auth login                      # opens a browser
keel auth login --key "$KEEL_API_KEY"  # CI / SSH / no browser
keel status

# Search components, compose, backtest
keel components search "momentum"
keel strategy compose --source-file my-strategy.py --dry-run
keel backtest run str_abc123 --start-date 2024-08-15 --wait

# Inspect a strategy
keel strategy get str_abc123
keel strategy log str_abc123

Full CLI reference: usekeel.io/docs/sdk/cli-reference.

What you can do with Keel

Task	Surface
Backtest a Hyperliquid strategy — real fees, funding and slippage across the HL perp universe, delisted names included	usekeel.io/hyperliquid-backtest
Screen HL perps — momentum, funding, volume, breakout, regime	usekeel.io/lab
Use AI to build strategies — typed composition, not freeform code	usekeel.io/ai-trading-strategy-builder
Backtest portfolios across the HL universe	usekeel.io/crypto-portfolio-backtesting
Robustness calculators — walk-forward visualizer, Monte Carlo, deflated Sharpe, overfit check	usekeel.io/lab
Run a strategy live from the Keel web app, on your own Hyperliquid account (non-custodial)	usekeel.io/strategy-os
Compare strategies + venues	usekeel.io/compare
Browse documented trading strategies	usekeel.io/strategies

Documentation

Product page: usekeel.io/keel-mcp
Getting started: usekeel.io/docs/getting-started
Agent setup (per host): usekeel.io/docs/agents/setup
CLI reference: usekeel.io/docs/sdk/cli-reference
MCP tool reference: usekeel.io/docs/sdk/tool-reference
REST API reference: usekeel.io/docs/api-reference
Agent instructions (canonical, machine-readable): AGENTS.md

Status

Alpha. The CLI and MCP surface are stable and ship to PyPI on a regular cadence; the underlying engine and component library are actively developed.

Keel measures the strategies you design. It is not investment advice, and backtest results do not predict future returns.

How to contribute / report a bug

See CONTRIBUTING.md. Short version:

Bug report → open an issue using the bug template
Feature request, question, or pattern share → use Discussions
Security issue → email team@usekeel.io (do not open a public issue)
Patches → PRs are welcome; we maintain in a private monorepo so PRs may take longer to land — see CONTRIBUTING for the porting process

License

MIT. See LICENSE.

Built by the Keel Research Team · @usekeelio

Frequently asked questions

What is Keel?

Build, backtest and paper-run Hyperliquid strategies from your AI assistant.

How do I install Keel?

It runs as a remote server. In Claude Code: claude mcp add --transport http keel 'https://mcp.usekeel.io/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Keel need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Keel open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Keel?

It is published by keel-trade. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: keel-trade
Category: AI and agents
Runs: Remote + Local
GitHub stars: ★ 2
License: MIT
Language: Python
Last commit: Oct 14, 2026
Open issues: 0
Version: 0.9.0
Published: Oct 24, 2026

io.github.keel-trade/keel-trade

Similar servers

SwarmMemo Talk with agent swarms: rooms, private messages and paid tasks for AI agents
agentleFS Shared second brain for any AI with agent permissions
Eclipse Duet Dual-control attestation: two distinct agents counter-sign; pair proves attested family...
MCP Server for Excel Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windo...
Eclipse Genesis Agent birth-certificate sealing + out-of-purpose detection, fixture records; detects, n...
Hello, AI Ask your assistant which frontier model to use and get a live, Elo-backed answer.
Autodesk Inventor Parametric 3D modeling in Autodesk Inventor: sketches, features, sheet metal, assemblies
OpenReflex Optional diagnostics MCP server for OpenReflex's ambient project muscle memory.

AI and agents

Keel

Install

Documentation

keel-trade

What is Keel?

Why agents create strategies, not trade them

Quick start — the hosted MCP, nothing to install

Choose your surface

Install

Claude Desktop — one-click (MCPB)

Terminal — pipx / uv (Claude Code, Codex, Cursor, Windsurf, etc.)

First conversation with your agent

What the MCP exposes

CLI usage

What you can do with Keel

Documentation

Status

How to contribute / report a bug

Related

License

Frequently asked questions