tradingview-mcp 26.0.0__tar.gz → 26.3.0__tar.gz

{tradingview_mcp-26.0.0 → tradingview_mcp-26.3.0}/.gitignore

@@ -1,6 +1,3 @@
-# Reference files
-referance/
-
 # Environment
 .env
 
@@ -19,6 +16,7 @@ dist/
 # Unit test / coverage reports
 .pytest_cache/
 .coverage
+coverage.xml
 htmlcov/
 
 # Virtual environments

tradingview_mcp-26.3.0/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: tradingview-mcp
+Version: 26.3.0
+Summary: A comprehensive MCP server for TradingView market screening with integrated screener functionality
+Project-URL: Homepage, https://github.com/k73a/tradingview-mcp
+Project-URL: Documentation, https://github.com/k73a/tradingview-mcp#readme
+Project-URL: Repository, https://github.com/k73a/tradingview-mcp
+Project-URL: Issues, https://github.com/k73a/tradingview-mcp/issues
+Project-URL: Changelog, https://github.com/k73a/tradingview-mcp/blob/main/CHANGELOG.md
+Author: TradingView MCP Team
+License: MIT
+License-File: LICENSE
+Keywords: crypto,mcp,model-context-protocol,screener,stocks,technical-analysis,trading,tradingview
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pyright>=1.1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# TradingView MCP Server
+
+[![PyPI version](https://badge.fury.io/py/tradingview-mcp.svg)](https://badge.fury.io/py/tradingview-mcp)
+[![Python](https://img.shields.io/pypi/pyversions/tradingview-mcp.svg)](https://pypi.org/project/tradingview-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP server for TradingView market screening. Supports stocks, crypto, forex, futures, bonds across 76+ markets.
+
+## Quick Start
+```json
+{
+  "mcpServers": {
+    "tradingview": {
+      "command": "uvx",
+      "args": ["tradingview-mcp"]
+    }
+  }
+}
+```
+
+## Smart Features
+
+- **Auto-Market Detection**: If you search for `EURUSD` or `BTCUSDT`, the server automatically checks Forex and Crypto markets if not found in stocks.
+- **Strict Exchange Support**: Use `EXCHANGE:SYMBOL` format (e.g., `BINANCE:BTCUSDT`, `FX:EURUSD`) to target specific markets.
+- **Smart Filters**: You can use human-readable names in filters (e.g., `"Relative Strength Index (14)"` instead of `"RSI"`).
+
+## Main Tools
+
+| Tool | Description |
+|------|-------------|
+| `screen_market` | Custom market screening with filters |
+| `get_top_gainers` | Top gaining assets |
+| `get_top_losers` | Top losing assets |
+| `get_most_active` | Most traded by volume |
+| `search_symbols` | Search by company name |
+| `get_symbol_info` | Detailed symbol info |
+| `advanced_query` | Complex queries with AND/OR logic |
+
+### Technical Analysis
+
+| Tool | Description |
+|------|-------------|
+| `get_technical_analysis` | Full technical analysis |
+| `scan_rsi_extremes` | RSI overbought/oversold |
+| `scan_macd_crossover` | MACD crossover detection |
+| `scan_bollinger_bands` | Bollinger Band squeeze |
+| `scan_volume_breakout` | Volume breakout detection |
+
+### Reference Tools
+
+| Tool | Description |
+|------|-------------|
+| `ai_get_reference` | Quick reference for markets/columns/filters |
+| `search_available_fields` | Search for fields by name |
+| `get_field_info` | Get field display name and type |
+| `list_fields_for_market` | List fields for a market |
+| `get_screener_preset` | Get predefined screener presets |
+
+## Reference Resources
+
+These resources provide raw lists of available markets and fields for reference.
+
+| Resource | Description |
+|----------|-------------|
+| `markets://list` | All available markets |
+| `columns://list` | Available columns/fields |
+| `docs://ai-reference` | AI quick reference |
+| `docs://fields` | Field display names |
+
+## Markets
+
+- **Stocks**: america, uk, germany, japan, china, etc. (68 countries)
+- **Crypto**: crypto (pairs), coin (individual coins)
+- **Others**: forex, futures, bonds, cfd, options
+
+## Installation
+
+```bash
+# Using uvx (recommended)
+uvx tradingview-mcp
+
+# Using pip
+pip install tradingview-mcp
+
+# From source
+git clone https://github.com/k73a/tradingview-mcp.git
+cd tradingview-mcp
+uv sync
+```
+
+## Running
+
+```bash
+# Stdio (default)
+tradingview-mcp
+
+# HTTP
+tradingview-mcp streamable-http --host 127.0.0.1 --port 8000
+```
+
+## Development
+
+```bash
+uv sync --all-extras
+uv run pytest tests/ -v
+uv run ruff format .
+uv run ruff check . --fix
+```
+
+## License
+
+MIT License

tradingview_mcp-26.3.0/README.md

@@ -0,0 +1,112 @@
+# TradingView MCP Server
+
+[![PyPI version](https://badge.fury.io/py/tradingview-mcp.svg)](https://badge.fury.io/py/tradingview-mcp)
+[![Python](https://img.shields.io/pypi/pyversions/tradingview-mcp.svg)](https://pypi.org/project/tradingview-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP server for TradingView market screening. Supports stocks, crypto, forex, futures, bonds across 76+ markets.
+
+## Quick Start
+```json
+{
+  "mcpServers": {
+    "tradingview": {
+      "command": "uvx",
+      "args": ["tradingview-mcp"]
+    }
+  }
+}
+```
+
+## Smart Features
+
+- **Auto-Market Detection**: If you search for `EURUSD` or `BTCUSDT`, the server automatically checks Forex and Crypto markets if not found in stocks.
+- **Strict Exchange Support**: Use `EXCHANGE:SYMBOL` format (e.g., `BINANCE:BTCUSDT`, `FX:EURUSD`) to target specific markets.
+- **Smart Filters**: You can use human-readable names in filters (e.g., `"Relative Strength Index (14)"` instead of `"RSI"`).
+
+## Main Tools
+
+| Tool | Description |
+|------|-------------|
+| `screen_market` | Custom market screening with filters |
+| `get_top_gainers` | Top gaining assets |
+| `get_top_losers` | Top losing assets |
+| `get_most_active` | Most traded by volume |
+| `search_symbols` | Search by company name |
+| `get_symbol_info` | Detailed symbol info |
+| `advanced_query` | Complex queries with AND/OR logic |
+
+### Technical Analysis
+
+| Tool | Description |
+|------|-------------|
+| `get_technical_analysis` | Full technical analysis |
+| `scan_rsi_extremes` | RSI overbought/oversold |
+| `scan_macd_crossover` | MACD crossover detection |
+| `scan_bollinger_bands` | Bollinger Band squeeze |
+| `scan_volume_breakout` | Volume breakout detection |
+
+### Reference Tools
+
+| Tool | Description |
+|------|-------------|
+| `ai_get_reference` | Quick reference for markets/columns/filters |
+| `search_available_fields` | Search for fields by name |
+| `get_field_info` | Get field display name and type |
+| `list_fields_for_market` | List fields for a market |
+| `get_screener_preset` | Get predefined screener presets |
+
+## Reference Resources
+
+These resources provide raw lists of available markets and fields for reference.
+
+| Resource | Description |
+|----------|-------------|
+| `markets://list` | All available markets |
+| `columns://list` | Available columns/fields |
+| `docs://ai-reference` | AI quick reference |
+| `docs://fields` | Field display names |
+
+## Markets
+
+- **Stocks**: america, uk, germany, japan, china, etc. (68 countries)
+- **Crypto**: crypto (pairs), coin (individual coins)
+- **Others**: forex, futures, bonds, cfd, options
+
+## Installation
+
+```bash
+# Using uvx (recommended)
+uvx tradingview-mcp
+
+# Using pip
+pip install tradingview-mcp
+
+# From source
+git clone https://github.com/k73a/tradingview-mcp.git
+cd tradingview-mcp
+uv sync
+```
+
+## Running
+
+```bash
+# Stdio (default)
+tradingview-mcp
+
+# HTTP
+tradingview-mcp streamable-http --host 127.0.0.1 --port 8000
+```
+
+## Development
+
+```bash
+uv sync --all-extras
+uv run pytest tests/ -v
+uv run ruff format .
+uv run ruff check . --fix
+```
+
+## License
+
+MIT License

{tradingview_mcp-26.0.0 → tradingview_mcp-26.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tradingview-mcp"
-version = "26.0.0"
+version = "26.3.0"
 description = "A comprehensive MCP server for TradingView market screening with integrated screener functionality"
 readme = "README.md"
 license = { text = "MIT" }

tradingview_mcp-26.3.0/src/tradingview_mcp/constants.py

@@ -0,0 +1,196 @@
+"""
+Constants for TradingView Screener integration.
+
+Contains API URLs, headers, supported markets, and column definitions.
+"""
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+# API Configuration
+URL = "https://scanner.tradingview.com/{market}/scan"
+
+HEADERS = {
+    "authority": "scanner.tradingview.com",
+    "sec-ch-ua": '" Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98"',
+    "accept": "text/plain, */*; q=0.01",
+    "content-type": "application/x-www-form-urlencoded; charset=UTF-8",
+    "sec-ch-ua-mobile": "?0",
+    "user-agent": (
+        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+        "(KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36"
+    ),
+    "sec-ch-ua-platform": '"Windows"',
+    "origin": "https://www.tradingview.com",
+    "sec-fetch-site": "same-site",
+    "sec-fetch-mode": "cors",
+    "sec-fetch-dest": "empty",
+    "referer": "https://www.tradingview.com/",
+    "accept-language": "en-US,en;q=0.9",
+}
+
+DEFAULT_RANGE = [0, 50]
+
+# =============================================================================
+# Load Data from JSON (Dynamic)
+# =============================================================================
+
+_DATA_DIR = Path(__file__).parent / "data"
+
+def _load_markets() -> set[str]:
+    """Load supported markets from JSON."""
+    try:
+        with open(_DATA_DIR / "markets.json", "r", encoding="utf-8") as f:
+            data = json.load(f)
+            return set(data.get("countries", []) + data.get("other", []))
+    except Exception:
+        # Fallback if file not found (dev/test env)
+        return {"america", "crypto", "forex"}
+
+def _load_columns() -> dict[str, str]:
+    """
+    Load column definitions from JSON.
+    Returns: Dict[Display Name, Field Name] (Reverse of JSON)
+    """
+    try:
+        with open(_DATA_DIR / "column_display_names.json", "r", encoding="utf-8") as f:
+            data = json.load(f)
+            fields = data.get("fields", {})
+            # Reverse mapping: Display Name -> Field Name
+            # e.g. "Relative Strength Index (14)" -> "RSI"
+            return {v: k for k, v in fields.items()}
+    except Exception:
+        return {}
+
+# Public Constants
+MARKETS = _load_markets()
+COLUMNS = _load_columns()
+
+# Exchange to Screener Mapping (Expanded)
+EXCHANGE_SCREENER = {
+    # Crypto
+    "all": "crypto",
+    "binance": "crypto",
+    "coinbase": "crypto",
+    "kraken": "crypto",
+    "kucoin": "crypto",
+    "bitfinex": "crypto",
+    "bitstamp": "crypto",
+    "okx": "crypto",
+    "bybit": "crypto",
+    "gateio": "crypto",
+    "huobi": "crypto",
+    "gemini": "crypto",
+    "poloniex": "crypto",
+    "bittrex": "crypto",
+    "bitmex": "crypto",
+    "deribit": "crypto",
+    "mexc": "crypto",
+    "bingx": "crypto",
+    "phemex": "crypto",
+    "bitget": "crypto",
+    # Forex
+    "fx": "forex",
+    "fx_idc": "forex",
+    "oanda": "forex",
+    "forex": "forex",
+    "ice": "forex",  # Often forex/futures
+    "saxo": "forex",
+    "cityindex": "forex",
+    # Futures
+    "cme": "futures",
+    "cbot": "futures",
+    "comex": "futures",
+    "nymex": "futures",
+    "eurex": "futures",
+    # US Stocks
+    "nasdaq": "america",
+    "nyse": "america",
+    "amex": "america",
+    "arca": "america",
+    "otc": "america",
+    # Global Stocks
+    "lse": "uk",  # London
+    "tsx": "canada",  # Toronto
+    "asx": "australia",
+    "sse": "china",  # Shanghai
+    "szse": "china",  # Shenzhen
+    "hkex": "hongkong",
+    "hk": "hongkong",
+    "tse": "japan",  # Tokyo
+    "tyo": "japan",
+    "ebs": "switzerland",  # Swiss SIX
+    "six": "switzerland",
+    "xetra": "germany",
+    "fwb": "germany",
+    "euronext": "france",  # Generic Euronext
+    "nse": "india",
+    "bse": "india",
+    "krx": "korea",
+    "kosdaq": "korea",
+    "b3": "brazil",
+    "moex": "russia",
+    "sgx": "singapore",
+    "twse": "taiwan",
+}
+
+# Allowed Timeframes
+ALLOWED_TIMEFRAMES = {"1m", "5m", "15m", "30m", "1h", "2h", "4h", "1D", "1W", "1M"}
+
+# Timeframe to TradingView Resolution
+TIMEFRAME_MAP = {
+    "1m": "1",
+    "5m": "5",
+    "15m": "15",
+    "30m": "30",
+    "1h": "60",
+    "2h": "120",
+    "4h": "240",
+    "1D": "1D",
+    "1W": "1W",
+    "1M": "1M",
+}
+
+# Default columns for different query types
+# Always include 'description' for full name (e.g., "Apple Inc." instead of just "AAPL")
+DEFAULT_COLUMNS = ["name", "description", "close", "change", "volume", "market_cap_basic"]
+
+PREMARKET_COLUMNS = ["name", "description", "close", "volume", "premarket_change", "premarket_change_abs", "premarket_volume"]
+
+POSTMARKET_COLUMNS = ["name", "description", "close", "volume", "postmarket_change", "postmarket_change_abs", "postmarket_volume"]
+
+CRYPTO_COLUMNS = ["name", "description", "close", "change", "volume", "market_cap_basic", "24h_vol|5"]
+
+TECHNICAL_COLUMNS = [
+    "name",
+    "description",
+    "close",
+    "volume",
+    "change",
+    "RSI",
+    "MACD.macd",
+    "MACD.signal",
+    "BB.upper",
+    "BB.lower",
+    "SMA20",
+    "EMA50",
+    "EMA200",
+    "ADX",
+    "Stoch.K",
+    "Stoch.D",
+]
+
+def get_column_name(name: str) -> str:
+    """Get the API column name from a human-readable name or return as-is."""
+    # Try exact match first
+    if name in COLUMNS:
+        return COLUMNS[name]
+    
+    # Try case-insensitive keys
+    name_lower = name.lower()
+    for k, v in COLUMNS.items():
+        if k.lower() == name_lower:
+            return v
+            
+    return name