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.
Quick 19-second demo showing the MCP server in action
github.readme.mp4
- π 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, NYSE, LSE, BIST)
- β° Multi-Timeframe Analysis: From 5-minute to monthly charts
- π Individual Asset Deep-Dive: Comprehensive technical analysis for any symbol
-
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
-
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" ] } } } - Windows:
-
Restart Claude Desktop - The server will be automatically available!
π For detailed Windows instructions, see INSTALLATION.md
# Clone the repository
git clone https://github.com/atilaahmettaner/tradingview-mcp.git
cd tradingview-mcp
# Install dependencies
uv sync
# For local development, add to Claude Desktop:Windows Configuration Path:
%APPDATA%\Claude\claude_desktop_config.json
macOS Configuration Path:
~/Library/Application Support/Claude/claude_desktop_config.json
Configuration for Local Setup:
{
"mcpServers": {
"tradingview-mcp-local": {
"command": "C:\\path\\to\\your\\tradingview-mcp\\.venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\your\\tradingview-mcp\\src\\tradingview_mcp\\server.py"],
"cwd": "C:\\path\\to\\your\\tradingview-mcp"
}
}
}macOS/Linux Configuration:
{
"mcpServers": {
"tradingview-mcp-local": {
"command": "uv",
"args": ["run", "python", "src/tradingview_mcp/server.py"],
"cwd": "/path/to/your/tradingview-mcp"
}
}
}| 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)"
"Analyze IBM stock on NYSE with technical indicators"
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"
"Find NYSE stocks with Bollinger Band squeeze"
"Show me top gainers on the London Stock Exchange"
"Analyze HSBC (HSBA) on LSE with technical indicators"
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
- Bitget (BITGET) - Fast-growing global exchange
- 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)
- NYSE (NYSE) - New York Stock Exchange (IBM, GE, JPM)
- LSE (LSE) - London Stock Exchange (HSBA, AZN, SHEL, BP.)
- BIST (BIST) - Turkish stock market (Borsa Δ°stanbul)
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. 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)
# 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