📈 TradingView MCP Server

A powerful Model Context Protocol (MCP) server that provides advanced cryptocurrency and stock market analysis using TradingView data. Perfect for traders, analysts, and AI assistants who need real-time market intelligence.

🎥 Demo Video

Quick 19-second demo showing the MCP server in action

https://github-production-user-asset-6210df.s3.amazonaws.com/67838093/478689497-4a605d98-43e8-49a6-8d3a-559315f6c01d.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20250816%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250816T155717Z&X-Amz-Expires=300&X-Amz-Signature=1362a9ea0e886268315cfa5b63951c82929ea01c9d826c87060e3ac116cf9531&X-Amz-SignedHeaders=host

✨ Key Features

• 🚀 Real-time Market Screening: Find top gainers, losers, and trending stocks/crypto

• 📊 Advanced Technical Analysis: Bollinger Bands, RSI, MACD, and more indicators

• 🎯 Bollinger Band Intelligence: Proprietary rating system (-3 to +3) for squeeze detection

• 🕯️ Pattern Recognition: Detect consecutive bullish/bearish candle formations

• 💎 Multi-Market Support: Crypto exchanges (KuCoin, Binance, Bybit) + Traditional markets (NASDAQ, BIST)

• ⏰ Multi-Timeframe Analysis: From 5-minute to monthly charts

• 🔍 Individual Asset Deep-Dive: Comprehensive technical analysis for any symbol

🚀 Quick Start

Option 1: Claude Desktop (Recommended)

1. Install UV Package Manager:

   # macOS (Homebrew) brew install uv # Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # macOS/Linux (Direct) curl -LsSf https://astral.sh/uv/install.sh | sh

2. Add to Claude Desktop Configuration:

   Config Path:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   { "mcpServers": { "tradingview-mcp": { "command": "uv", "args": [ "tool", "run", "--from", "git+https://github.com/atilaahmettaner/tradingview-mcp.git", "tradingview-mcp" ] } } }

3. Restart Claude Desktop - The server will be automatically available!

📋 For detailed Windows instructions, see

Option 2: Manual Installation

Windows Configuration Path: %APPDATA%\Claude\claude_desktop_config.json

macOS Configuration Path: ~/Library/Application Support/Claude/claude_desktop_config.json

Configuration for Local Setup:

macOS/Linux Configuration:

🛠️ Available Tools

📈 Market Screening

🔍 Technical Analysis

📋 Information

📝 Usage Examples

Talk to Claude Like This:

Basic Market Screening:

Technical Analysis:

Pattern Recognition:

Advanced Queries:

🎯 Understanding the Bollinger Band Rating System

Our proprietary rating system helps identify trading opportunities:

Bollinger Band Width (BBW): Lower values indicate tighter bands → potential breakout coming!

🏢 Supported Markets & Exchanges

💰 Cryptocurrency Exchanges

• KuCoin (KUCOIN) - Primary recommendation

• Binance (BINANCE) - Largest crypto exchange

• Bybit (BYBIT) - Derivatives focused

• OKX (OKX) - Global crypto exchange

• Coinbase (COINBASE) - US-regulated exchange

• Gate.io (GATEIO) - Altcoin specialist

• Huobi (HUOBI) - Asian market leader

• Bitfinex (BITFINEX) - Professional trading

📊 Traditional Markets

• NASDAQ (NASDAQ) - US tech stocks (AAPL, MSFT, TSLA)

• BIST (BIST) - Turkish stock market (Borsa İstanbul)

• More markets coming soon!

⏰ Supported Timeframes

5m, 15m, 1h, 4h, 1D, 1W, 1M

📊 Technical Indicators Included

• Bollinger Bands (20, 2) - Volatility and squeeze detection

• RSI (14) - Momentum oscillator

• Moving Averages - SMA20, EMA50, EMA200

• MACD - Trend and momentum

• ADX - Trend strength measurement

• Stochastic - Overbought/oversold conditions

• Volume Analysis - Market participation

• Price Action - OHLC data with percentage changes

🚨 Troubleshooting

Common Issues:

1. "No data found" errors:

• Try different exchanges (KuCoin usually works best)

• Use standard timeframes (15m, 1h, 1D)

• Check symbol format (e.g., "BTCUSDT" not "BTC")

2. Empty arrays or rate limiting:

• If you get empty results, you may have hit TradingView's rate limits

• Wait 5-10 minutes between query sessions

• The server automatically handles retries

• KuCoin and BIST have the most reliable data

3. Claude Desktop not detecting the server:

• Restart Claude Desktop after adding configuration

• Check that UV is installed: uv --version

• Verify the configuration JSON syntax

4. Slow responses:

• First request may be slower (warming up)

• Subsequent requests are much faster

• Consider using smaller limits (5-10 items)

🔧 Development & Customization

Running in Development Mode:

Adding New Exchanges:

The server is designed to be easily extensible. Check src/tradingview_mcp/core/ for the modular architecture.

🤝 Contributing

We welcome contributions! Here's how:

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

Ideas for Contributions:

• Add new exchanges or markets

• Implement additional technical indicators

• Improve error handling and rate limiting

• Add more candlestick pattern recognition

• Create comprehensive test suite

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Support & Issues

• Report bugs: GitHub Issues

• Feature requests: Open an issue with the "enhancement" label

• Questions: Check existing issues or open a new discussion

🌟 Star This Project

If you find this MCP server useful, please ⭐ star the repository to help others discover it!

Built with ❤️ for traders and AI enthusiasts

Empowering intelligent trading decisions through advanced market analysis