MCP Integration

One command, every AI assistant

Install the TradingWizard CLI and run tw setup. It detects Claude Desktop, Cursor, Claude Code, and VS Code on your machine, then wires each one to your TradingWizard data. Done.

Quick install

The CLI runs on Node 18+. After install, tw setup opens a browser tab for you to authorize the connector, then writes the MCP config into every detected AI client. Re-running it is a safe no-op.

npm install -g @tradingwizard/cli
tw setup
Step 1
Install the CLI
npm install -g @tradingwizard/cli. Adds the tw binary to your PATH.
Step 2
Authorize in your browser
tw setup opens /cli/authorize — sign in (if needed) and click Allow.
Step 3
Configs written
The CLI detects Claude Desktop, Cursor, Claude Code, and VS Code, then writes the MCP block into each one (with backups).
Step 4
Self-test + restart
The CLI pings tools/list, confirms all 9 tools, and prints the restart command for each client.
Your existing API token is reused — the CLI never mints a new one. Same key the browser extension and REST surfaces use. Rotate it any time from Settings → AI Connector.

CLI commands

# Setup
tw setup                          # detect + install everywhere
tw setup claude-desktop           # explicit one-client install
tw setup cursor
tw setup claude-code              # per-project (uses cwd)
tw setup vscode
tw setup claude-web               # prints copy-paste steps for the Claude.ai UI
tw setup chatgpt                  # prints copy-paste steps for the ChatGPT UI

# Maintenance
tw status                         # show login + per-client install state
tw test                           # ping tools/list
tw login                          # re-authorize the CLI
tw logout                         # remove from configs + clear local token

# Data lookups (handy for jq / agents)
tw bots --json
tw trades --status open --json
tw price BTCUSDT
tw kai BTCUSDT
tw scanner earnings

What is MCP?

Model Context Protocol is an open standard for letting AI assistants call into external systems safely. TradingWizard ships an MCP server at /api/mcp with 9 read-only tools — bots, trades, scanner feeds, portfolio, chart analyses. Write actions (open trade, deploy bot) intentionally stay in the dashboard.

Available tools

get_account

Plan, credits, daily-API usage and limits.

get_bots

Your bot fleet. Optional `symbol` filter.

get_trades

Open / closed / pending trades with P&L.

get_market_price

Live price + 24h change for any ticker.

get_market_track

AI-monitored events for symbols you watch.

get_chart_analysis

Latest Kai chart read for a symbol.

get_scanner

Earnings · IPO · Insider · SEC feeds.

get_signals

Top trade signals across the bot fleet.

get_portfolio

Account value, holdings, P&L snapshot.

Example prompts

Real questions you can ask once the connector is live. Your assistant picks the right tool, calls it, and renders the answer.

  • "What did my bots find today? Top symbols + P&L per bot."
  • "Are any of my trades close to stop-loss right now?"
  • "Pull Kai's latest chart read on BTCUSDT and summarise the bias."
  • "Show me earnings this week for symbols on my watchlist."
  • "Which open positions have moved more than 2% since entry?"
  • "How many credits do I have left this month?"

Manual setup (advanced)

If you'd rather not install the CLI, you can paste these blocks into your client's config file by hand. Replace tw_•••• with the token from Settings → AI Connector.

ClClaude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows. Restart Claude Desktop after saving.

{
  "mcpServers": {
    "tradingwizard": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.tradingwizard.ai/api/mcp",
        "--header",
        "Authorization:Bearer tw_••••••••••••••••"
      ]
    }
  }
}

CuCursor

Add to ~/.cursor/mcp.json or via Settings → MCP.

{
  "mcpServers": {
    "tradingwizard": {
      "url": "https://www.tradingwizard.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer tw_••••••••••••••••"
      }
    }
  }
}

GPChatGPT (custom MCP connector)

In ChatGPT settings → Connectors → Build → Custom MCP. Paste these values:

Name: TradingWizard
Server URL: https://www.tradingwizard.ai/api/mcp
Authentication: Bearer token
Token: tw_••••••••••••••••

Ready to install?

One command. Restart your assistants. Done.

Open AI Connector