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.
- π 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
-
Install UV Package Manager (if not already installed):
# Using Homebrew (macOS - Recommended) brew install uv # Or using direct installation: # On macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # On Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
-
Add to Claude Desktop Configuration:
Open your Claude Desktop settings and add this MCP server configuration:
{ "mcpServers": { "tradingview-mcp": { "command": "uv", "args": [ "tool", "run", "--from", "git+https://github.com/atilaahmettaner/tradingview-mcp.git", "tradingview-mcp" ] } } } -
Restart Claude Desktop - The server will be automatically available!
# Clone the repository
git clone https://github.com/atilaahmettaner/tradingview-mcp.git
cd tradingview-mcp
# Install dependencies
uv sync
# Test the server
uv run python src/tradingview_mcp/server.py| Tool | Description | Example Usage |
|---|---|---|
top_gainers |
Find highest performing assets | Top crypto gainers in 15m |
top_losers |
Find biggest declining assets | Worst performing stocks today |
bollinger_scan |
Find assets with tight Bollinger Bands | Coins ready for breakout |
rating_filter |
Filter by Bollinger Band rating | Strong buy signals (rating +2) |
| Tool | Description | Example Usage |
|---|---|---|
coin_analysis |
Complete technical analysis | Analyze BTC with all indicators |
consecutive_candles_scan |
Find candlestick patterns | 3+ consecutive green candles |
advanced_candle_pattern |
Multi-timeframe pattern analysis | Complex pattern detection |
| Tool | Description |
|---|---|
exchanges://list |
List all supported exchanges and markets |
Basic Market Screening:
"Show me the top 10 crypto gainers on KuCoin in the last 15 minutes"
"Find the biggest losers on Binance today"
"Which Turkish stocks (BIST) are down more than 5% today?"
Technical Analysis:
"Analyze Bitcoin with all technical indicators"
"Find crypto coins with Bollinger Band squeeze (BBW < 0.05)"
"Show me coins with strong buy signals (rating +2)"
Pattern Recognition:
"Find coins with 3 consecutive bullish candles on Bybit"
"Scan for stocks showing growing candle patterns"
"Which assets have tight Bollinger Bands ready for breakout?"
Advanced Queries:
"Compare AAPL vs TSLA technical indicators"
"Find high-volume crypto with RSI below 30"
"Show me NASDAQ stocks with strong momentum"
Our proprietary rating system helps identify trading opportunities:
| Rating | Signal | Description |
|---|---|---|
| +3 | π₯ Strong Buy | Price above upper Bollinger Band |
| +2 | β Buy | Price in upper 50% of bands |
| +1 | β¬οΈ Weak Buy | Price above middle line |
| 0 | β‘οΈ Neutral | Price at middle line |
| -1 | β¬οΈ Weak Sell | Price below middle line |
| -2 | β Sell | Price in lower 50% of bands |
| -3 | π₯ Strong Sell | Price below lower Bollinger Band |
Bollinger Band Width (BBW): Lower values indicate tighter bands β potential breakout coming!
- 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
- NASDAQ (NASDAQ) - US tech stocks (AAPL, MSFT, TSLA)
- BIST (BIST) - Turkish stock market (Borsa Δ°stanbul)
- More markets coming soon!
5m, 15m, 1h, 4h, 1D, 1W, 1M
- 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
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. Rate limiting:
- The server automatically handles API limits
- Wait a few seconds between requests
- 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)
# Clone and setup
git clone https://github.com/atilaahmettaner/tradingview-mcp.git
cd tradingview-mcp
uv sync
# Run with MCP Inspector for debugging
uv run mcp dev src/tradingview_mcp/server.py
# Test individual functions
uv run python test_api.pyThe server is designed to be easily extensible. Check src/tradingview_mcp/core/ for the modular architecture.
We welcome contributions! Here's how:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Add new exchanges or markets
- Implement additional technical indicators
- Improve error handling and rate limiting
- Add more candlestick pattern recognition
- Create comprehensive test suite
This project is licensed under the MIT License - see the LICENSE file for details.
- Report bugs: GitHub Issues
- Feature requests: Open an issue with the "enhancement" label
- Questions: Check existing issues or open a new discussion
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