Claude Trading Bot

Fully automated trading system that connects Claude Code to TradingView Desktop (via CDP) and MetaTrader 5 (via file bridge) with Telegram alerts.

Reads LuxAlgo indicators in real-time, evaluates multi-timeframe confluence, executes trades on MT5, manages positions with trailing stops, and sends every action to Telegram.

This is a personal trading bot running on a demo account. Use at your own risk on live accounts.

Architecture

Claude Code (scheduler)
    |
    v
TradingView Desktop (CDP port 9222)
    |-- LuxAlgo Signals & Overlays    (Smart Trail, Trend, Buy/Sell signals)
    |-- LuxAlgo Price Action Concepts  (EQ zones, Premium/Discount, BOS/CHoCH)
    |-- LuxAlgo Oscillator Matrix      (HyperWave, Money Flow, Confluence)
    |
    v
scanner_lite.cjs (every 5 min)
    |-- Reads 15min for BIAS (structure, zones)
    |-- Reads 5min for ENTRY (signals, oscillator)
    |-- Calculates confluence score (0-100)
    |-- If score >= 40 + zone match --> EXECUTE
    |
    v
signal.json --> TV.mq5 EA (MT5) --> ack.json
    |                                    |
    v                                    v
Telegram Bot                    Trade executed on MT5
(@gold_alerts_careless_bot)     (SL/TP set, partial close, trailing)

What It Does

Prerequisites

• macOS (Apple Silicon or Intel)
• Node.js 18+ (brew install node)
• Git (xcode-select --install)
• TradingView Desktop (download)
• MetaTrader 5 (download)
• Claude Code (CLI or Desktop)
• LuxAlgo Premium indicators (Signals & Overlays, Price Action Concepts, Oscillator Matrix)

Setup

Step 1: Clone and install

cd ~
git clone https://github.com/eswarcareless/claude-trading-bot.git tradingview-mcp
cd tradingview-mcp
npm install

Step 2: Configure Claude Code MCP

Create .mcp.json in your working directory:

{
  "mcpServers": {
    "tradingview": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/Users/YOUR_USERNAME/tradingview-mcp/src/server.js"],
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
      }
    }
  }
}

Replace YOUR_USERNAME with your macOS username (whoami).

Step 3: Launch TradingView with CDP

# Use the included launch script
~/tradingview-mcp/START.sh

# Or manually:
/Applications/TradingView.app/Contents/MacOS/TradingView --remote-debugging-port=9222 &

Verify CDP is running:

curl -s http://localhost:9222/json/version

Step 4: Set up TradingView chart

1. Open XAUUSD (or your preferred symbol) chart
2. Add these LuxAlgo indicators:
   • Signals & Overlays (provides Smart Trail, trend strength, buy/sell signals)
   • Price Action Concepts Premium (provides EQ zones, premium/discount, BOS/CHoCH)
   • Oscillator Matrix (provides HyperWave, Money Flow, Confluence Meter)

Step 5: Set up MetaTrader 5

1. Open MT5 and log into your account
2. Open an XAUUSD chart
3. Copy MQL5/Experts/TV.mq5 to your MT5 Experts folder (or it's already there if you cloned)
4. In MetaEditor: open TV.mq5 and click Compile
5. Drag the TV EA onto your XAUUSD chart
6. Enable AutoTrading (green play button in toolbar)
7. EA settings:
   • InpSecret: test123 (must match alerts/config.json)
   • InpDefaultLot: 0.01 (or your preferred size)
   • InpPollMs: 100

The EA reads MQL5/Files/signal.json and writes results to MQL5/Files/ack.json.

Step 6: Set up Telegram bot

1. Open Telegram, search @BotFather, send /newbot
2. Name it and get the bot token
3. Start a chat with your bot and send /start
4. Get your chat ID:

   curl -s "https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates" | python3 -c "import sys,json; r=json.load(sys.stdin)['result'][0]; print('Chat ID:', r['message']['chat']['id'])"
   

5. Copy the config template and fill in your values:

   cp alerts/config.example.json alerts/config.json
   # Edit alerts/config.json with your bot_token and chat_id
   

6. Test:

   node alerts/telegram.cjs test
   

Step 7: Configure auto-trader

Edit autotrader/config.json to set your:

• Symbol and lot size
• Entry zones (short/long entry, SL, TP levels)
• Risk limits (max trades/day, max daily loss)
• Active hours

Initialize state:

cp autotrader/state.example.json autotrader/state.json

Step 8: Test with dry run

node autotrader/scanner_lite.cjs --dry-run

You should see it read both timeframes, calculate confluence scores, and report whether conditions are met — without executing any trades.

Step 9: Go live

In Claude Code, set up the 5-minute cron:

# In Claude Code conversation:
"Set up the auto-trader cron every 5 minutes"

Or use Claude Code's scheduled tasks:

# Creates a persistent scheduled task
node autotrader/scanner_lite.cjs

File Structure

tradingview-mcp/
├── src/                      # TradingView MCP server (78 tools)
│   ├── server.js             # MCP stdio server
│   ├── connection.js         # CDP WebSocket connection
│   ├── core/                 # Tool implementations
│   └── tools/                # MCP tool definitions
│
├── autotrader/               # Auto-trading system
│   ├── scanner_lite.cjs      # Main scanner (reads chart, evaluates, executes)
│   ├── config.json           # Strategy config (zones, risk, conditions)
│   ├── state.json            # Runtime state (open positions, daily stats)
│   └── scanner.cjs           # Legacy scanner (heavier, more features)
│
├── alerts/                   # Notification system
│   ├── telegram.cjs          # Telegram bot (entry/exit/TP/SL alerts)
│   ├── mt5.cjs               # MT5 trade executor (Node.js bridge)
│   ├── config.json           # Telegram credentials (gitignored)
│   └── config.example.json   # Template for config.json
│
├── strategies/               # Generated strategy documents
│   └── GOLD_strategy_*.md    # Strategy with entry/exit/management rules
│
├── rules.json                # Watchlist, bias criteria, risk rules
├── CLAUDE.md                 # Instructions for Claude Code sessions
├── START.sh                  # Launch TradingView with CDP
├── run_tool.cjs              # CLI helper to call MCP tools
└── package.json

TV.mq5 EA — Signal Protocol

The MetaTrader 5 Expert Advisor communicates via JSON files:

Entry (with price-based SL/TP)

{
  "secret": "test123",
  "symbol": "XAUUSD",
  "event": "ENTRY",
  "direction": "SELL",
  "lot": 0.01,
  "sl_price": 4835,
  "tp_price": 4741,
  "id": "unique-id"
}

Close all positions

{
  "secret": "test123",
  "symbol": "XAUUSD",
  "event": "CLOSE",
  "id": "unique-id"
}

Partial close (e.g., 40% at TP1)

{
  "secret": "test123",
  "symbol": "XAUUSD",
  "event": "PARTIAL_CLOSE",
  "percent": 40,
  "id": "unique-id"
}

Modify SL/TP (e.g., move SL to breakeven)

{
  "secret": "test123",
  "symbol": "XAUUSD",
  "event": "MODIFY",
  "sl_price": 4808,
  "tp_price": 4611,
  "id": "unique-id"
}

Confluence Scoring System

The auto-trader calculates a 0-100 score from 3 LuxAlgo indicators before entering:

Minimum 40/100 required to trigger a trade. Higher = higher conviction.

Smart Exit System

Telegram Alert Types

# Test connection
node alerts/telegram.cjs test

# Trade entry (with chart screenshot)
node alerts/telegram.cjs entry '{"direction":"SHORT","symbol":"GOLD",...}'

# Take profit hit
node alerts/telegram.cjs tp '{"tpLevel":"TP1","tpPrice":"4741",...}'

# Stop loss hit
node alerts/telegram.cjs sl '{"loss":"675","reason":"..."}'

# Trade exit
node alerts/telegram.cjs exit '{"pnl":2250,"pnlPct":"+1.87%",...}'

# 12hr watchlist update
node alerts/telegram.cjs update '{"assets":[...]}'

# Chart screenshot
node alerts/telegram.cjs photo '/path/to/screenshot.png'

MT5 Trade Commands

# Market sell with price-based SL/TP
node alerts/mt5.cjs sell '{"symbol":"XAUUSD","lot":0.01,"sl_price":4835,"tp_price":4741}'

# Market buy
node alerts/mt5.cjs buy '{"symbol":"XAUUSD","lot":0.01,"sl_price":4695,"tp_price":4735}'

# Close all positions
node alerts/mt5.cjs close '{"symbol":"XAUUSD","reason":"TP hit"}'

# Check bridge status
node alerts/mt5.cjs check

Safety Limits

Voice Commands (in Claude Code)

License

MIT

Disclaimer

This is a personal trading tool for educational and demo purposes. Automated trading carries significant risk. Never trade with money you cannot afford to lose. The authors are not responsible for any financial losses.