📈 Ultimate TradingView Agent — AI Trading Intelligence Framework

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

https://github-production-user-asset-6210df.s3.amazonaws.com/67838093/478689497-4a605d98-43e8-49a6-8d3a-559315f6c01d.mp4

Related MCP server: tradingview-mcp

🏗️ Architecture

✨ Why ultimate-tradingview-agent?

🚀 Quick Start (5 Minutes)

Install via pip

pip install ultimate-tradingview-agent-server

Claude Desktop Config (claude_desktop_config.json)

Note: On macOS, GUI apps like Claude Desktop may not have ~/.local/bin in their PATH. Use the full path to uvx to avoid "command not found" errors.

{
  "mcpServers": {
    "tradingview": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uvx",
      "args": ["--from", "ultimate-tradingview-agent-server", "ultimate-tradingview-agent"]
    }
  }
}

On Linux, replace /Users/YOUR_USERNAME with /home/YOUR_USERNAME. On Windows, use %USERPROFILE%\.local\bin\uvx.exe.

Or run from source

git clone https://github.com/atilaahmettaner/ultimate-tradingview-agent
cd ultimate-tradingview-agent
uv run ultimate-tradingview-agent

📱 Use via Telegram, WhatsApp & More (OpenClaw)

Connect this server to Telegram, WhatsApp, Discord and 20+ messaging platforms using OpenClaw — a self-hosted AI gateway. Tested & verified on Hetzner VPS (Ubuntu 24.04).

How It Works

OpenClaw routes Telegram messages to an AI agent. The agent uses trading.py — a thin Python wrapper — to call ultimate-tradingview-agent functions and return formatted results. No MCP protocol needed between OpenClaw and the server; it's a direct Python import.

Telegram → OpenClaw agent (AI model) → trading.py (bash) → ultimate-tradingview-agent → Yahoo Finance

Quick Setup

# 1. Install UV and ultimate-tradingview-agent
curl -LsSf https://astral.sh/uv/install.sh | sh && source ~/.bashrc
uv tool install ultimate-tradingview-agent-server

# 2. Configure OpenClaw channels
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  channels: {
    telegram: {
      botToken: "YOUR_BOT_TOKEN_HERE",
    },
  },
}
EOF

# 3. Configure gateway + agent
openclaw config set gateway.mode local
openclaw config set acp.defaultAgent main

# 4. Set your AI model (choose ONE option below)
openclaw configure --section model

# 5. Install the skill + tool wrapper
mkdir -p ~/.agents/skills/ultimate-tradingview-agent ~/.openclaw/tools
curl -fsSL https://raw.githubusercontent.com/atilaahmettaner/ultimate-tradingview-agent/main/openclaw/SKILL.md \
  -o ~/.agents/skills/ultimate-tradingview-agent/SKILL.md
curl -fsSL https://raw.githubusercontent.com/atilaahmettaner/ultimate-tradingview-agent/main/openclaw/trading.py \
  -o ~/.openclaw/tools/trading.py && chmod +x ~/.openclaw/tools/trading.py

# 6. Start the gateway
openclaw gateway install
systemctl --user start openclaw-gateway.service

Choose Your AI Model

OpenRouter is not required — use whichever provider you have a key for:

# Examples — set your chosen model:
openclaw config set agents.defaults.model "openrouter/google/gemini-3-flash-preview"  # via OpenRouter
openclaw config set agents.defaults.model "anthropic/claude-sonnet-4-5"               # Anthropic direct
openclaw config set agents.defaults.model "google/gemini-2.5-flash"                   # Google direct

⚠️ Important: Prefix must match your provider. google/... needs a Google API key. openrouter/... needs an OpenRouter key.

⚠️ Common Mistakes

Test Your Bot

Once running, send your Telegram bot:

market snapshot
backtest RSI strategy for AAPL, 1 year
compare all strategies for BTC-USD

👉 Full OpenClaw Setup Guide →

Unlike basic screeners, this framework deploys specialized AI agents that debate findings in real-time:

1. 🛠️ Technical Analyst — Bollinger Bands (±3 proprietary rating), RSI, MACD

2. 🌊 Sentiment & Momentum Analyst — Reddit community sentiment + price momentum

3. 🛡️ 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)

6 Strategies to Test:

• rsi — RSI oversold/overbought mean reversion

• bollinger — Bollinger Band mean reversion

• macd — MACD golden/death cross

• ema_cross — EMA 20/50 Golden/Death Cross

• supertrend — 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)

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)

📈 Technical Analysis Core

🌍 Multi-Exchange Support

💬 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:

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.