@luxalgo/mcp

 

Library · Prop Firms · npm · Endpoint

LuxAlgo MCP is a LuxAlgo open-source project. Official repository: github.com/LuxAlgo/luxalgo-mcp-server.

It puts the LuxAlgo ecosystem behind a single MCP server: an encyclopedia of trading and technical analysis, a live prop-firm directory, a Monte Carlo challenge simulator, and read-only access to your own brokerage accounts. Free and read-only. No API key for anything hosted; the local broker tools use your own keys and never send them anywhere.

claude mcp add --transport http luxalgo https://mcp.luxalgo.com/mcp

What's inside

Area	What you get
Library	The encyclopedia of trading and technical analysis: hundreds of concept pages with formulas, the full indicator catalog with families and tags, and Pine Script sources where publicly served.
Challenge Simulator	The open-source prop-firm-sim Monte Carlo engine, running locally inside the server. Your stats, or your real R-multiple trade series, through a firm's exact ruleset: pass probability with confidence intervals, expected attempts and cost, EV over the funded horizon, optimal-risk sweeps, cross-challenge comparison. Deterministic under seed, every assumption disclosed.
Prop Firm Directory	The live data the simulator draws from: firms, funded-account challenges with their full rulebooks (account sizes, fees, steps, profit splits, drawdown modes, trading restrictions), and current offers.
Brokers (local only)	Read-only access to your own accounts across 16 brokers and exchanges via broker-sdk: balances, positions, trade history, FIFO performance stats. Keys live in your MCP client config as env vars and never leave your machine. The hosted endpoint does not carry these tools, on purpose.

Install

The hosted server is one URL:

https://mcp.luxalgo.com/mcp

Claude Code

claude mcp add --transport http luxalgo https://mcp.luxalgo.com/mcp

Cursor

Use the Install in Cursor button above, or add this to .cursor/mcp.json:

{
  "mcpServers": {
    "luxalgo": {
      "url": "https://mcp.luxalgo.com/mcp"
    }
  }
}

Any other MCP client

Point your client's MCP config at the hosted URL:

{
  "mcpServers": {
    "luxalgo": {
      "url": "https://mcp.luxalgo.com/mcp"
    }
  }
}

Where each client keeps its config

Client	Where to add it
Cursor	.cursor/mcp.json, or the install button above
Claude Desktop	claude_desktop_config.json
VS Code	Install button above, or MCP settings
Windsurf	~/.codeium/windsurf/mcp_config.json
Zed	settings.json under context_servers
Warp	Settings → Agents → MCP servers
LM Studio	mcp.json
OpenCode	opencode.json
Gemini CLI	~/.gemini/settings.json

Local (stdio)

Runs every hosted tool locally, and unlocks the broker tools. Set read-only credential env vars for the brokers you use. Any subset works: a broker connects when all of its vars are set, and with no vars at all the broker tools simply stay unconfigured.

{
  "mcpServers": {
    "luxalgo": {
      "command": "npx",
      "args": ["-y", "@luxalgo/mcp"],
      "env": {
        "BROKERS_ALPACA_API_KEY": "…",
        "BROKERS_ALPACA_API_SECRET": "…",
        "BROKERS_KRAKEN_API_KEY": "…",
        "BROKERS_KRAKEN_API_SECRET": "…",
        "BROKERS_HYPERLIQUID_WALLET_ADDRESS": "0x…"
      }
    }
  }
}

Env var names derive from each broker's credential fields: BROKERS_<BROKER>_<FIELD> (for example BROKERS_OKX_PASSPHRASE, BROKERS_IBKR_FLEX_FLEX_TOKEN). The broker_setup tool lists every supported broker, its exact variables, and a one-line guide to creating each key with read-only scope, which is all this server ever needs.

Tools

Library

Tool	Description
library_search	One search over concepts (alias-aware) and indicators
library_get_concept	Full concept page as markdown
library_get_indicator	Indicator detail: body, family, concepts, source code availability
library_get_source_code	Full source code when publicly served, fetched only on demand
library_list_concepts	Paginated concept roster, optionally per family
library_list_indicators	Filtered, paginated browse (family, concept, tags, platform, tier) with server-side sort
library_list_tags	The indicator tag vocabulary, for the tags filter
library_list_families	The taxonomy backbone with counts
library_get_family	A family hub as markdown plus concept roster

Library outputs are compact JSON with canonical urls for citation. Concept and family pages are also directly fetchable as markdown: append .md to any concept URL.

Prop Firms

The challenge simulator, running locally inside the server:

Tool	Description
propfirms_list_simulatable	Every simulatable firm and challenge in the live directory, provenance-disclosed
propfirms_challenge_rules	One challenge's full encoded ruleset (drawdown modes, consistency, payout gating, citations), editable and re-simulatable inline
propfirms_simulate	Monte Carlo of your stats (win rate, avg win, trades/day, risk sizing) through a firm's exact ruleset and funded horizon: pass probability with CI, which rule kills attempts, expected attempts and cost, EV, payout probability
propfirms_simulate_trades	Same, from your real R-multiple trade series; block bootstrap preserves your streaks
propfirms_optimal_risk	Risk sweep: pass-optimal vs EV-optimal risk per trade (they differ)
propfirms_compare	Same trader across up to 12 challenges, EV-sorted (not a ranking)
propfirms_pass_rates	The site's reference-archetype odds, recomputed live (seed 42, 10k paths)
propfirms_validate_strategy	Screen one strategy across every simulatable challenge against an explicit pass bar

Every simulation result carries its assumptions, unsimulated-rule flags, seed, and engine version. Results are distributions under stated assumptions, never promises. The engine runs locally; firm rules adapt live from the directory, and inline specs simulate fully offline.

The directory the simulator draws from, queryable directly:

Tool	Description
propfirms_search	Search firms; firm filters (platforms, markets, payments, Trustpilot, country availability) compose with nested challenge and offer filters, and include nests matching children
propfirms_get	One firm's full dossier: profile, every challenge, live offers, written overview
propfirms_search_challenges	Search challenges by rules (size, fee, steps, profit split, drawdown, trading restrictions) and parent firm; can attach applicable live offers
propfirms_search_offers	Current discounts and promo codes, resolvable per firm or per challenge

Brokers (local stdio only)

Tool	Description
broker_setup	Supported brokers, their env vars (set or unset, never values), read-only key guides
broker_accounts	Connected accounts: broker, currency, equity, cash
broker_positions	Open positions with market values, asset class, entry price; negative quantity means short
broker_trades	Trade history, newest first; filter by broker or symbol
broker_stats	Total equity, equity by broker, top positions, FIFO win rate and realized PnL
broker_refresh	Bypass the 5-minute cache and re-fetch now

Read-only by construction: the SDK's root export has no trading endpoints, the server never writes secrets anywhere, and per-broker failures are reported alongside results, never silently dropped.

Development

npm install
npm run build
npm start            # stdio
npm run start:http   # streamable HTTP on :3333/mcp
npm test             # smoke suite over stdio (hits live endpoints)
npm run test:parity  # simulator tools vs upstream package + raw engine

Optional env: LUXALGO_APP_ORIGIN and LUXALGO_SITE_ORIGIN point the server at non-production environments.

Disclaimer

Nothing this server returns is investment advice. Simulation outputs are modeled estimates under stated assumptions, not predictions or guarantees. Verify balances and performance numbers against your broker's own statements, and a prop firm's own page is authoritative for its current rules.

License

Code is MIT © LuxAlgo Global, LLC. Library content and Pine Script sources served by this server keep their own licenses; see NOTICE.

The LuxAlgo name and logo are trademarks of LuxAlgo Global, LLC; see TRADEMARKS.md. To report a vulnerability, see SECURITY.md.