TradingView MCP Server 📈

A lightweight Model Context Protocol (MCP) server for fetching TradingView chart snapshots. Uses Playwright for efficient browser automation with persistent sessions and cookie-based authentication.

Note: This uses Playwright because TradingView renders charts client-side with JavaScript/Canvas. There is no pure HTTP API for chart images. This is the lightest possible working solution (~150MB RAM vs ~500MB with Selenium).

✨ Features

• 🪶 Lightweight: Playwright in headless mode (~150MB vs ~500MB with Selenium)
• 🚀 Fast: Persistent browser reuse, 3-5 seconds per chart
• 🔐 Secure: Session-based authentication via cookies
• 🎨 Customizable: Configure chart dimensions, intervals, and themes
• 🔧 MCP Compatible: Works with any MCP-enabled client (Claude Desktop, etc.)
• ♻️ Efficient: Reuses browser instances across multiple requests

📋 Prerequisites

• Python 3.10 or higher
• A TradingView account (free or paid)
• TradingView session cookies

Table of Contents

• Installation
• Quick Start
• Usage
• Configuration
• Available Tools
• Symbol Format
• Troubleshooting
• Performance
• Contributing

🚀 Installation

1. Clone the repository

git clone https://github.com/yourusername/tradingview-mcp.git
cd tradingview-mcp

2. Create a virtual environment

# Windows
python -m venv venv
.\venv\Scripts\activate

# Linux/Mac
python3 -m venv venv
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

# Install Playwright browsers (one-time setup, ~150MB download)
python -m playwright install chromium

4. Configure credentials

1. Copy .env.example to .env:

   # Windows
   copy .env.example .env
   
   # Linux/Mac
   cp .env.example .env
   

2. Get your TradingView session cookies:

   • Log into TradingView in your browser
   • Press F12 to open Developer Tools
   • Go to Application tab (Chrome) or Storage tab (Firefox)
   • Navigate to Cookies > https://www.tradingview.com
   • Find and copy these two cookie values:
     • sessionid → Copy the entire value
     • sessionid_sign → Copy the entire value

   ⚠️ Important: Copy the full values including any special characters (slashes, equals signs, etc.). Don’t add quotes or extra spaces.

3. Edit .env and paste your values:

   TRADINGVIEW_SESSION_ID=your_actual_session_id_here
   TRADINGVIEW_SESSION_ID_SIGN=your_actual_session_id_sign_here
   

   Example (with fake values):

   TRADINGVIEW_SESSION_ID=47zlhkbl2weohrhmjgufeg1o24droaod
   TRADINGVIEW_SESSION_ID_SIGN=v3:6S2OD9ta349/yqN0RdCeK3UKxTl/tJr4AOoPRUa0Crk=
   

5. Test your setup (Optional but recommended)