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

{tradingview_mcp-26.2.0 → tradingview_mcp-26.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tradingview-mcp
-Version: 26.2.0
+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
@@ -43,7 +43,6 @@ Description-Content-Type: text/markdown
 MCP server for TradingView market screening. Supports stocks, crypto, forex, futures, bonds across 76+ markets.
 
 ## Quick Start
-
 ```json
 {
   "mcpServers": {
@@ -55,6 +54,12 @@ MCP server for TradingView market screening. Supports stocks, crypto, forex, fut
 }
 ```
 
+## 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 |
@@ -87,7 +92,9 @@ MCP server for TradingView market screening. Supports stocks, crypto, forex, fut
 | `list_fields_for_market` | List fields for a market |
 | `get_screener_preset` | Get predefined screener presets |
 
-## Resources
+## Reference Resources
+
+These resources provide raw lists of available markets and fields for reference.
 
 | Resource | Description |
 |----------|-------------|

{tradingview_mcp-26.2.0 → tradingview_mcp-26.3.0}/README.md

@@ -7,7 +7,6 @@
 MCP server for TradingView market screening. Supports stocks, crypto, forex, futures, bonds across 76+ markets.
 
 ## Quick Start
-
 ```json
 {
   "mcpServers": {
@@ -19,6 +18,12 @@ MCP server for TradingView market screening. Supports stocks, crypto, forex, fut
 }
 ```
 
+## 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 |
@@ -51,7 +56,9 @@ MCP server for TradingView market screening. Supports stocks, crypto, forex, fut
 | `list_fields_for_market` | List fields for a market |
 | `get_screener_preset` | Get predefined screener presets |
 
-## Resources
+## Reference Resources
+
+These resources provide raw lists of available markets and fields for reference.
 
 | Resource | Description |
 |----------|-------------|

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

@@ -1,6 +1,6 @@
 [project]
 name = "tradingview-mcp"
-version = "26.2.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

{tradingview_mcp-26.2.0 → tradingview_mcp-26.3.0}/src/tradingview_mcp/docs_data.py

@@ -165,6 +165,47 @@ def get_fields_by_market(market: str | None = None) -> dict[str, Any]:
     return data
 
 
+def get_default_columns_for_market(market: str) -> list[str]:
+    """Get smart default columns for a market to avoid 400 errors."""
+    # Base columns safe for all
+    cols = ["name", "description", "close", "change", "change_abs", "exchange", "type"]
+    
+    # Check if market has specific fields in data
+    fields = get_fields_by_market(market)
+    if not fields:
+        # Fallback defaults if market data missing
+        if market == "crypto":
+            return cols + ["volume", "market_cap_basic", "24h_vol|5"]
+        if market == "forex":
+            return cols + ["bid", "ask"]
+        return cols + ["volume", "market_cap_basic", "price_earnings_ttm", "sector", "industry"]
+
+    # Extract available field names
+    valid_names = {f.get("name") for f in fields if f.get("name")}
+    
+    # Add common extra columns if they exist in this market
+    extras = [
+        "open", "high", "low", "volume", "market_cap_basic", 
+        "24h_vol|5", "bid", "ask", "price_earnings_ttm", 
+        "earnings_per_share_basic_ttm", "dividend_yield_recent", 
+        "sector", "industry"
+    ]
+    
+    for extra in extras:
+        if extra in valid_names:
+            cols.append(extra)
+            
+    # Deduplicate while preserving order
+    seen = set()
+    unique_cols = []
+    for c in cols:
+        if c not in seen:
+            seen.add(c)
+            unique_cols.append(c)
+            
+    return unique_cols
+
+
 def paginate_data(
     data: list | dict,
     offset: int = 0,

tradingview_mcp-26.3.0/src/tradingview_mcp/resources.py

@@ -0,0 +1,63 @@
+from __future__ import annotations
+from typing import Any
+
+from tradingview_mcp.docs_data import (
+    get_markets_data,
+    get_column_display_names,
+    get_screener_presets,
+    get_screener_markets,
+    get_stock_screeners,
+    get_stock_screeners_failed,
+    get_fields_by_market,
+    get_ai_quick_reference,
+    get_screener_code_examples,
+)
+from tradingview_mcp.constants import EXCHANGE_SCREENER
+
+def list_markets() -> dict[str, Any]:
+    """List all available markets."""
+    return get_markets_data()
+
+def list_columns() -> dict[str, str]:
+    """List all available columns."""
+    return get_column_display_names()
+
+def list_crypto_exchanges() -> list[str]:
+    """List all crypto exchanges."""
+    return [k for k, v in EXCHANGE_SCREENER.items() if v == "crypto"]
+
+def list_scanner_presets() -> list[dict[str, Any]]:
+    """List scanner presets."""
+    return get_screener_presets()
+
+def docs_params() -> dict[str, Any]:
+    """Documentation for parameters."""
+    return {"limit": "Max 500", "range": "[0, 100]"}
+
+def docs_screeners() -> list[str]:
+    """Documentation for screeners."""
+    return get_screener_markets()
+
+def docs_stock_screeners() -> list[dict[str, Any]]:
+    """Documentation for stock screeners."""
+    return get_stock_screeners()
+
+def docs_stock_screeners_failed() -> list[dict[str, Any]]:
+    """Documentation for failed stock screeners."""
+    return get_stock_screeners_failed()
+
+def docs_fields() -> dict[str, Any]:
+    """Documentation for fields."""
+    return get_fields_by_market("stocks") # Default to stocks
+
+def docs_markets() -> dict[str, Any]:
+    """Documentation for markets."""
+    return get_markets_data()
+
+def docs_ai_reference() -> dict[str, Any]:
+    """Documentation for AI reference."""
+    return get_ai_quick_reference()
+
+def docs_code_examples() -> dict[str, Any]:
+    """Documentation for code examples."""
+    return get_screener_code_examples()

tradingview_mcp-26.3.0/src/tradingview_mcp/server.py

@@ -0,0 +1,249 @@
+"""
+TradingView MCP Server - Main server implementation.
+
+Provides comprehensive MCP tools and resources for TradingView market screening.
+"""
+
+from __future__ import annotations
+
+import inspect
+import json
+import os
+import traceback
+from datetime import datetime
+from functools import wraps
+from typing import Any
+
+from mcp.server.fastmcp import FastMCP
+
+from tradingview_mcp.docs_data import suggest_fields_for_error
+from tradingview_mcp.tools.search import search_symbols, get_symbol_info
+from tradingview_mcp.tools.screener import (
+    screen_market, 
+    get_top_gainers, 
+    get_top_losers, 
+    get_most_active
+)
+from tradingview_mcp.tools.technical import (
+    get_technical_analysis,
+    scan_rsi_extremes,
+    scan_bollinger_bands,
+    scan_macd_crossover
+)
+from tradingview_mcp.tools.reference import (
+    ai_get_reference,
+    search_available_fields,
+    get_code_example,
+    list_fields_for_market,
+    get_common_fields_summary,
+    lookup_single_field,
+    get_filter_example,
+    check_market,
+    get_help,
+    get_field_info,
+    get_screener_preset,
+    get_market_metainfo,
+)
+from tradingview_mcp.resources import (
+    list_markets,
+    list_columns,
+    list_crypto_exchanges,
+    list_scanner_presets,
+    docs_params,
+    docs_screeners,
+    docs_stock_screeners,
+    docs_stock_screeners_failed,
+    docs_fields,
+    docs_markets,
+    docs_ai_reference,
+    docs_code_examples,
+)
+
+# Initialize MCP Server
+mcp = FastMCP(
+    name="TradingView Screener MCP",
+    instructions="""TradingView Market Screener MCP
+
+Quick start:
+1. Call `get_help()` for usage
+2. Call `ai_get_reference()` for markets and fields
+
+Common tools:
+- `screen_market(market, limit)`
+- `get_top_gainers(market, limit)`
+- `get_top_losers(market, limit)`
+- `search_symbols(query, market)`
+- `get_symbol_info(symbol)`
+
+Notes:
+- `limit` default 25, max 500
+- Results include `description`
+
+Resources:
+- docs://ai-reference
+- markets://list
+- columns://list
+""",
+)
+
+DEBUG_MODE = os.getenv("TRADINGVIEW_MCP_DEBUG", "0").lower() in {"1", "true", "yes"}
+
+
+def _safe_json(value: Any) -> Any:
+    try:
+        return json.loads(json.dumps(value, default=str))
+    except Exception:
+        return str(value)
+
+
+def _debug_hint(exc: Exception, context: dict[str, Any] | None = None) -> dict[str, Any] | str | None:
+    """Generate helpful hints based on error type."""
+    message = str(exc).lower()
+    
+    # Extract market from context if available
+    market = None
+    if context:
+        market = context.get("kwargs", {}).get("market") or context.get("market")
+    
+    if "market" in message and "invalid" in message:
+        return "Check the market name using the markets://list or docs://screeners resources."
+    
+    if "column" in message or "unknown" in message or "field" in message:
+        # Return structured field suggestions
+        market_type = market or "stocks"
+        if market_type in ["crypto", "coin"]:
+            market_type = market_type
+        elif market_type in ["forex"]:
+            market_type = "forex"
+        else:
+            # Default to stocks for field suggestions
+            market_type = "stocks"
+        
+        return suggest_fields_for_error(str(exc), market_type)
+    
+    if "http" in message or "status" in message:
+        return "TradingView API may be rate-limiting or blocked. Retry with fewer requests."
+    
+    return None
+
+
+def _build_error_response(tool_name: str, exc: Exception, context: dict[str, Any]) -> dict[str, Any]:
+    payload: dict[str, Any] = {
+        "ok": False,
+        "tool": tool_name,
+        "error": {"type": exc.__class__.__name__, "message": str(exc)},
+        "context": _safe_json(context),
+        "timestamp": datetime.utcnow().isoformat() + "Z",
+    }
+    
+    hint = _debug_hint(exc, context)
+    if hint:
+        if isinstance(hint, dict):
+            payload["field_suggestions"] = hint
+        else:
+            payload["hint"] = hint
+    
+    if DEBUG_MODE:
+        payload["trace"] = traceback.format_exc()
+    return payload
+
+
+def debug_tool(fn):
+    """Decorator to return structured debug responses on failure."""
+
+    @wraps(fn)
+    def wrapper(*args, **kwargs):
+        try:
+            result = fn(*args, **kwargs)
+            if isinstance(result, dict) and "error" in result:
+                return _build_error_response(
+                    fn.__name__,
+                    Exception(str(result.get("error"))),
+                    {"args": args, "kwargs": kwargs, "note": "error returned by tool"},
+                )
+            if (
+                isinstance(result, list)
+                and len(result) == 1
+                and isinstance(result[0], dict)
+                and "error" in result[0]
+            ):
+                return _build_error_response(
+                    fn.__name__,
+                    Exception(str(result[0].get("error"))),
+                    {"args": args, "kwargs": kwargs, "note": "error returned by tool"},
+                )
+            return result
+        except Exception as exc: 
+            context = {"args": args, "kwargs": kwargs}
+            return _build_error_response(fn.__name__, exc, context)
+
+    return wrapper
+
+
+_original_mcp_tool = mcp.tool
+
+
+def _debug_mcp_tool(*args, **kwargs):
+    """Wrap FastMCP tool registration with debug handling."""
+
+    def decorator(fn):
+        return _original_mcp_tool(*args, **kwargs)(debug_tool(fn))
+
+    return decorator
+
+
+mcp.tool = _debug_mcp_tool
+
+
+# =============================================================================
+# Register Tools
+# =============================================================================
+
+mcp.tool()(search_symbols)
+mcp.tool()(get_symbol_info)
+mcp.tool()(screen_market)
+mcp.tool()(get_top_gainers)
+mcp.tool()(get_top_losers)
+mcp.tool()(get_most_active)
+
+mcp.tool()(get_technical_analysis)
+mcp.tool()(scan_rsi_extremes)
+mcp.tool()(scan_bollinger_bands)
+mcp.tool()(scan_macd_crossover)
+
+mcp.tool()(ai_get_reference)
+mcp.tool()(search_available_fields)
+mcp.tool()(get_code_example)
+mcp.tool()(list_fields_for_market)
+mcp.tool()(get_common_fields_summary)
+mcp.tool()(lookup_single_field)
+mcp.tool()(get_field_info)
+mcp.tool()(get_filter_example)
+mcp.tool()(check_market)
+mcp.tool()(get_help)
+mcp.tool()(get_screener_preset)
+mcp.tool()(get_market_metainfo)
+
+# =============================================================================
+# Register Resources
+# =============================================================================
+
+mcp.resource("markets://list")(list_markets)
+mcp.resource("columns://list")(list_columns)
+mcp.resource("exchanges://crypto")(list_crypto_exchanges)
+mcp.resource("scanners://presets")(list_scanner_presets)
+mcp.resource("docs://params")(docs_params)
+mcp.resource("docs://screeners")(docs_screeners)
+mcp.resource("docs://stock-screeners")(docs_stock_screeners)
+mcp.resource("docs://stock-screeners-failed")(docs_stock_screeners_failed)
+mcp.resource("docs://fields")(docs_fields)
+mcp.resource("docs://markets")(docs_markets)
+mcp.resource("docs://ai-reference")(docs_ai_reference)
+mcp.resource("docs://code-examples")(docs_code_examples)
+
+
+def main():
+    mcp.run()
+
+if __name__ == "__main__":
+    main()