Skip to content
Back to search

luxalgo-mcp-server

The LuxAlgo ecosystem as MCP tools: free and keyless.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/luxalgo--luxalgo-mcp-server/badge.svg)](/listings/luxalgo--luxalgo-mcp-server)

HTML

<a href="/listings/luxalgo--luxalgo-mcp-server"><img src="/api/listings/luxalgo--luxalgo-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The hosted server is one URL:

https://mcp.luxalgo.com/mcp

Claude (web, desktop, mobile)

Customize → Connectors → **Add custom connector**, URL **`https://claude.mcp.luxalgo.com/mcp`**, and under **Authentication** choose **Required when the server asks**. Claude connects anonymously, every keyless tool works right away, and the sign-in card only appears the first time you call an account tool. This Claude-only address exists because Claude.ai otherwise opens the OAuth window at connect time for any server whose OAuth metadata it can discover ([claude-ai-mcp#1013](https://github.com/anthropics/claude-ai-mcp/issues/1013)); it serves the same tools with that metadata hidden until a sign-in is actually needed. Every other client uses `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"
    }
  }
}

<details> <summary><b>Where each client keeps its config</b></summary> <br>

| 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` |

</details>

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.

Signing in with LuxAlgo (optional)

Almost everything here is keyless and works without an account. The tools in the **Account** and **Trade Journal** sections below need to know who you are; they use your LuxAlgo account through standard OAuth 2.1, with [app.luxalgo.com](https://app.luxalgo.com) as the authorization server. Nothing is required up front: every client can connect, list tools and use the public ones anonymously, and sign-in is only requested when you first call an account tool.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <a href="https://mcp.luxalgo.com">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset=".github/assets/cover-dark.png">
  4. <source media="(prefers-color-scheme: light)" srcset=".github/assets/cover-light.png">
  5. <img alt="Vela, in ChatGPT, Claude and any agent. Vela by LuxAlgo." src=".github/assets/cover-dark.png" width="100%">
  6. </picture>
  7. </a>
  8. # LuxAlgo MCP
  9. **Vela, live in your chat.** Ask for a chart and it opens right in the conversation: a live chart from [Vela](https://vela.luxalgo.com/chart), the next-generation charting platform by LuxAlgo, that changes when you ask. Sign in with LuxAlgo and your AI works inside your own Vela too.
  10. [![npm](https://img.shields.io/npm/v/@luxalgo/mcp?style=flat-square&label=npm&labelColor=0a0a0a&color=35a2de)](https://www.npmjs.com/package/@luxalgo/mcp)
  11. [![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.LuxAlgo%2Fluxalgo--mcp--server-9200ff?style=flat-square&labelColor=0a0a0a)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.LuxAlgo/luxalgo-mcp-server)
  12. [![License: MIT](https://img.shields.io/badge/license-MIT-ededed?style=flat-square&labelColor=0a0a0a)](LICENSE)
  13. ## Right here in your chat
  14. <img alt="A live BTC 4 hour Vela chart with RSI and a level at 80,000, opened from one sentence inside a chat" src="docs/images/vela-chart-in-chat.png" width="100%">
  15. - **Open a live chart from a sentence.** "Show BTC on 4 hour candles with RSI and a line at 80,000." It runs on the open-source core of Vela by LuxAlgo.
  16. - **Change it by asking.** Switch markets, add RSI or MACD, draw a level, shade a zone, zoom to a date range. The chart updates in place.
  17. - **Your AI reads it.** The last price, the day's change and each indicator's latest value, as you see them.
  18. - **Crypto and 24/7 stocks.** Crypto from Hyperliquid and Binance, and Hyperliquid's 24/7 stock perpetuals such as TSLA. **Open in Vela** takes the chart to the full platform.
  19. - **The Library.** 800+ indicators and 800+ concepts, with Pine Script® source where it is published and a link that opens each indicator on a Vela chart.
  20. - **Session statistics.** Gap fills, opening-range breakouts, weekday effects, each with its sample size and a 95% confidence interval: historical frequencies, never predictions.
  21. - **Prop firm simulations.** Your stats or real trades through a firm's exact rules: the chance you pass, the likely cost and the rule that ends most attempts.
  22. The chart shows in clients that display MCP Apps (ChatGPT today).
  23. ## Inside your Vela
  24. Sign in with LuxAlgo and your AI works in your own Vela:
  25. - builds and edits your **watchlists**;
  26. - pulls up your **saved layouts**;
  27. - looks at **the chart you have open**;
  28. - reviews, logs and tags **your trades** in your Trade Journal.
  29. It never places trades, moves money or gives investment advice.
  30. ## Add it
  31. | Where | How | What you get |
  32. | --- | --- | --- |
  33. | **ChatGPT** | The approved LuxAlgo app: open **Plugins** in ChatGPT, search **LuxAlgo**, add it. | Everything above |
  34. | **Claude** | **Customize** > **Connectors** > **+** > **Add custom connector**: `https://claude.mcp.luxalgo.com/mcp` | The Library, prop firm simulations, session statistics and your Trade Journal; no chart or Vela account tools on this address yet |
  35. | **Claude Code** | `claude mcp add --transport http luxalgo https://mcp.luxalgo.com/mcp` | Everything above |
  36. | **Codex** | `codex mcp add luxalgo --url https://mcp.luxalgo.com/mcp` | Everything above |
  37. | **Cursor, VS Code, any client** | `https://mcp.luxalgo.com/mcp` ([Cursor](https://cursor.com/en/install-mcp?name=luxalgo&config=eyJ1cmwiOiJodHRwczovL21jcC5sdXhhbGdvLmNvbS9tY3AifQ==) · [VS Code](https://vscode.dev/redirect/mcp/install?name=luxalgo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.luxalgo.com%2Fmcp%22%7D) one-click) | Everything above; the chart where the client shows MCP Apps |
  38. | **Your machine** | `npx -y @luxalgo/mcp` ([setup](docs/self-hosting.md#local-stdio)) | The Library, session statistics, prop firm simulations and your Trade Journal, plus read-only broker accounts; keys stay on your machine |
  39. No API key. Signing in with LuxAlgo is asked only for your own data: your Vela and your Trade Journal.
  40. ## Build your own Vela
  41. The chart is Vela's open-source core: [`@luxalgo/vela`](https://www.npmjs.com/package/@luxalgo/vela), a WebGL2 charting library under Apache-2.0. Docs at [velacharts.dev](https://velacharts.dev), code at [github.com/LuxAlgo/Vela](https://github.com/LuxAlgo/Vela). Pair it with `library_get_source_code` to run any published Library indicator on your own chart.
  42. <details>
  43. <summary><b>A Library indicator on your own chart, in two script tags</b></summary>
  44. <br>
  45. <picture>
  46. <source media="(prefers-color-scheme: dark)" srcset=".github/assets/vela-supertrend-dark.png">
  47. <source media="(prefers-color-scheme: light)" srcset=".github/assets/vela-supertrend-light.png">
  48. <img alt="The Library's SuperTrend indicator, fetched through library_get_source_code, running on a Vela chart" src=".github/assets/vela-supertrend-dark.png" width="100%">
  49. </picture>
  50. <sub>The Library's <a href="https://www.luxalgo.com/library/indicator/supertrend/">SuperTrend</a> source as returned by <code>library_get_source_code</code>, executed by <code>@luxalgo/vela-pinets</code> on a <code>@luxalgo/vela</code> 0.6 chart in headless Chromium. The bars are a labelled synthetic sample.</sub>
  51. `source` is the `source` field of a `library_get_source_code` result:
  52. ```html
  53. <div id="chart" style="height: 480px"></div>
  54. <script src="https://cdn.jsdelivr.net/npm/@luxalgo/vela@0.6.15/dist/vela.global.min.js"></script>
  55. <script src="https://cdn.jsdelivr.net/npm/@luxalgo/vela-pinets@0.2.10/dist/vela-pinets.global.min.js"></script>
  56. <script>
  57. const chart = new Vela.Vela('#chart', { data: bars, timeframe: '1D', theme: 'dark' }); // bars: [{ time, open, high, low, close, volume? }]
  58. chart.registerEngine('pine', new VelaPinets.PineEngine());
  59. chart.addIndicator(source);
  60. </script>
  61. ```
  62. With a bundler: `import { Vela } from '@luxalgo/vela'` and `import { PineEngine } from '@luxalgo/vela-pinets'`; see the [quickstart](https://github.com/LuxAlgo/Vela/blob/main/docs/user/quickstart.md). Pine Script® runs through [PineTS](https://github.com/LuxAlgo/PineTS), our open-source runtime (AGPL-3.0, licensed separately). Vela's attribution mark stays on unless you show equivalent attribution next to the chart; see its [NOTICE](https://github.com/LuxAlgo/Vela/blob/main/NOTICE).
  63. </details>
  64. ## Reference
  65. - **[Every tool](docs/tools.md)**, by area, with example asks and which address serves what.
  66. - **[Run it yourself](docs/self-hosting.md)**: the live charts, stdio with broker keys, Docker, HTTP, environment variables, architecture.
  67. - **[Sign-in and privacy](docs/auth.md)**: OAuth 2.1 with the LuxAlgo app. This server holds no plan checks; the app decides what your account can see, exactly as on the web.
  68. - **[Changelog](CHANGELOG.md)** · **[Security](SECURITY.md)**
  69. <details>
  70. <summary><b>Contributing</b></summary>
  71. <br>
  72. ```bash
  73. npm install
  74. npm run typecheck && npm run build
  75. npm test # smoke suite over stdio (live endpoints); --only library,edge for a subset
  76. npm run test:http # the same suite against a running HTTP entry
  77. npm run test:parity # simulator tools against the upstream engine
  78. npm run test:trackers # offline checks of the Market Trackers engine
  79. ```
  80. Adding a tool: read [AGENTS.md](AGENTS.md) and [docs/auth.md](docs/auth.md) first. Pull requests target `dev`; commits are signed off (`git commit -s`, checked by CI).
  81. </details>
  82. ## License
  83. Code is [MIT](LICENSE) © LuxAlgo Global, LLC. Library content and Pine Script® sources keep their own licenses; see [NOTICE](NOTICE). LuxAlgo and Vela are trademarks of LuxAlgo Global, LLC; see [TRADEMARKS.md](TRADEMARKS.md). Nothing this server returns is investment advice: simulations are modeled estimates and statistics are historical frequencies, and a prop firm's own page is authoritative for its current rules.
  84. <div align="center">
  85. <br>
  86. <b>LuxAlgo, makers of Vela.</b><br>
  87. <a href="https://www.luxalgo.com">luxalgo.com</a> · <a href="https://vela.luxalgo.com/chart">Open Vela</a> · <a href="https://github.com/LuxAlgo">GitHub</a>
  88. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.