TradingViewMCPServer

Production-ready multi-asset trading assistant and Pine Script development server for Claude Desktop

Professional trading assistant supporting Forex, Stocks, and Crypto with 25+ technical indicators, Pine Script v6 development tools, and production-grade reliability.

✨ Features

🎯 Production-Ready (NEW in v3.4.0!)

• 🏥 Health Monitoring: Built-in health check tool with cache statistics and API status
• 🔄 Auto-Retry Logic: Exponential backoff for network failures (3 retries: 2s, 4s, 8s)
• ⚡ LRU Cache: Memory-bounded cache (1000 entries) with automatic eviction
• 🐳 Docker Support: Production-ready containerization with Docker Compose
• 🚀 CI/CD Pipeline: Automated testing across Python 3.10-3.12
• ✅ 100% Test Coverage: 44/44 tests passing

📊 Trading & Market Analysis

• Multi-Asset Support: Forex (22+ pairs), US Stocks, Cryptocurrencies
• 25+ Technical Indicators: Volume Profile, Market Profile, VWAP, Fibonacci, Bollinger Bands, MACD, Moving Averages, ATR, Support/Resistance, Pivot Points, Stochastic, RSI, CCI, Williams %R, ADX, Ichimoku Cloud, and more
• Full Historical Data: Live quotes and historical data for all asset types (Forex, Stocks, Crypto) via Alpha Vantage API
• Smart Caching: 70% reduction in API calls with intelligent caching
• Claude Desktop Integration: Seamless integration with Claude Desktop via MCP

Pine Script Development Tools (NEW in v3.1)

• Pine Script v6 Support: Full support for latest Pine Script v6 with type, enum, and map! ⭐
• Real-time Syntax Validation: Comprehensive syntax and semantic error checking with line-by-line feedback
• Intelligent Autocomplete: Context-aware code completion with function signatures and documentation
• Live Documentation Access: Instant access to Pine Script function documentation with examples (110+ functions)
• Version Detection: Automatic detection of Pine Script version (v1-v6) with compatibility analysis
• Version Conversion: Automatic code conversion between Pine Script versions (v3→v4→v5→v6)
• Code Testing Sandbox: Safe testing environment with validation and performance metrics
• Error Explanations: Detailed error descriptions with causes, solutions, and code examples
• Code Templates: Ready-to-use templates for indicators, strategies, and overlays

🚀 Quick Start

Prerequisites

• Python 3.10+ or Docker
• Claude Desktop
• Alpha Vantage API key (Get free key)

Option 1: Docker (Recommended) 🐳

# 1. Clone repository
git clone https://github.com/lev-corrupted/TradingViewMCPServer.git
cd TradingViewMCPServer

# 2. Create .env file
echo "ALPHA_VANTAGE_API_KEY=your_key_here" > .env

# 3. Run with Docker Compose
docker-compose up -d

# 4. Check server health
docker-compose logs -f

Option 2: Standard Installation

# 1. Clone repository
git clone https://github.com/lev-corrupted/TradingViewMCPServer.git
cd TradingViewMCPServer

# 2. Create virtual environment
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 3. Install dependencies
pip install -e .

# 4. Create .env file
echo "ALPHA_VANTAGE_API_KEY=your_key_here" > .env

4. Configure Claude Desktop:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tradingview": {
      "command": "/absolute/path/to/TradingViewMCPServer/.venv/bin/python",
      "args": [
        "/absolute/path/to/TradingViewMCPServer/tradingview_mcp/server.py",
        "stdio"
      ]
    }
  }
}

Replace /absolute/path/to/TradingViewMCPServer with your actual installation path.

5. Restart Claude Desktop

💡 Usage

Health Check (NEW!) 🏥

Monitor server health and performance:

Check server health
What's the cache hit rate?
Show me server statistics

Returns:

• Server version and status
• API key configuration
• Cache statistics (size, hit rate, evictions)
• Total API calls made

Trading & Market Analysis 📊

Ask Claude Desktop natural language questions:

What's the current price of AAPL?
Show me Bollinger Bands for TSLA on 1h timeframe
Calculate Fibonacci levels for BTC
Get MACD for EURUSD with RSI
Show me support and resistance for NVDA
What's the volume profile for SPY?
Give me the Ichimoku Cloud for ETH
Calculate pivot points and CCI for GBPUSD
Analyze AAPL with Williams %R indicator

Pine Script Development

Ask Claude to help with Pine Script code:

Validate this Pine Script code: [paste code]
Convert this v4 code to v5: [paste code]
Show me documentation for ta.macd
Test this indicator on AAPL 1h timeframe: [paste code]
Explain error E101
Detect the version of this Pine Script: [paste code]
Give me a Pine Script strategy template

🛠️ Available Tools

Server Management (NEW in v3.4.0!)

• health_check - Server health and cache statistics

Price & Market Data

• get_price - Get current price for any asset
• get_multiple_prices - Batch price quotes
• list_available_pairs - List forex pairs
• list_supported_assets - List all supported assets

Technical Analysis

• analyze_pair - Comprehensive analysis
• get_trading_recommendation - Trading signals
• calculate_correlation - Pair correlation

Volume & Profile Analysis

• get_volume_profile - Volume at price levels
• get_market_profile - Market profile with TPO and value areas
• get_vwap - Volume Weighted Average Price
• get_volume_nodes - High/low volume nodes
• detect_unfilled_gaps - Price gaps detection

Momentum Indicators (NEW: RSI, CCI, Williams %R)

• get_stochastic - Stochastic oscillator (%K, %D)
• get_rsi - NEW! RSI (Relative Strength Index)
• get_cci - NEW! CCI (Commodity Channel Index)
• get_williams_r - NEW! Williams %R

Trend Indicators

• get_moving_averages - Multiple SMAs/EMAs
• get_macd - MACD indicator
• get_adx - Average Directional Index (trend strength)
• get_ichimoku_cloud - Ichimoku Cloud

Volatility Indicators

• get_bollinger_bands - Bollinger Bands
• get_atr - Average True Range

Support/Resistance

• get_fibonacci_retracement - Fibonacci levels
• get_support_resistance - Auto-detected levels
• get_pivot_points - Daily pivot points

Pine Script Development (NEW)

• validate_pine_script - Real-time syntax validation with detailed error reporting (v1-v6 support)
• get_pine_documentation - Function and topic documentation with examples (110+ functions)
• test_pine_script - Safe sandbox testing with metrics
• explain_pine_error - Detailed error explanations with solutions
• detect_pine_version - Automatic version detection (v1-v6)
• convert_pine_version - Automatic version conversion (supports v6!)
• autocomplete_pine - Intelligent code completion (includes v6 features)
• get_pine_template - Ready-to-use code templates

Supported Assets

Forex

Major pairs, crosses, exotics, and gold (XAUUSD)

Stocks

US equities including AAPL, MSFT, GOOGL, AMZN, TSLA, NVDA, META, and more

Crypto

BTC, ETH, BNB, XRP, ADA, SOL, and other major cryptocurrencies

Configuration

API Rate Limits

Alpha Vantage free tier:

• 25 requests per day
• 5 API calls per minute

For higher limits, upgrade to premium API key.

Timeframes

Supported timeframes: 5m, 15m, 30m, 1h, 4h, 1d

📈 Version History

Version 3.4.0 - Production Ready (Current) 🚀

Major production-grade improvements:

Performance & Reliability

• ✅ LRU Cache: Memory-bounded cache with automatic eviction (1000 entries max)
• ✅ Auto-Retry: Exponential backoff for network failures (3 retries: 2s, 4s, 8s)
• ✅ Health Check: New MCP tool for monitoring and debugging
• ✅ 100% Tests: All 44 tests passing (was 93%)

Developer Experience

• ✅ Docker Support: Production-ready Dockerfile and docker-compose.yml
• ✅ CI/CD Pipeline: Automated testing across Python 3.9-3.12
• ✅ Requirements: Separate runtime and dev dependencies

Bug Fixes

• Fixed version mismatch in pyproject.toml
• Fixed 3 failing tests (ATR, Bollinger Bands, Pine Script v5)
• Verified .env security (not in git)

Test Results: 44/44 passing (100%) | Files Changed: 12 | Lines Added: 661+

See IMPROVEMENTS_v3.4.0.md for full details.

---

Version 3.3.0 - New Indicators

• Added RSI (Relative Strength Index) indicator
• Added CCI (Commodity Channel Index) indicator
• Added Williams %R indicator
• Full historical data support for Stocks and Crypto
• Updated README: 20+ → 25+ indicators

Version 3.1 - Pine Script v6 Support ⭐

Major update with full Pine Script v6 support:

New Features

• Pine Script v6: Full support for the latest Pine Script version
• V6 Data Structures: type (structs), enum, and map collections
• 110+ Function Signatures: Enhanced function database including map.* namespace
• Enhanced Conversion: v3→v4→v5→v6 automatic migration
• 8 Pine Script MCP Tools: Complete development environment
• 3000+ Lines of Pine Script Code: Lexer, parser, validator, and more
• Version Support: Full support for Pine Script v1-v6
• Intelligent Analysis: AS