flox-mcp

The flox-mcp server gives AI agents grounded, tool-driven access to the FLOX trading framework—covering discovery, strategy development, backtesting, live engine control, and DeFi analytics—without relying on training data.

Discovery & Documentation

• flox_overview – High-level toolkit orientation and canonical workflows

• docs_search – Full-text search across all FLOX documentation

• list_indicators / suggest_indicator – Browse or find indicators by description

• lookup_symbol – Resolve symbols across all language bindings (Python, Node, C-API, etc.)

• list_bindings / list_capi_functions – Browse exports and C-API surface

• lookup_error_code / explain_event – Resolve error codes and event struct fields

Strategy Development & Validation

• scaffold_strategy – Generate starter strategy classes (bar-driven, trade-driven, or hybrid) in Python, Node, Codon, or QuickJS

• init_project – Create a new FLOX project from a template

• get_example – Retrieve CI-validated example code (backtest, connector, indicator, etc.)

• validate_strategy – Static AST analysis for hooks and forbidden patterns

• validate_strategy_no_lookahead – Detect lookahead bias before trusting backtest results

Data & Backtesting

• record_data – Capture live or historical market data into a .floxlog tape

• run_backtest – Run a Python strategy against a CSV in a sandboxed subprocess

• compute_indicator – Run a single indicator over a price array

Live Engine Inspection (Read-Only)

• get_positions, get_open_orders, get_pnl – Read runtime state snapshots

• get_kill_switch – Check if trading is halted and why

• list_strategies / get_strategy_state – List strategies and inspect their state

• get_indicator_values – Live indicator readings inside a running strategy

• get_event_log / explain_decision – Query events and trace causal chains (e.g., why a fill happened)

Live Engine Control (Write, dry-run by default)

• place_order, cancel_order, cancel_all – Order management

• flatten_positions – Close all open positions with market orders

• set_kill_switch – Halt or resume all trading

Replay & Counterfactuals

• replay_window – Sandbox replay over a time window with optional param overrides

• whatif – Counterfactual replay to test "what if" parameter scenarios

DeFi / AMM Analytics

• price_amm_swap – Price a DEX swap (Uniswap v2/v3, Raydium CP) at wei-level precision

• route_amm_swap – Find best execution across multiple AMM venues

• amm_price_impact – Generate a slippage/depth table across trade sizes

• replay_pool_tape – Backtest a DEX LP position by replaying recorded swap history

Implement and run trading strategies via the embedded JavaScript (QuickJS) binding of the FLOX framework. Includes scaffolding support.

Develop and execute trading strategies using Node.js bindings of the FLOX framework. Supports scaffolding and strategy execution.

Run and backtest trading strategies using Python bindings of the FLOX framework. Provides tools for scaffolding strategies, running sandboxed backtests on CSV data, and executing live strategies.