flox-foundation/flox-mcp

CI Docs PyPI npm

FLOX

FLOX is an AI-native framework for building trading systems.

Strategies, backtests, paper trading, and live execution sit behind one toolkit. AI agents discover the surface and drive it end-to-end through an MCP control plane. One strategy class runs backtest, paper, and live. Bindings for Python, Node.js, Codon, embedded JavaScript, and a stable C API.

Documentation is available at flox-foundation.github.io/flox

Language bindings

All bindings expose the same strategy API, indicators, order books, backtesting, and data I/O. The C API is the integration point for adding support for any other language.

AI companion

flox-mcp is a Model Context Protocol server that gives AI coding agents (Cursor, Claude Code, Cline) grounded access to the FLOX surface — symbol lookups across bindings, scaffolders, indicator and backtest tools, full-text doc search.

pip install flox-mcp

See the package README for setup and the full tool list.

Connectors

Native exchange connectors (Bybit, Bitget, Hyperliquid, Polymarket) live under connectors/ and build with -DFLOX_BUILD_CONNECTORS=ON. The flag defaults to OFF so a backtest-only or research build doesn't pay the dependency cost. See the connectors README for adapter notes and the optional Polymarket Rust toolchain step.

Build options

The CMake options that gate every optional artefact (bindings, demo, tools, tests, benchmarks, connectors) are catalogued in docs/build/feature-flags.md. Defaults are OFF so a bare cmake -B build produces only the core C++ static library.

Commercial Services

For commercial support, enterprise connectors, and custom development, visit floxlabs.dev.

Contributing

Contributions are welcome via pull requests. Please follow the existing structure and naming conventions. Tests, benchmarks, and documentation should be included where appropriate. Code style is enforced via clang-format. See contributing guide.

License

FLOX is licensed under the MIT License. See LICENSE for details.

Disclaimer

FLOX is provided "as is" without warranty of any kind, express or implied. The authors are not liable for any damages or financial harm arising from its use, including trading losses or system failures. This software is intended for educational and research purposes. Production use is at your own risk. See DISCLAIMER.md for full legal notice.