Advanced AI Trading Intelligence Framework — MCP server with walk-forward backtesting, trade logs, equity curves, 1h timeframe, sentiment, Yahoo Finance, and 30+ technical analysis tools
Project description
📈 AI Trading Intelligence Framework — MCP Server
The most complete AI-powered trading toolkit for Claude and MCP clients. Backtesting + Live Sentiment + Yahoo Finance + 30+ Technical Analysis Tools — all in one MCP server.
⭐ If this tool improves your workflow, please star the repo and consider sponsoring — it keeps the project alive and growing!
🎥 Framework Demo
✨ Why tradingview-mcp?
| Feature | tradingview-mcp |
Traditional Setups | Bloomberg Terminal |
|---|---|---|---|
| Setup Time | 5 minutes | Hours (Docker, Conda...) | Weeks (Contracts) |
| Cost | Free & Open Source | Variable | $30k+/year |
| Backtesting | ✅ 6 strategies + Sharpe | ❌ Manual scripting | ✅ Proprietary |
| Live Sentiment | ✅ Reddit + RSS news | ❌ Separate setup | ✅ Terminal |
| Market Data | ✅ Live / Real-Time | Historical / Delayed | Live |
| API Keys | None required | Multiple (OpenAI, etc.) | N/A |
🚀 Quick Start (5 Minutes)
Install via pip
pip install tradingview-mcp-server
Claude Desktop Config (claude_desktop_config.json)
{
"mcpServers": {
"tradingview": {
"command": "uvx",
"args": ["tradingview-mcp-server"]
}
}
}
Or run from source
git clone https://github.com/atilaahmettaner/tradingview-mcp
cd tradingview-mcp
uv run tradingview-mcp
🤖 Multi-Agent Architecture
Unlike basic screeners, this framework deploys specialized AI agents that debate findings in real-time:
- 🛠️ Technical Analyst — Bollinger Bands (±3 proprietary rating), RSI, MACD
- 🌊 Sentiment & Momentum Analyst — Reddit community sentiment + price momentum
- 🛡️ Risk Manager — Volatility, drawdown risk, mean-reversion signals
Output: STRONG BUY / BUY / HOLD / SELL / STRONG SELL with confidence score
🔧 All 30+ MCP Tools
📊 Backtesting Engine (New in v0.6.0)
| Tool | Description |
|---|---|
backtest_strategy |
Backtest 1 of 6 strategies with institutional metrics (Sharpe, Calmar, Expectancy) |
compare_strategies |
Run all 6 strategies on same symbol and rank by performance |
6 Strategies to Test:
rsi— RSI oversold/overbought mean reversionbollinger— Bollinger Band mean reversionmacd— MACD golden/death crossema_cross— EMA 20/50 Golden/Death Crosssupertrend— ATR-based Supertrend trend following 🔥donchian— Donchian Channel breakout (Turtle Trader style)
Metrics you get: Win Rate, Total Return, Sharpe Ratio, Calmar Ratio, Max Drawdown, Profit Factor, Expectancy, Best/Worst Trade, vs Buy-and-Hold, with realistic commission + slippage simulation.
Example prompt: "Compare all strategies on BTC-USD for 2 years"
→ #1 Supertrend: +31.5% | Sharpe: 2.1 | WR: 62%
→ #2 Bollinger: +18.3% | Sharpe: 3.4 | WR: 75%
→ Buy & Hold: -5.0%
💰 Yahoo Finance — Real-Time Prices (New in v0.6.0)
| Tool | Description |
|---|---|
yahoo_price |
Real-time quote: price, change %, 52w high/low, market state |
market_snapshot |
Global overview: S&P500, NASDAQ, VIX, BTC, ETH, EUR/USD, SPY, GLD |
Supports: Stocks (AAPL, TSLA, NVDA), Crypto (BTC-USD, ETH-USD, SOL-USD), ETFs (SPY, QQQ, GLD), Indices (^GSPC, ^DJI, ^IXIC, ^VIX), FX (EURUSD=X), Turkish (THYAO.IS, SASA.IS)
🧠 AI Sentiment & Intelligence (New in v0.5.0)
| Tool | Description |
|---|---|
market_sentiment |
Reddit sentiment across finance communities (bullish/bearish score, top posts) |
financial_news |
Live RSS headlines from Reuters, CoinDesk, CoinTelegraph |
combined_analysis |
Power Tool: TradingView technicals + Reddit sentiment + live news → confluence decision |
📈 Technical Analysis Core
| Tool | Description |
|---|---|
get_technical_analysis |
Full TA: RSI, MACD, Bollinger, 23 indicators with BUY/SELL/HOLD |
get_multiple_analysis |
Bulk TA for multiple symbols at once |
get_bollinger_band_analysis |
Proprietary ±3 BB rating system |
get_stock_decision |
3-layer decision engine (ranking + trade setup + quality score) |
screen_stocks |
Multi-exchange screener with 20+ filter criteria |
scan_by_signal |
Scan by signal type (oversold, trending, breakout...) |
get_candlestick_patterns |
15 candlestick pattern detector |
get_multi_timeframe_analysis |
Weekly→Daily→4H→1H→15m alignment analysis |
🌍 Multi-Exchange Support
| Exchange | Tools |
|---|---|
| Binance | Crypto screener, all pairs |
| KuCoin / Bybit+ | Crypto screener |
| NASDAQ / NYSE | US stocks (AAPL, TSLA, NVDA...) |
| EGX (Egypt) | egx_market_overview, egx_stock_screener, egx_trade_plan, egx_fibonacci_retracement |
| Turkish (BIST) | Via TradingView screener |
💬 Example AI Conversations
You: "Give me a full market snapshot right now"
AI: [market_snapshot] → S&P500 -3.4%, BTC +0.1%, VIX 31 (+13%), EUR/USD 1.15
You: "What is Reddit saying about NVDA?"
AI: [market_sentiment] → Strongly Bullish (0.41) | 23 posts | 18 bullish
You: "Backtest RSI strategy on BTC-USD for 2 years"
AI: [backtest_strategy] → +31.5% return | 100% win rate | 2 trades | B&H: -5%
You: "Which strategy worked best on AAPL in the last 2 years?"
AI: [compare_strategies] → Supertrend #1 (+14.6%, Sharpe 3.09), MACD last (-9.1%)
You: "Analyze TSLA with all signals: technical + sentiment + news"
AI: [combined_analysis] → BUY (Technical STRONG BUY + Bullish Reddit + Positive news)
💖 Support the Project
This framework is free and open source, built in spare time. If it saves you hours of research or helps you make better decisions, please consider sponsoring:
| Tier | Monthly | What You Get |
|---|---|---|
| ☕ Coffee | $5 | Heartfelt gratitude + name in README |
| 🚀 Supporter | $15 | Above + priority bug fixes |
| 💎 Pro | $30 | Above + priority feature requests |
Every sponsor directly funds new features like Walk-Forward Backtesting, Twitter/X sentiment, and managed cloud hosting.
📋 Roadmap
- TradingView technical analysis (30+ indicators)
- Multi-exchange screener (Binance, KuCoin, EGX, US stocks)
- Reddit sentiment analysis
- Live financial news (RSS)
- Yahoo Finance real-time prices
- Backtesting engine (6 strategies + Sharpe/Calmar/Expectancy)
- Walk-forward backtesting (overfitting detection)
- Twitter/X market sentiment
- Paper trading simulation
- Managed cloud hosting (no local setup)
📄 License
MIT License — see LICENSE for details.
Disclaimer: This tool is for educational and research purposes only. It does not constitute financial advice. Always do your own research before making investment decisions.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tradingview_mcp_server-0.7.0.tar.gz.
File metadata
- Download URL: tradingview_mcp_server-0.7.0.tar.gz
- Upload date:
- Size: 123.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1f0feab328503ea2949bcbccb97635bf6bad3b0cc83ec318e90e2528ab2efa99
|
|
| MD5 |
ab9dc75954e8394b2f22d3bdb78b1c8b
|
|
| BLAKE2b-256 |
92eee9b7932ee609604b4cbe9bf1180838d24d5cf9e4bc1ec3ef3b50f1f21e80
|
File details
Details for the file tradingview_mcp_server-0.7.0-py3-none-any.whl.
File metadata
- Download URL: tradingview_mcp_server-0.7.0-py3-none-any.whl
- Upload date:
- Size: 125.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4a7fca012cf2589d173c9522a5441ad33b761b6e70fa47a35d68e04e46bc5b4d
|
|
| MD5 |
17ae0f424c6d96c7a6d27a370351807a
|
|
| BLAKE2b-256 |
2f3222abb4f8d707c1e67a5d953df3c1ef218b54438991fa30160e52919527b1
|