How atilaahmettaner/tradingview-mcp works
TradingView MCP exposes market-data and analysis tools to AI clients. The main workflow is a client tool request, server-side validation and dispatch, then market-data retrieval and domain analysis before a structured result returns. Major branches include screeners and scanners, technical and smart-money analysis, backtesting, sentiment/news, Yahoo Finance, futures/options, and EGX-specific analysis; hosted chart rendering is also documented. Service internals and external-provider links are based on the sampled source and README, so unsampled tool wiring is represented only where supported.
Main entry points: server.py MCP Server · egx_service.py EGX Analysis · screener_service.py TradingView Screener · scanner_service.py Market Scanners
Components 27
MCP Interface
- MCP Server
src/tradingview_mcp/server.py - Input Validation
src/tradingview_mcp/core/utils/validators.py - Error Envelopes
src/tradingview_mcp/core/errors.py - Interactive Charts
src/tradingview_mcp/server.py
Market Data
- TradingView Screener
src/tradingview_mcp/core/services/screener_service.py - Screener Provider
src/tradingview_mcp/core/services/screener_provider.py - Market Scanners
src/tradingview_mcp/core/services/scanner_service.py - Symbol Universe
src/tradingview_mcp/core/services/coinlist.py - Exchange Symbol Lists
src/tradingview_mcp/coinlist - Yahoo Finance
src/tradingview_mcp/core/services/yahoo_finance_service.py - Proxy Manager
src/tradingview_mcp/core/services/proxy_manager.py
Analysis
- Technical Indicators
src/tradingview_mcp/core/services/indicators.py - Indicator Calculations
src/tradingview_mcp/core/services/indicators_calc.py - Smart-Money Analysis
src/tradingview_mcp/core/services/smart_money_service.py - Backtesting
src/tradingview_mcp/core/services/backtest_service.py - News Sentiment
src/tradingview_mcp/core/services/marketaux_service.py
Market Specialties
- Futures Analysis
src/tradingview_mcp/core/services/futures_service.py - Options Analysis
src/tradingview_mcp/core/services/options_service.py - EGX Analysis
src/tradingview_mcp/core/services/egx_service.py - EGX Reference Data
src/tradingview_mcp/core/data/egx_sectors.py - Extended Hours
src/tradingview_mcp/core/services/extended_hours_service.py - Bitcoin Market
src/tradingview_mcp/core/services/bitcoin_market_service.py - Multi-Agent Analysis
src/tradingview_mcp/core/services/multi_agent_service.py
Other components
- MCP Client
- TradingView Data
- Marketaux News
- Yahoo Market Data
Connections 28
- MCP Client → MCP Server: requests tools
- MCP Server → Input Validation: validates inputs
- MCP Server → TradingView Screener: dispatches market queries
- MCP Server → Market Scanners: dispatches scans
- MCP Server → Technical Indicators: dispatches analysis
- MCP Server → Backtesting: dispatches backtests
- MCP Server → News Sentiment: dispatches sentiment
- MCP Server → Yahoo Finance: dispatches quotes
- MCP Server → Futures Analysis: dispatches futures tools
- MCP Server → Options Analysis: dispatches options tools
- MCP Server → EGX Analysis: dispatches EGX tools
- MCP Server → Extended Hours: dispatches hours data
- MCP Server → Bitcoin Market: dispatches market data
- MCP Server → Multi-Agent Analysis: dispatches combined analysis
- MCP Server → Interactive Charts: serves chart tools
- MCP Server → Error Envelopes: formats failures
- Symbol Universe → Exchange Symbol Lists: loads symbols
- MCP Server → Symbol Universe: resolves symbols
- TradingView Screener → TradingView Data: fetches analysis
- Screener Provider → TradingView Data: fetches screener data
- Market Scanners → TradingView Screener: queries market data
- EGX Analysis → EGX Reference Data: reads sector metadata
- EGX Analysis → TradingView Data: fetches EGX analysis
- Technical Indicators → Indicator Calculations: uses calculations
- Smart-Money Analysis → Indicator Calculations: uses calculations
- News Sentiment → Marketaux News: fetches news
- Yahoo Finance → Yahoo Market Data: fetches quotes
- Proxy Manager → TradingView Data: routes proxied requests