MCP for Hyperliquid

A Hyperliquid MCP server that drives a real backtest engine.

Keel is a Hyperliquid MCP server that gives Claude, Cursor, and any MCP-capable agent 22 MCP tools backed by a real backtest engine. Compose a typed strategy graph, run a deterministic backtest against real Hyperliquid funding and price, deploy the same compiled artifact live.

Why most HL MCP servers fall short

The agent surface for Hyperliquid is mostly empty.

Three patterns dominate today, and none of them give an agent enough surface to do real systematic work. Keel is the one that ships an engine behind the MCP.

Wrapper MCPs

The handful of HL MCP servers on GitHub wrap the Hyperliquid REST API — they expose a price endpoint, an OI endpoint, maybe an order-placement endpoint. There is no backtest engine underneath. The agent stops at "here is the current funding rate" instead of "here is a backtested funding-carry strategy you can deploy."

With Keel

Keel exposes 22 MCP tools backed by a deterministic backtest engine, a typed 182-component DSL, and a live execution path. The agent composes a strategy, backtests it on real Hyperliquid funding + price, and hands back a tearsheet URL.

Hand-rolled servers

Every developer who wants Claude on Hyperliquid ends up writing their own MCP server: a Python script that wraps the SDK, glued to one broker, with a personal API key in the config and no path to live execution. Fragile, undocumented, single-user.

With Keel

pipx install keel-trade ships a maintained MCP binary, browser OAuth 2.1 + PKCE auth, agent-mode detection across Claude / Cursor / Windsurf / Codex, and the same compiled-artifact path live trading already uses.

No-code bot builders

Coinrule, 3Commas, Bitsgap and the older no-code builders predate MCP entirely. They run hosted rule engines behind a web UI; the agent has no surface to drive, and the rule language does not survive contact with a perp venue’s funding mechanics.

With Keel

Keel’s surface is the MCP server — the same surface a person uses through the CLI or the web app. The agent does not run a separate bot; it composes a strategy that the engine executes against real Hyperliquid fills.

Capabilities

Under the hood

Structured strategy engine

Strategies are composable pipelines of typed components. The system validates every connection at edit time — errors caught before you backtest, not after you deploy.

AI built on the same system

AI doesn’t generate code — it composes from the same components you use. It understands valid connections, constraints, and trade-offs. Every strategy it builds is structurally valid.

Detailed backtest reports

Sharpe, Sortino, max drawdown, win rate, trade-by-trade logs. Compare runs side by side. Real fee and slippage modeling.

Version control for strategies

Every edit creates a new version. Compare any two versions side by side. Tag releases, restore previous versions, fork strategies. Your full history, always recoverable.

Auditable execution logs

Every live run is logged — what the strategy calculated, what orders executed, what filled. Full transparency.

Non-custodial by design

Your keys never touch our servers. Keel uses Hyperliquid’s native delegation. Sign once, revoke anytime.

Install

Two commands, then talk to your agent.

The Keel MCP is a local stdio server bound into the keel binary. pipx install keel-trade once; the rest of setup happens inside the agent on the first prompt.

Claude Code

Two commands, then connect

Register the stdio MCP with Claude Code. Auth happens from inside Claude on first prompt.

# install the keel CLI + MCP binary
$ pipx install keel-trade
# register the local stdio MCP
$ claude mcp add keel -- keel mcp serve
# in Claude Code, say:
"Connect to Keel, then backtest a carry strategy."
Cursor

mcp.json registration

Same binary, registered through Cursor’s MCP config file in the project root.

$ pipx install keel-trade
# .cursor/mcp.json
{
"mcpServers": {
"keel": {
"command": "keel",
"args": ["mcp", "serve"]
}
}
}
Headless / CI

Token auth (no browser)

For CI, SSH, Codespaces, or WSL — anywhere the agent and a browser are not on the same machine.

$ pipx install keel-trade
# token from app.usekeel.io/settings?tab=api-keys
$ keel auth login --key $KEEL_API_TOKEN
$ keel status
authenticated · tools: 22 · plan: trader
Sample backtest — driven by Claude via MCP

A real run, composed by the agent.

Claude composed a funding-carry strategy by calling keel_components_search, keel_strategy_compose, and keel_backtest_run through the MCP. Every number below comes from that single agent-driven flow.

Featured · Composed via MCP · Sharpe 2.17

Funding-carry on Hyperliquid perps

Claude composed a funding-carry strategy via the MCP server — short the funding-payers, long the funding-receivers, scaled by realised volatility — then ran a backtest and returned this share URL. Reproduce the same prompt + flow in your own agent. Period: 2024-08-15 → 2026-04-30 (20 mo).

Total return
+79.6%
Sharpe
2.17
Max drawdown
-9.7%
Win rate
48.7%

Verified Keel backtest. Past performance is not indicative of future returns.

Versus the alternatives

Where each MCP option actually sits.

How the alternatives compare. The open-source HL MCP servers on GitHub are useful read-only price wrappers; the SDK is a fine primitive; Coinrule is a no-code bot builder that predates MCP. Keel is the only surface with a real backtest engine behind it and a path to live.

FeatureKeel MCPWrapper MCPs (edkdev, kukapay, mektigboy)HL Python SDKCoinrule
MCP tools exposed22 MCP tools5-15 read-only toolsn/a (REST API)n/a (web only)
Backtest engineDeterministic, Hyperliquid-native, real fees + fundingNoneDIYBacktester limited to spot rules
Backtest-to-live parityYes — same compiled artifact deploys liveNoNo (research only)Separate engines
Typed component library182 components, validated at compose time
Live execution on HL perpsYes — non-custodial via HL delegationOrder-placement only, no strategy mgmtDIYSpot-focused
AuthOAuth 2.1 + PKCE (keel auth login)Personal API key, manualPersonal API keyAccount-based
PricingFree to start; paid plan for liveFree (DIY)Free (DIY)$35/mo+

Competitor surfaces summarized from public GitHub READMEs as of 2026-05-20. “DIY” means the primitive exists but the user wires it up.

FAQ

Common questions

What is an MCP server, and why does it matter for Hyperliquid?

Model Context Protocol (MCP) is the open standard that lets agents like Claude and Cursor call external tools through a typed surface — request a backtest, query components, list accounts — instead of scraping a web UI. Hyperliquid is the perp-focused venue where systematic crypto trading actually clears; the combination matters because every other agent-ready research stack (QuantConnect, Lumibot, AlphaSquared) skips Hyperliquid, and the handful of open-source HL MCP servers on GitHub stop at price-data wrappers.

How do I install the Keel MCP with Claude Code?

Two commands: pipx install keel-trade (or uv tool install keel-trade), then claude mcp add keel -- keel mcp serve. That registers the local stdio MCP with Claude Code. Open Claude and say "Connect to Keel" — the agent calls keel_auth_login, your browser opens to app.usekeel.io for OAuth 2.1 + PKCE consent, tokens land in ~/.keel/config.yaml, and you stay logged in for 30 days. Cursor, Windsurf, and Codex use the same binary with their own mcp.json registration.

What tools does the Keel MCP expose to my agent?

The default toolset spans four domains. Status + auth: keel_status, keel_auth_login, keel_doctor, keel_help. Strategy lifecycle: keel_strategy_compose, keel_strategy_fork, keel_strategy_diff, keel_strategy_get, keel_strategy_search, keel_strategy_delete, keel_strategy_memory_read, keel_strategy_memory_write. Backtest + sharing: keel_backtest_run, keel_backtest_summarize, keel_share_create, keel_audit_list_last, keel_audit_replay. Components + discovery: keel_components_search, keel_components_compose_help. Plus keel_accounts_list. Live-trading tools (deploy, pause, stop) are opt-in via the live scope.

Does the agent run my account autonomously?

No. The agent helps you build the strategy; the compiled strategy runs it. Claude (or Cursor, or Codex) collaborates with you to compose a typed strategy graph and run backtests. Once you deploy, the compiled strategy artifact runs on its own schedule against your Hyperliquid account — the agent is not in the execution loop. Live trading is non-custodial via Hyperliquid native delegation, gated by an OAuth live scope plus a local arming step. Two locks, both required.

What data does the backtest run on?

Hyperliquid 15-minute bars and 1-hour funding rates, the same series the live execution path reads. History depth varies per asset — HYPE starts 2024-12-05, BTC, ETH, and SOL go back further. The verified funding-carry backtest spans 2024-08-15 → 2026-04-30; that share URL is the concrete example of what the engine produces. Funding accrues hourly into the equity curve and is decomposed so you can see price-only return, funding return, and combined return separately.

How does this compare to the open-source HL MCP servers on GitHub?

The comparison table above has the details — short version: the wrappers (edkdev, kukapay, mektigboy and similar) expose 5-15 read-only price and account endpoints. There is no backtest engine behind them, no typed component graph, no path from research to live. Keel is the engine those wrappers would call if the engine existed.

What will you build?

Live on Hyperliquid in minutes.

Get started
Non-custodial
Your keys never leave your wallet. Your strategies run on your account — Keel never holds funds.
Same code, backtest to live
The strategy that passed your backtest is the strategy that trades. Same pipeline, no surprises.
Full visibility
See every position, trade, and decision in real time. Pause anytime. Your account, your control.