MCP Tool Reference

Generated from keel.tools.outcomes.OUTCOMES and the live Click command tree. Do not edit this file by hand; run python packages/keel-trade/keel-sdk/scripts/generate_agent_reference_docs.py.

Keel currently exposes 32 outcome tools. The default local stdio MCP surface exposes 30 tools, including read-only keel_live_monitor; the 2 live-write tools are opt-in with KEEL_TOOLSETS=always,read-only,backtest,share,live-read,live-write.

KEEL_TOOLSETS=live remains a deprecated compatibility alias for live-read,live-write; new configs should use the explicit split.

MCP is the agent surface. The CLI is the reproducible terminal surface. Outcome tools share names, schemas, handlers, structured errors, and safety annotations across both surfaces.

Outcome Tools

MCP tool	CLI command	Toolset	Scope	Annotations	Required args	Optional args
`keel_accounts_list`	`keel accounts list`	`read-only`	`account.read`	read-only, idempotent	-	`account_id` (string), `limit` (integer), `cursor` (string)
`keel_audit_list_last`	`keel audit list-last`	`read-only`	`audit.read`	read-only, idempotent	-	`n` (integer)
`keel_auth_login`	`keel auth login` (CLI-only implementation)	`always`	`read`	write, idempotent, open-world	-	`scope` (base, live), `api_url` (string)
`keel_backtest_run`	`keel backtest run`	`backtest`	`backtest.create`	write	`strategy_id`* (string), `start_date`* (string)	`end_date` (string), `commit_id` (string), `config` (object), `wait` (boolean), `auto_push` (boolean), `push_message` (string)
`keel_backtest_summarize`	`keel backtest summarize`	`backtest`	`backtest.read`	read-only, idempotent	`backtest_id`* (string)	-
`keel_backtest_watch`	`keel backtest watch`	`backtest`	`backtest.read`	read-only, idempotent	`backtest_id`* (string)	`interval_s` (number), `timeout_s` (integer)
`keel_components_compose_help`	`keel components compose-help`	`read-only`	`component.read`	read-only, idempotent	`name`* (string)	-
`keel_components_detail_batch`	`keel components describe-batch`	`read-only`	`component.read`	read-only, idempotent	`names`* (array)	-
`keel_components_search`	`keel components search`	`read-only`	`component.list`	read-only, idempotent	-	`keyword` (string), `query` (string), `category` (data_loader, data_transform, forecast_composer, forecast_mapper, indicator, position_manager, position_sizer, regime_detector, risk_manager, signal_composer, signal_transform, slot_op, universe_filter), `input_type` (string), `output_type` (string), `after` (string), `before` (string), `limit` (integer)
`keel_doctor`	`keel doctor`	`always`	`audit.read`	read-only, idempotent	-	-
`keel_help`	`keel help`	`always`	`audit.read`	read-only, idempotent	`topic`* (string)	-
`keel_live_control`	`keel live control`	`live-write`	`runner.pause`	write, destructive, open-world	`deployment_id`* (string), `action`* (pause, resume, stop, trigger)	-
`keel_live_deploy`	`keel live deploy`	`live-write`	`runner.create`	write, destructive, open-world	`strategy_id`* (string), `account_id`* (string)	`preview` (boolean), `confirmation_token` (string), `schedule` (string)
`keel_live_monitor`	`keel live monitor`	`live-read`	`runner.read`	read-only, idempotent, open-world	`deployment_id`* (string)	`view` (equity, executions, funding, orders, overview, pnl, portfolio, positions, stats, trades, weights, weights-history), `limit` (integer), `symbol` (string), `side` (string), `start_time` (string), `sort_by` (string), `sort_dir` (string), `cursor` (string)
`keel_share_create`	`keel share create`	`share`	`sharing.create`	write, destructive, open-world	`target_id`* (string)	`target_type` (strategy, backtest), `include_source` (boolean), `permission` (view, fork), `expires_at` (string)
`keel_status`	`keel status`	`always`	`audit.read`	read-only, idempotent	-	-
`keel_strategy_checkout`	`keel strategy checkout`	`backtest`	`strategy.read`	write, open-world	`strategy_id`* (string)	`dir` (string)
`keel_strategy_compose`	`keel strategy compose`	`backtest`	`strategy.create`	write, idempotent, open-world	-	`source` (string), `source_file` (string), `strategy_id` (string), `name` (string), `dry_run` (boolean), `parent_version` (string)
`keel_strategy_delete`	`keel strategy delete`	`backtest`	`strategy.delete`	write, destructive, open-world	`strategy_id`* (string)	-
`keel_strategy_diff`	`keel strategy diff`	`read-only`	`strategy.read`	read-only, idempotent, open-world	`ref_a`* (string), `ref_b`* (string)	`strategy_id` (string)
`keel_strategy_discard`	`keel strategy discard`	`backtest`	`strategy.read`	write, destructive, idempotent	-	`strategy_id` (string)
`keel_strategy_fork`	`keel strategy fork`	`backtest`	`strategy.create`	write, idempotent, open-world	`source`* (string)	`name` (string), `target_workspace_id` (string)
`keel_strategy_get`	`keel strategy get`	`read-only`	`strategy.read`	read-only, idempotent, open-world	`strategy_id`* (string)	`version` (string), `include_source` (boolean), `include_versions` (boolean)
`keel_strategy_log`	`keel strategy log`	`read-only`	`strategy.read`	read-only, idempotent	`strategy_id`* (string)	`limit` (integer)
`keel_strategy_memory_read`	`keel strategy memory-read`	`read-only`	`strategy.read`	read-only, idempotent, open-world	`strategy_id`* (string)	`limit` (integer)
`keel_strategy_memory_write`	`keel strategy memory-write`	`backtest`	`strategy.update`	write, open-world	`strategy_id`* (string), `note`* (string)	`role` (agent, user)
`keel_strategy_pull`	`keel strategy pull`	`backtest`	`strategy.read`	write, idempotent, open-world	-	`strategy_id` (string), `force` (boolean)
`keel_strategy_push`	`keel strategy push`	`backtest`	`strategy.update`	write, open-world	-	`strategy_id` (string), `message` (string), `force` (boolean)
`keel_strategy_restore`	`keel strategy restore`	`backtest`	`strategy.update`	write, open-world	`strategy_id`* (string), `ref`* (string)	`message` (string)
`keel_strategy_search`	`keel strategy search`	`read-only`	`strategy.read`	read-only, idempotent, open-world	-	`query` (string), `tag` (string), `owner` (string), `share_id` (string), `limit` (integer), `cursor` (string)
`keel_strategy_status`	`keel strategy status`	`backtest`	`strategy.read`	read-only, idempotent, open-world	-	`strategy_id` (string), `include_recent` (boolean), `recent_commits` (integer)
`keel_strategy_workspaces`	`keel strategy workspaces`	`read-only`	`strategy.read`	read-only, idempotent	-	-

Tool Descriptions

`always`

keel_auth_login: Run the OAuth 2.1 + PKCE browser-loopback login flow against Keel and persist tokens to ~/.keel/config.yaml so subsequent tool calls are authenticated.
keel_doctor: Diagnose the Keel CLI/MCP installation: auth, API reachability, and active toolsets.
keel_help: Fetch a Keel knowledge document by topic name.
keel_status: Report Keel CLI/MCP status: auth state, API URL, active toolsets, and the list of MCP tools visible under the current KEEL_TOOLSETS.

`read-only`

keel_accounts_list: List your Hyperliquid accounts (id, label, wallet_address, status, account_mode, agent_address, expires_at, attached strategy/deployment).
keel_audit_list_last: Read the most recent N audit events for the current org.
keel_components_compose_help: Fetch the component schema/detail contract for ONE known pipeline component: parameter list, type signature, slot reads/writes, examples, and common pitfalls.
keel_components_detail_batch: Fetch the full spec (schema, parameter list, examples, slot reads/writes, type signature) for SEVERAL components in one call.
keel_components_search: Search the Keel pipeline component catalog by keyword, semantic query, category, input/output type, or position in the pipeline (after/before).
keel_strategy_diff: Compute the structural diff between two strategy sources or two remote strategy versions.
keel_strategy_get: Fetch one strategy by id.
keel_strategy_log: Show commit history for a strategy — sequence number, commit id, parent, source hash, message, timestamp, and tags.
keel_strategy_memory_read: Read agent/user notes attached to a strategy.
keel_strategy_search: Search and list strategies in the current org.
keel_strategy_workspaces: List all locally checked-out strategy workspaces.

`backtest`

keel_backtest_run: Submit a backtest for a strategy over a date range.
keel_backtest_summarize: Summarize a completed backtest: Sharpe / max drawdown / total return / turnover / funding-attribution, plus period info and a presigned results.json URL when the run is complete.
keel_backtest_watch: Poll an existing backtest until it reaches a terminal status or the timeout elapses.
keel_strategy_checkout: Pull a platform strategy into a local workspace so you can edit, validate, and version-control it.
keel_strategy_compose: Create or update a strategy from DSL source.
keel_strategy_delete: Hard-delete a strategy on the platform.
keel_strategy_discard: Remove a local workspace (the checked-out strategy.py + .keel-meta.json).
keel_strategy_fork: Fork a strategy into your org.
keel_strategy_memory_write: Append an agent/user note to a strategy's memory.
keel_strategy_pull: Re-fetch the server HEAD into the local working copy.
keel_strategy_push: Commit local strategy.py changes back to the platform as a new version.
keel_strategy_restore: Restore a historical commit as the new HEAD.
keel_strategy_status: Compare a local workspace's strategy.py against the server's current HEAD.

keel_share_create: Publish a strategy or a backtest result at a public usekeel.io/share/<id> URL.

`live-read`

keel_live_monitor: Read live deployment state: overview, positions, equity, P&L, stats, weights, weights-history, executions, orders, trades, funding events, or portfolio summary.

`live-write`

keel_live_control: Pause, resume, stop, or trigger a manual rebalance on a live deployment.
keel_live_deploy: Deploy a strategy to a live Hyperliquid account.

CLI Equivalents

Outcome commands generated from the registry:

CLI command	MCP tool	Positional args	Options
`keel accounts list`	`keel_accounts_list`	`account_id`	`--format`, `--limit`, `-n`, `--cursor`
`keel audit list-last`	`keel_audit_list_last`	-	`--format`, `--n`
`keel auth login`	`keel_auth_login`	-	`--key`, `--scope`, `--api-url`
`keel backtest run`	`keel_backtest_run`	`strategy_id`	`--format`, `--wait`, `--no-wait`, `--start-date`, `--push-message`, `--end-date`, `--config`, `--commit-id`, `--auto-push`, `--no-auto-push`
`keel backtest summarize`	`keel_backtest_summarize`	`backtest_id`	`--format`
`keel backtest watch`	`keel_backtest_watch`	`backtest_id`	`--format`, `--timeout-s`, `--interval-s`
`keel components compose-help`	`keel_components_compose_help`	`name`	`--format`
`keel components describe-batch`	`keel_components_detail_batch`	`names...`	`--format`
`keel components search`	`keel_components_search`	`keyword`	`--format`, `--query`, `--output-type`, `--limit`, `-n`, `--input-type`, `--category`, `--before`, `--after`
`keel doctor`	`keel_doctor`	-	`--format`
`keel help`	`keel_help`	`topic`	`--format`
`keel live control`	`keel_live_control`	`deployment_id`	`--format`, `--yes`, `--action`
`keel live deploy`	`keel_live_deploy`	`strategy_id`	`--format`, `--yes`, `--schedule`, `--preview`, `--no-preview`, `--confirmation-token`, `--account-id`
`keel live monitor`	`keel_live_monitor`	`deployment_id`	`--format`, `--view`, `--symbol`, `--start-time`, `--sort-dir`, `--sort-by`, `--side`, `--limit`, `-n`, `--cursor`
`keel share create`	`keel_share_create`	`target_id`	`--format`, `--yes`, `--target-type`, `--permission`, `--include-source`, `--no-include-source`, `--expires-at`
`keel status`	`keel_status`	-	`--format`
`keel strategy checkout`	`keel_strategy_checkout`	`strategy_id`	`--format`, `--dir`
`keel strategy compose`	`keel_strategy_compose`	-	`--format`, `--strategy-id`, `--source-file`, `--source`, `--parent-version`, `--name`, `--dry-run`, `--no-dry-run`
`keel strategy delete`	`keel_strategy_delete`	`strategy_id`	`--format`, `--yes`
`keel strategy diff`	`keel_strategy_diff`	-	`--format`, `--strategy-id`, `--ref-b`, `--ref-a`
`keel strategy discard`	`keel_strategy_discard`	`strategy_id`	`--format`, `--yes`
`keel strategy fork`	`keel_strategy_fork`	`source`	`--format`, `--target-workspace-id`, `--name`
`keel strategy get`	`keel_strategy_get`	`strategy_id`	`--format`, `--version`, `--include-versions`, `--no-include-versions`, `--include-source`, `--no-include-source`
`keel strategy log`	`keel_strategy_log`	`strategy_id`	`--format`, `--limit`, `-n`
`keel strategy memory-read`	`keel_strategy_memory_read`	`strategy_id`	`--format`, `--limit`, `-n`
`keel strategy memory-write`	`keel_strategy_memory_write`	`strategy_id`	`--format`, `--role`, `--note`
`keel strategy pull`	`keel_strategy_pull`	`strategy_id`	`--format`, `--force`, `--no-force`
`keel strategy push`	`keel_strategy_push`	`strategy_id`	`--format`, `--message`, `-m`, `--force`, `--no-force`
`keel strategy restore`	`keel_strategy_restore`	`strategy_id`	`--format`, `--ref`, `-r`, `--message`, `-m`
`keel strategy search`	`keel_strategy_search`	-	`--format`, `--tag`, `--share-id`, `--query`, `--owner`, `--limit`, `-n`, `--cursor`
`keel strategy status`	`keel_strategy_status`	`strategy_id`	`--format`, `--recent-commits`, `--include-recent`, `--no-include-recent`
`keel strategy workspaces`	`keel_strategy_workspaces`	-	`--format`

CLI-Only Commands

These commands are intentionally not MCP tools. They handle local setup, credentials, project scaffolding, local context, local arming, and local universe files.

CLI command	Positional args	Options
`keel arm disarm`	-	`--emergency`
`keel arm live set`	-	`--account`, `--ttl`, `--once`, `--renew`
`keel arm status`	-	-
`keel auth logout`	-	-
`keel auth status`	-	-
`keel auth whoami`	-	-
`keel components describe`	`name`	`--format`
`keel components detail`	`name`	`--format`
`keel context add`	`note`	-
`keel context edit`	-	-
`keel context import`	`source`	-
`keel context init`	-	`--force`, `--user`
`keel context show`	-	`--layer`
`keel mcp serve`	-	-
`keel project hooks`	-	-
`keel project init`	-	`--force`
`keel skills list`	-	`--format`
`keel skills show`	`name`	`--format`
`keel universe add-group`	`file`, `name`	`--symbols`
`keel universe categories`	-	-
`keel universe get`	`file`	-
`keel universe instruments`	-	`--market`
`keel universe modify-group`	`file`, `name`	`--add`, `--remove`
`keel universe remove-group`	`file`, `name`	-
`keel universe resolve`	-	`--mode`, `--market`, `--symbols`, `--categories`, `--top-n`, `--exclusions`, `--inclusions`
`keel universe set`	`file`	`--mode`, `--market`, `--symbols`, `--categories`, `--top-n`, `--exclusions`, `--inclusions`

MCP Tool Reference

On this page