Tv MCP
A high-performance FastMCP server for programmatically scraping TradingView market data. The server provides unified endpoints for retrieving historical price data, computing technical indicators, and extracting market-relevant news. It is designed for automated research workflows, trading systems, and data-driven analytics pipelines.
Ask AI about Tv MCP
Powered by Claude · Grounded in docs
I know everything about Tv MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
TradingView MCP Server
FastMCP server for TradingView data with an authenticated SSE endpoint for remote clients.
This repository is configured for SSE-first deployment on Vercel.
Quick Start
git clone https://github.com/smitkunpara/tradingview-mcp.git
cd tradingview-mcp
uv sync
cp .env.example .env
Set required values in .env:
TRADINGVIEW_COOKIETV_CLIENT_KEY
Run Local SSE Server
export TV_CLIENT_KEY="your-client-key"
uv run tradingview-mcp-sse
Defaults:
- Host:
0.0.0.0 - Port:
8000 - SSE endpoint:
/sse - Health endpoint:
/health
Optional overrides:
export MCP_HTTP_HOST="0.0.0.0"
export MCP_HTTP_PORT="8000"
export MCP_SSE_PATH="/sse"
Authentication headers accepted on SSE endpoint:
X-API-Key: <TV_CLIENT_KEY>X-Client-Key: <TV_CLIENT_KEY>Authorization: Bearer <TV_CLIENT_KEY>
Optional OAuth mode:
- Set
TV_OAUTH_JWKS_URL(and optional issuer/audience/scope settings) to validate JWT bearer tokens. - API key authentication remains available as fallback.
Smoke Test (Vercel)
uv run python scripts/vercel_sse_smoke_test.py --url https://tradingview-mcp.vercel.app --client-key "$TV_CLIENT_KEY"
Available Tools
| Category | Tools |
|---|---|
| Market Data | get_historical_data, get_all_indicators |
| News | get_news_headlines, get_news_content |
| Community | get_ideas, get_minds |
| Options | get_option_chain_greeks, get_option_chain_oi |
Documentation
| Guide | Description |
|---|---|
| Configuration Reference | Environment variables and runtime configuration |
| Deployment Guide | SSE deployment on Vercel |
License
MIT — see LICENSE.
