TradingView
STDIOAdvanced MCP server for cryptocurrency and stock market analysis using TradingView data
Advanced MCP server for cryptocurrency and stock market analysis using TradingView data
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
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:
%APPDATA%\Claude\claude_desktop_config.json~/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" ] } } }
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)"
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!
5m, 15m, 1h, 4h, 1D, 1W, 1M
1. "No data found" errors:
2. Empty arrays or rate limiting:
3. Claude Desktop not detecting the server:
uv --version4. Slow responses:
# 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.py
The server is designed to be easily extensible. Check src/tradingview_mcp/core/ for the modular architecture.
We welcome contributions! Here's how:
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
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