AI Agent Integrations

Connect Horizon to AI agents - trade prediction markets, equities, options, and crypto through natural language in Claude Code, Cursor, Claude Desktop, WhatsApp, Telegram, and more.

Horizon SDK exposes its full trading engine via three integration paths:

CLI

Full-featured command-line interface. Discover markets, trade, analyze wallets, and manage funds from the terminal. Supports --json for scripting.

MCP Server

Standard Model Context Protocol server. Works with Claude Code, Cursor, Windsurf, VS Code, and Claude Desktop.

OpenClaw Skill

Plugin for the OpenClaw framework. Works with WhatsApp, Telegram, Discord, and Slack bots. Install from ClawHub: clawhub install horizon-trader

How It Works

All three integrations share a thin tools layer (horizon.tools) that wraps the Engine API. The CLI, MCP server, and OpenClaw skill are interface adapters that delegate to shared tool functions, which in turn call the Horizon Engine (Rust core via PyO3) for risk, orders, feeds, and exchange connectivity.

horizon.tools (shared business logic, 100+ functions)
    |
    +---> horizon.cli        (Click CLI, 40+ commands)
    +---> horizon.mcp_server (MCP server, 25 tools with 241 capabilities)
    +---> horizon.mcp_fund   (MCP fund server, 30 tools)
    +---> OpenClaw skill     (WhatsApp/Telegram bots)

Available MCP Tools

The MCP server exposes 14 individual tools and 12 compound tools (action-dispatch):

Individual tools — most-used trading operations:

Tool	Description
engine_status	PnL, open orders, positions, kill switch, uptime
list_positions	All open positions with entry price and PnL
list_open_orders	Open orders, optionally filtered by market
list_recent_fills	Recent trade fills
submit_order	Place a limit order (buy/sell at a probability price)
cancel_order	Cancel one order by ID
cancel_all_orders	Cancel everything
discover_markets	Search Polymarket or Kalshi for markets
get_market_detail	Full market detail (prices, orderbook, holders)
top_markets	Highest-volume active markets
kelly_sizing	Compute Kelly-optimal position size
get_feed_snapshot	Price/bid/ask for a named feed
activate_kill_switch	Emergency stop - cancels all orders
portfolio_metrics	Portfolio value, exposure, diversification

Compound tools — group related capabilities via action parameter:

Tool	Actions	Description
feed	7	Feed management, health, parity checks
order_management	5	Stop-loss, take-profit, cancel by market, kill switch off
wallet	11	Wallet trades, positions, flow, profiling, signals
analytics	84	Stats, AFML, microstructure, hedging, pricing, bootstrap
scanning	11	Oracle, LLM, whale, sniper scans, arbitrage, stealth execution
unusual_whales	36	Options flow, Congress trades, Greeks, short interest
market_data	24	Polygon.io: OHLCV, snapshots, indicators, options chains
cloud	12	Cloud deploy, monitor, credentials
marketplace	18	Browse, publish, subscribe, purchase strategies
fund	16	Multi-strategy fund management
account	3	Account setup, login, key status

Quick Setup

1. Install with MCP support

   pip install horizon-sdk[mcp]
   # or
   uv pip install horizon-sdk[mcp]
   
2. Set your API key

   export HORIZON_API_KEY="your-key"
   
3. Choose your interface

   Pick a setup guide:

   • CLI - terminal, scripting, uvx
   • Claude Code
   • Cursor / Windsurf / VS Code
   • Claude Desktop
   • OpenClaw (WhatsApp/Telegram)

Environment Variables

The MCP server and OpenClaw skill read configuration from environment variables:

Variable	Required	Default	Description
HORIZON_API_KEY	Yes	-	SDK authentication key
HORIZON_EXCHANGE	No	paper	paper, polymarket, or kalshi
HORIZON_DB	No	-	SQLite path for persistence
POLYMARKET_API_KEY	For Polymarket	-	Polymarket CLOB API key
POLYMARKET_API_SECRET	For Polymarket	-	Polymarket CLOB API secret
POLYMARKET_API_PASSPHRASE	For Polymarket	-	Polymarket CLOB passphrase
POLYMARKET_PRIVATE_KEY	For Polymarket	-	Ethereum private key
KALSHI_API_KEY	For Kalshi	-	Kalshi API key
KALSHI_EMAIL	For Kalshi	-	Kalshi account email
KALSHI_PASSWORD	For Kalshi	-	Kalshi account password
HORIZON_PASSWORD	No	-	Password for programmatic account setup (used by account(action="setup") / account(action="login"))