flox-foundation/flox-mcp
🐍 🏠 - MCP server for the FLOX trading systems framework. 30 tools to run backtests, scaffold strategies, validate for lookahead bias, place orders, query PnL via Claude/Cursor. C++23 core with Python/Node/Codon/QuickJS strategy bindings. Same code from backtest to live (CcxtBroker or native connectors). Install: pip install flox-mcp.
Quick Install
{
"mcpServers": {
"flox-foundation-flox-mcp": {
"command": "npx",
"args": [
"-y",
"flox-foundation-flox-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
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
| Language | Install | Docs |
|---|---|---|
| Python | pip install flox-py | reference |
| Node.js | npm install @flox-foundation/flox | reference |
| Codon | build from source | reference |
| JavaScript (embedded) | bundled with C++ build | reference |
| C API | libflox_capi.so | reference |
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.
Venue
Beyond trading on a market, FLOX can be one: the optional venue/ module adds a matching engine and the machinery around it, so many participants can trade against a single order book. See the venue docs.
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.