Tradestack Mcp

TradeStack MCP

Market Context Protocol for TradingView and every major trading platform. Connect. Query. Analyze. Trade Smarter.

[](LICENSE) [](https://nodejs.org/) [](https://modelcontextprotocol.io) [](https://github.com/vonzelle-vzt/tradestack-mcp/releases) []() []()

---

Why TradeStack

Every other TradingView MCP picks two of {real-time, structured data, hostable, ToS-clean, paid-feature parity, trade execution} and abandons the rest. TradeStack is the union. One MCP, one tool surface, every platform.

| | TradeStack | tradesdontlie (CDP) | atilaahmettaner (scrape) | fiale-plus (screener) | ertugrul59 (image) | |---|:---:|:---:|:---:|:---:|:---:| | Hostable / remote | ✅ | ❌ | ✅ | ✅ | ✅ | | Multi-tenant + OAuth | ✅ | ❌ | ❌ | ❌ | ❌ | | Persistent state (watchlists/journal) | ✅ | ❌ | ❌ | ❌ | ❌ | | Webhook ingress (TV alerts → MCP) | ✅ | ❌ | ❌ | ❌ | ❌ | | TV public scanner API | ✅ | ❌ | partial | ✅ | ❌ | | Real Pine compiler (pine-facade) | ✅ | partial | ❌ | ❌ | ❌ | | Chart image + structured in one call | ✅ | ❌ | ❌ | ❌ | image only | | Composite & chained alerts | ✅ | ❌ | ❌ | ❌ | ❌ | | Risk sizing (Kelly / vol-target / VaR) | ✅ | ❌ | ❌ | ❌ | ❌ | | Lifecycle gates (replay → paper → live) | ✅ | ❌ | ❌ | ❌ | ❌ | | Plugin SDK (codegen / broker / scanner) | ✅ | ❌ | ❌ | ❌ | ❌ | | Multi-platform (TV + TradeLocker + NT8 + MT5 + cTrader) | ✅ | TV only | TV only | TV only | TV only |

Features

| ⚡ Fast | 🛡️ Reliable | 📊 Powerful | 🧩 Extensible | 🧑‍💻 Developer First | |---|---|---|---|---| | High-performance market data access with cache + rate limiter | Built on official @modelcontextprotocol/sdk, typed everywhere | Deep market data, screener, Pine, charts, alerts, risk | Plugin SDK for codegen, broker, scanner, data feed | Clean TypeScript API, MIT-licensed, no vendor lock-in |

Quick start

Run with Claude Desktop

// ~/Library/Application Support/Claude/claude_desktop_config.json
// (or %APPDATA%\Claude\claude_desktop_config.json on Windows)
{
  "mcpServers": {
    "tradestack": {
      "command": "npx",
      "args": ["-y", "tradestack-mcp"]
    }
  }
}

Run from source

git clone https://github.com/vonzelle-vzt/tradestack-mcp.git
cd tradestack-mcp
npm install
npm run build
npm start                              # stdio (default)
MCP_TRANSPORT=http MCP_HTTP_PORT=3737 npm start   # remote / hosted

Hosted HTTP usage

# health probe
curl http://localhost:3737/healthz
# → {"ok":true,"service":"tradestack-mcp","version":"0.2.0"}

# MCP initialize (Streamable HTTP w/ SSE)
curl -i -X POST http://localhost:3737/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer my-user-id" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

The Authorization: Bearer (or X-TradeStack-User) header scopes all stateful tools (watchlists, webhook tokens) per user.

Optional persistence (Supabase)

Set SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY and apply supabase/schema.sql. Watchlists and webhook tokens then survive restarts and span MCP clients.

Tool surface (32 tools)

Every read tool is ToS-clean — TV's own public endpoints or pure local math. Write tools (order_route, broker calls) require explicit broker credentials.

Market data (5)

| Tool | Purpose | |---|---| | screener_query | TV public scanner — 180+ fields, 18 filter ops | | symbol_search | Symbol lookup | | symbol_ohlcv | Historical bars via Polygon / Alpaca plugin | | symbol_quote | Latest bid/ask/last | | chart_snapshot | TV PNG snapshot URL |

Pine + codegen (4)

| Tool | Purpose | |---|---| | pine_compile | Validate against pine-facade.tradingview.com | | codegen_transpile | Pine ↔ NT8/MT5/TradeLocker via CodegenPlugin | | codegen_validate | Static check generated code | | codegen_list | List registered codegen plugins |

Watchlists & alerts (8)

| Tool | Purpose | |---|---| | watchlist_get / _upsert / _add / _remove / _list | Per-user persistent lists | | webhook_token_get / _rotate | TV alert webhook URL secret | | alerts_recent | Recent inbound alerts |

Composite alerts (4)

| Tool | Purpose | |---|---| | alert_composite | Multi-condition orchestration | | alert_composite_list / _delete / _evaluate | Manage and dry-run |

Strategy lifecycle (4)

| Tool | Purpose | |---|---| | lifecycle_start / _complete / _runs | Track replay/paper/live runs | | lifecycle_promote | Statistical gate check for next stage |

Risk + portfolio (3)

| Tool | Purpose | |---|---| | risk_position_size | Fixed-fractional / Kelly / vol-target | | risk_portfolio_var | Parametric VaR | | risk_correlation_matrix | Pearson across return series |

Brokers + execution (4)

| Tool | Purpose | |---|---| | brokers_list | List registered broker plugins | | order_route | Submit order with sizing + pre-trade gates | | positions_list | Open positions on a broker | | account_info | Equity / cash / buying power | | alert_composite | Multi-condition alerts orchestrated over single-condition TV alerts | | lifecycle_replay / lifecycle_paper / lifecycle_promote | Strategy lifecycle with statistical gates | | register_plugin | Internal registry for codegen / broker / scanner / data-feed plugins |

Full tool spec lives in [docs/TOOLS.md](docs/TOOLS.md). Roadmap in [docs/ROADMAP.md](docs/ROADMAP.md).

Platform integration

TradeStack ships with first-class plugin contracts for the platforms that matter:

• [TradingView](docs/platforms/tradingview.md) — public scanner API, Pine facade compiler, chart snapshots
• [TradeLocker](docs/platforms/tradelocker.md) — REST + WebSocket (Streams + BrandSocket APIs), official Python client
• [NinjaTrader 8](docs/platforms/ninjatrader.md) — local ATI (DLL) and CrossTrade REST bridge
• [MetaTrader 5](docs/platforms/metatrader5.md) — MetaApi cloud or local gateway, FastAPI bridge patterns
• [cTrader](docs/platforms/ctrader.md) — Open API (Spotware), works with any cTrader-affiliated broker
• [Data feeds](docs/platforms/data-feeds.md) — Polygon, Databento, Alpaca

Each platform doc covers auth, endpoints, gotchas, and the exact plugin contract.

Webhook ingress (the killer feature)

Paste one URL into any TradingView alert message and every fire streams into Claude's context:

{{ticker}}|{{strategy.order.action}}|{{close}}|{{interval}}

TradeStack receives, deduplicates, attaches symbol metadata, and exposes recent alerts via the alerts_recent tool or an SSE stream. Nobody else does this.

Plugin SDK

import { registerBroker, BrokerPlugin } from "tradestack-mcp/plugins";

const myBroker: BrokerPlugin = {
  name: "my-broker",
  async place_order(o) { /* ... */ },
  async cancel_order(id) { /* ... */ },
  async positions() { /* ... */ },
};

registerBroker(myBroker);

See [docs/PLUGINS.md](docs/PLUGINS.md) for BrokerPlugin, CodegenPlugin, ScannerPlugin, DataFeedPlugin contracts.

Repo layout

src/
  server.ts              MCP server entrypoint (stdio + streamable HTTP)
  tools/                 individual tool implementations
  plugins/               plugin registry + typed contracts
  state/                 Supabase-backed persistence (optional)
  lib/                   http client, cache, logger, config
  webhook/               TradingView alert ingress
docs/
  TOOLS.md               full tool reference
  ROADMAP.md             what's next
  PLUGINS.md             plugin SDK reference
  platforms/             per-platform integration notes
supabase/
  schema.sql             persistent state schema (watchlists/journals/alerts)
examples/
  claude_desktop_config.json

Contributing

Pull requests welcome. See [CONTRIBUTING.md](CONTRIBUTING.md). All code is MIT-licensed and signed with DCO sign-off (git commit -s).

License

MIT © 2026 VZT Tech Consulting. See [LICENSE](LICENSE).

Acknowledgements

Inspired by — and built to subsume — the prior art: tradesdontlie/tradingview-mcp, atilaahmettaner/tradingview-mcp, fiale-plus/tradingview-mcp-server, bidouilles/mcp-tradingview-server, ertugrul59/tradingview-chart-mcp, cklose2000/pinescript-mcp-server.

---

Built by VZT. Not affiliated with TradingView, TradeLocker, NinjaTrader, MetaQuotes, or Spotware.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: vonzelle-vzt
• Source: vonzelle-vzt/tradestack-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.