[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72436":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":36,"readmeContent":37,"aiSummary":38,"trendingCount":16,"starSnapshotCount":16,"syncStatus":15,"lastSyncTime":39,"discoverSource":40},72436,"tradingview-mcp","atilaahmettaner\u002Ftradingview-mcp","atilaahmettaner","Real-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.","https:\u002F\u002Fcryptosieve.com\u002Fmcp-server",null,"Python",3057,657,42,2,0,50,133,465,150,30.45,"MIT License",false,"main",true,[27,28,29,30,31,32,33,34,35],"claude-desktop","cryptocurrency","mcp-server","mcp-tools","openclaw","stock-market","trading-mcp","trading-strategies","tradingview","2026-06-12 02:03:03","# 📈 AI Trading Intelligence Framework — MCP Server\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F25110\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Ftrendshift.io\u002Fapi\u002Fbadge\u002Frepositories\u002F25110\" alt=\"atilaahmettaner%2Ftradingview-mcp | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n**The most complete AI-powered trading toolkit for Claude and MCP clients.**\nBacktesting + Live Sentiment + Yahoo Finance + 30+ Technical Analysis Tools — all in one MCP server.\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Python 3.10+](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.10+-blue.svg)](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n[![MCP Ready](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-Ready-brightgreen)](https:\u002F\u002Fmodelcontextprotocol.com\u002F)\n[![OpenClaw Ready](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOpenClaw-Ready-blueviolet)](https:\u002F\u002Fopenclaw.ai)\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-v0.7.0-blue)](https:\u002F\u002Fgithub.com\u002Fatilaahmettaner\u002Ftradingview-mcp\u002Freleases)\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPyPI-tradingview--mcp--server-orange)](https:\u002F\u002Fpypi.org\u002Fproject\u002Ftradingview-mcp-server\u002F)\n[![GitHub Sponsors](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor-❤️-pink?logo=github-sponsors)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fatilaahmettaner)\n\n> **⭐ If this tool improves your workflow, please star the repo and consider [sponsoring](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fatilaahmettaner) — it keeps the project alive and growing!**\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fatilaahmettaner\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F☕_Coffee_($5)-Sponsor-orange?style=for-the-badge&logo=github-sponsors\" alt=\"Sponsor $5\"\u002F>\n\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fatilaahmettaner\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🚀_Supporter_($15)-Sponsor-blueviolet?style=for-the-badge&logo=github-sponsors\" alt=\"Sponsor $15\"\u002F>\n\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fatilaahmettaner\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F💎_Pro_($30)-Sponsor-gold?style=for-the-badge&logo=github-sponsors\" alt=\"Sponsor $30\"\u002F>\n\u003C\u002Fa>\n\n> **🚀 Don't want to fight `uv` \u002F `pandas` \u002F Python on Windows?**  \n> [**pro.cryptosieve.com**](https:\u002F\u002Fpro.cryptosieve.com) — same 30+ tools,  \n> one connector URL into Claude.ai, ChatGPT, Copilot, Cursor. **$9\u002Fmonth** with 7-day free trial.  \n> Self-hosting is free and always will be; the hosted version is just for  \n> folks who'd rather skip the ops dance.\n---\n\n## 🎥 Framework Demo\n\nhttps:\u002F\u002Fgithub-production-user-asset-6210df.s3.amazonaws.com\u002F67838093\u002F478689497-4a605d98-43e8-49a6-8d3a-559315f6c01d.mp4\n\n---\n\n## 🏗️ Architecture\n\n![tradingview-mcp Architecture](assets\u002Farchitecture.png)\n\n---\n\n## ✨ Why tradingview-mcp?\n\n| Feature | `tradingview-mcp` | Traditional Setups | Bloomberg Terminal |\n|---------|-------------------|--------------------|--------------------|\n| **Setup Time** | 5 minutes | Hours (Docker, Conda...) | Weeks (Contracts) |\n| **Cost** | Free & Open Source | Variable | $30k+\u002Fyear |\n| **Backtesting** | ✅ 6 strategies + Sharpe | ❌ Manual scripting | ✅ Proprietary |\n| **Live Sentiment** | ✅ Reddit + RSS news | ❌ Separate setup | ✅ Terminal |\n| **Market Data** | ✅ Live \u002F Real-Time | Historical \u002F Delayed | Live |\n| **API Keys** | **None required** | Multiple (OpenAI, etc.) | N\u002FA |\n\n---\n\n## 🚀 Quick Start (5 Minutes)\n\n### Install via pip\n```bash\npip install tradingview-mcp-server\n```\n\n### Claude Desktop Config (`claude_desktop_config.json`)\n\n> **Note:** On macOS, GUI apps like Claude Desktop may not have `~\u002F.local\u002Fbin` in their PATH. Use the full path to `uvx` to avoid \"command not found\" errors.\n\n```json\n{\n  \"mcpServers\": {\n    \"tradingview\": {\n      \"command\": \"\u002FUsers\u002FYOUR_USERNAME\u002F.local\u002Fbin\u002Fuvx\",\n      \"args\": [\"--from\", \"tradingview-mcp-server\", \"tradingview-mcp\"]\n    }\n  }\n}\n```\n\nOn Linux, replace `\u002FUsers\u002FYOUR_USERNAME` with `\u002Fhome\u002FYOUR_USERNAME`. On Windows, use `%USERPROFILE%\\.local\\bin\\uvx.exe`.\n\n### Codex Plugin Config\n\nThis repository also includes mcp-only Codex plugin metadata:\n\n- `.codex-plugin\u002Fplugin.json`\n- `.codex-mcp.json`\n\nThe plugin uses the same PyPI package entrypoint:\n\n```json\n{\n  \"mcpServers\": {\n    \"tradingview\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"tradingview-mcp-server\", \"tradingview-mcp\"]\n    }\n  }\n}\n```\n\nAfter installing or enabling the Codex plugin, restart Codex so the MCP server is loaded in the next session. Depending on your Codex version, `codex mcp list` may show registered MCP servers, but tool availability should be verified in a fresh Codex session.\n\n### Or run from source\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fatilaahmettaner\u002Ftradingview-mcp\ncd tradingview-mcp\nuv run tradingview-mcp\n```\n\n---\n\n## 🛠️ Troubleshooting\n\n### 🪟 Windows: `MCP error -32001: Request timed out` on first launch\n\nSymptom — you see this in the Claude Desktop logs shortly after adding the config:\n\n```\n[tradingview] Server started and connected successfully\n[tradingview] Message from client: initialize ...\n[60 seconds later]\n[tradingview] notifications\u002Fcancelled — reason: \"MCP error -32001: Request timed out\"\n```\n\n**Why it happens:** on Windows with Python 3.14, `uvx` downloads `tradingview-mcp-server`, creates a fresh virtualenv, and installs dependencies the first time it runs. Because `pandas` has no prebuilt wheel for Python 3.14 yet, pip falls back to a source build — which typically exceeds Claude Desktop's 60-second MCP initialization timeout.\n\n**Fix — pin to Python 3.13 (has prebuilt pandas wheels):**\n\n```json\n{\n  \"mcpServers\": {\n    \"tradingview\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--python\", \"3.13\", \"--from\", \"tradingview-mcp-server\", \"tradingview-mcp\"]\n    }\n  }\n}\n```\n\nOn macOS use the full path to `uvx` (see the note in Quick Start). On Windows `uvx` is typically `%USERPROFILE%\\.local\\bin\\uvx.exe`.\n\n**Alternative — pre-install once, then let Claude Desktop reuse the cache:**\n\n```bash\n# Run in a terminal before launching Claude Desktop\nuv tool install --python 3.13 tradingview-mcp-server\n```\n\nAfter the install finishes, start Claude Desktop with the normal config and the server will come up instantly (cache is already warm).\n\n> _Credit: [@wyh4444](https:\u002F\u002Fgithub.com\u002Fwyh4444) for the original report in [#24](https:\u002F\u002Fgithub.com\u002Fatilaahmettaner\u002Ftradingview-mcp\u002Fissues\u002F24)._\n\n---\n\n## 📱 Use via Telegram, WhatsApp & More (OpenClaw)\n\nConnect this server to **Telegram, WhatsApp, Discord** and 20+ messaging platforms using [OpenClaw](https:\u002F\u002Fopenclaw.ai) — a self-hosted AI gateway. **Tested & verified on Hetzner VPS (Ubuntu 24.04).**\n\n### How It Works\n\n> OpenClaw routes Telegram messages to an AI agent. The agent uses `trading.py` — a thin Python wrapper — to call `tradingview-mcp` functions and return formatted results. **No MCP protocol needed between OpenClaw and the server; it's a direct Python import.**\n\n```\nTelegram → OpenClaw agent (AI model) → trading.py (bash) → tradingview-mcp → Yahoo Finance\n```\n\n### Quick Setup\n\n```bash\n# 1. Install UV and tradingview-mcp\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh && source ~\u002F.bashrc\nuv tool install tradingview-mcp-server\n\n# 2. Configure OpenClaw channels\ncat > ~\u002F.openclaw\u002Fopenclaw.json \u003C\u003C 'EOF'\n{\n  channels: {\n    telegram: {\n      botToken: \"YOUR_BOT_TOKEN_HERE\",\n    },\n  },\n}\nEOF\n\n# 3. Configure gateway + agent\nopenclaw config set gateway.mode local\nopenclaw config set acp.defaultAgent main\n\n# 4. Set your AI model (choose ONE option below)\nopenclaw configure --section model\n\n# 5. Install the skill + tool wrapper\nmkdir -p ~\u002F.agents\u002Fskills\u002Ftradingview-mcp ~\u002F.openclaw\u002Ftools\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fatilaahmettaner\u002Ftradingview-mcp\u002Fmain\u002Fopenclaw\u002FSKILL.md \\\n  -o ~\u002F.agents\u002Fskills\u002Ftradingview-mcp\u002FSKILL.md\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fatilaahmettaner\u002Ftradingview-mcp\u002Fmain\u002Fopenclaw\u002Ftrading.py \\\n  -o ~\u002F.openclaw\u002Ftools\u002Ftrading.py && chmod +x ~\u002F.openclaw\u002Ftools\u002Ftrading.py\n\n# 6. Start the gateway\nopenclaw gateway install\nsystemctl --user start openclaw-gateway.service\n```\n\n### Choose Your AI Model\n\nOpenRouter is **not required** — use whichever provider you have a key for:\n\n| Provider | Model ID for OpenClaw | Get Key |\n|----------|----------------------|---------|\n| **OpenRouter** (aggregator — access to all models) | `openrouter\u002Fgoogle\u002Fgemini-3-flash-preview` | [openrouter.ai\u002Fkeys](https:\u002F\u002Fopenrouter.ai\u002Fkeys) |\n| **Anthropic** (Claude direct) | `anthropic\u002Fclaude-sonnet-4-5` | [console.anthropic.com](https:\u002F\u002Fconsole.anthropic.com) |\n| **Google** (Gemini direct) | `google\u002Fgemini-2.5-flash` | [aistudio.google.com](https:\u002F\u002Faistudio.google.com) |\n| **OpenAI** (GPT direct) | `openai\u002Fgpt-4o-mini` | [platform.openai.com](https:\u002F\u002Fplatform.openai.com) |\n\n```bash\n# Examples — set your chosen model:\nopenclaw config set agents.defaults.model \"openrouter\u002Fgoogle\u002Fgemini-3-flash-preview\"  # via OpenRouter\nopenclaw config set agents.defaults.model \"anthropic\u002Fclaude-sonnet-4-5\"               # Anthropic direct\nopenclaw config set agents.defaults.model \"google\u002Fgemini-2.5-flash\"                   # Google direct\n```\n\n> ⚠️ **Important:** Prefix must match your provider. `google\u002F...` needs a Google API key. `openrouter\u002F...` needs an OpenRouter key.\n\n### ⚠️ Common Mistakes\n\n| Symptom | Cause | Fix |\n|---------|-------|-----|\n| `Unrecognized keys: mcpServers` | `mcpServers` not supported in this version | Remove from config, use bash wrapper |\n| `No API key for provider \"google\"` | Used `google\u002Fmodel` but only have OpenRouter key | Use `openrouter\u002Fgoogle\u002Fmodel` instead |\n| `which agent?` loop | `acp.defaultAgent` not set | `openclaw config set acp.defaultAgent main` |\n| Gateway won't start | `gateway.mode` missing | `openclaw config set gateway.mode local` |\n\n### Test Your Bot\n\nOnce running, send your Telegram bot:\n```\nmarket snapshot\nbacktest RSI strategy for AAPL, 1 year\ncompare all strategies for BTC-USD\n```\n\n👉 **[Full OpenClaw Setup Guide →](OPENCLAW.md)**\n\n---\n\n\n\n\n\nUnlike basic screeners, this framework deploys **specialized AI agents** that debate findings in real-time:\n\n1. **🛠️ Technical Analyst** — Bollinger Bands (±3 proprietary rating), RSI, MACD\n2. **🌊 Sentiment & Momentum Analyst** — Reddit community sentiment + price momentum\n3. **🛡️ Risk Manager** — Volatility, drawdown risk, mean-reversion signals\n\n*Output: `STRONG BUY` \u002F `BUY` \u002F `HOLD` \u002F `SELL` \u002F `STRONG SELL` with confidence score*\n\n---\n\n## 🔧 All 30+ MCP Tools\n\n### 📊 Backtesting Engine *(New in v0.6.0)*\n\n| Tool | Description |\n|------|-------------|\n| `backtest_strategy` | Backtest 1 of 6 strategies with institutional metrics (Sharpe, Calmar, Expectancy) |\n| `compare_strategies` | Run all 6 strategies on same symbol and rank by performance |\n\n**6 Strategies to Test:**\n- `rsi` — RSI oversold\u002Foverbought mean reversion\n- `bollinger` — Bollinger Band mean reversion\n- `macd` — MACD golden\u002Fdeath cross\n- `ema_cross` — EMA 20\u002F50 Golden\u002FDeath Cross\n- `supertrend` — ATR-based Supertrend trend following 🔥\n- `donchian` — Donchian Channel breakout (Turtle Trader style)\n\n**Metrics you get:** Win Rate, Total Return, Sharpe Ratio, Calmar Ratio, Max Drawdown, Profit Factor, Expectancy, Best\u002FWorst Trade, vs Buy-and-Hold, with **realistic commission + slippage simulation**.\n\n```\nExample prompt: \"Compare all strategies on BTC-USD for 2 years\"\n→ #1 Supertrend: +31.5% | Sharpe: 2.1 | WR: 62%\n→ #2 Bollinger:  +18.3% | Sharpe: 3.4 | WR: 75%\n→ Buy & Hold:    -5.0%\n```\n\n---\n\n### 💰 Yahoo Finance — Real-Time Prices *(New in v0.6.0)*\n\n| Tool | Description |\n|------|-------------|\n| `yahoo_price` | Real-time quote: price, change %, 52w high\u002Flow, market state |\n| `market_snapshot` | Global overview: S&P500, NASDAQ, VIX, BTC, ETH, EUR\u002FUSD, SPY, GLD |\n\n**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)\n\n---\n\n### 🧠 AI Sentiment & Intelligence *(New in v0.5.0)*\n\n| Tool | Description |\n|------|-------------|\n| `market_sentiment` | Reddit sentiment across finance communities (bullish\u002Fbearish score, top posts) |\n| `financial_news` | Live RSS headlines from Reuters, CoinDesk, CoinTelegraph |\n| `combined_analysis` | **Power Tool**: TradingView technicals + Reddit sentiment + live news → confluence decision |\n\n---\n\n### 📈 Technical Analysis Core\n\n| Tool | Description |\n|------|-------------|\n| `get_technical_analysis` | Full TA: RSI, MACD, Bollinger, 23 indicators with BUY\u002FSELL\u002FHOLD |\n| `get_multiple_analysis` | Bulk TA for multiple symbols at once |\n| `get_bollinger_band_analysis` | Proprietary ±3 BB rating system |\n| `get_stock_decision` | 3-layer decision engine (ranking + trade setup + quality score) |\n| `screen_stocks` | Multi-exchange screener with 20+ filter criteria |\n| `scan_by_signal` | Scan by signal type (oversold, trending, breakout...) |\n| `get_candlestick_patterns` | 15 candlestick pattern detector |\n| `get_multi_timeframe_analysis` | Weekly→Daily→4H→1H→15m alignment analysis |\n\n---\n\n### 🌍 Multi-Exchange Support\n\n| Exchange | Tools |\n|----------|-------|\n| **Binance** | Crypto screener, all pairs |\n| **KuCoin \u002F Bybit+** | Crypto screener |\n| **NASDAQ \u002F NYSE** | US stocks (AAPL, TSLA, NVDA...) |\n| **EGX (Egypt)** | `egx_market_overview`, `egx_stock_screener`, `egx_trade_plan`, `egx_fibonacci_retracement` |\n| **Turkish (BIST)** | Via TradingView screener |\n\n---\n\n## 💬 Example AI Conversations\n\n```\nYou: \"Give me a full market snapshot right now\"\nAI: [market_snapshot] → S&P500 -3.4%, BTC +0.1%, VIX 31 (+13%), EUR\u002FUSD 1.15\n\nYou: \"What is Reddit saying about NVDA?\"\nAI: [market_sentiment] → Strongly Bullish (0.41) | 23 posts | 18 bullish\n\nYou: \"Backtest RSI strategy on BTC-USD for 2 years\"\nAI: [backtest_strategy] → +31.5% return | 100% win rate | 2 trades | B&H: -5%\n\nYou: \"Which strategy worked best on AAPL in the last 2 years?\"\nAI: [compare_strategies] → Supertrend #1 (+14.6%, Sharpe 3.09), MACD last (-9.1%)\n\nYou: \"Analyze TSLA with all signals: technical + sentiment + news\"\nAI: [combined_analysis] → BUY (Technical STRONG BUY + Bullish Reddit + Positive news)\n```\n\n---\n\n## 💖 Support the Project\n\nThis 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:\n\n| Tier | Monthly | What You Get |\n|------|---------|--------------|\n| ☕ Coffee | $5 | Heartfelt gratitude + name in README |\n| 🚀 Supporter | $15 | Above + priority bug fixes |\n| 💎 Pro | $30 | Above + priority feature requests |\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fatilaahmettaner\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBecome_a_Sponsor-pink?style=for-the-badge&logo=github-sponsors\" alt=\"Sponsor\"\u002F>\n\u003C\u002Fa>\n\nEvery sponsor directly funds new features like Walk-Forward Backtesting, Twitter\u002FX sentiment, and managed cloud hosting.\n\n---\n\n## 📋 Roadmap\n\n- [x] TradingView technical analysis (30+ indicators)\n- [x] Multi-exchange screener (Binance, KuCoin, MEXC, EGX, US stocks)\n- [x] Reddit sentiment analysis\n- [x] Live financial news (RSS)\n- [x] Yahoo Finance real-time prices\n- [x] Backtesting engine (6 strategies + Sharpe\u002FCalmar\u002FExpectancy)\n- [ ] Walk-forward backtesting (overfitting detection)\n- [ ] Twitter\u002FX market sentiment\n- [ ] Paper trading simulation\n- [ ] Managed cloud hosting (no local setup)\n\n---\n\n## 📄 License\n\nMIT License — see [LICENSE](LICENSE) for details.\n\n---\n\n*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.*\n","tradingview-mcp 是一个基于人工智能的交易工具包，专为Claude和MCP客户端设计。它集成了实时加密货币和股票筛选、高级技术指标（如布林带智能分析）、蜡烛图模式识别等功能，并原生支持Claude Desktop集成。该项目使用Python编写，支持多交易所操作（包括Binance、KuCoin、Bybit等），提供了超过30种技术分析工具，支持回测和实时市场情绪分析。适用于需要高效且全面交易策略支持的专业交易者及开发者，无论是进行策略开发还是日常交易决策都能提供强有力的支持。","2026-06-11 03:42:03","high_star"]