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

{tradingview_mcp-26.0.0 → tradingview_mcp-26.2.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.2.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: tradingview-mcp
+Version: 26.2.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"]
+    }
+  }
+}
+```
+
+## 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 |
+
+## Resources
+
+| 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.2.0/README.md

@@ -0,0 +1,105 @@
+# 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"]
+    }
+  }
+}
+```
+
+## 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 |
+
+## Resources
+
+| 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.2.0}/pyproject.toml

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

{tradingview_mcp-26.0.0 → tradingview_mcp-26.2.0}/src/tradingview_mcp/data/extracted/ai_quick_reference.json

@@ -2,73 +2,73 @@
   "markets": {
     "stocks": [
       "america",
-      "uk",
-      "germany",
-      "japan",
-      "china",
-      "india",
-      "brazil",
-      "canada",
+      "argentina",
       "australia",
-      "korea",
-      "taiwan",
-      "hongkong",
-      "singapore",
-      "france",
-      "italy",
-      "spain",
-      "netherlands",
-      "switzerland",
-      "sweden",
-      "norway",
-      "denmark",
-      "finland",
       "austria",
+      "bahrain",
+      "bangladesh",
       "belgium",
-      "portugal",
-      "poland",
-      "russia",
-      "turkey",
-      "israel",
-      "mexico",
-      "argentina",
+      "brazil",
+      "canada",
       "chile",
+      "china",
       "colombia",
-      "peru",
-      "venezuela",
-      "indonesia",
-      "malaysia",
-      "thailand",
-      "philippines",
-      "vietnam",
-      "pakistan",
-      "bangladesh",
-      "srilanka",
-      "newzealand",
-      "egypt",
-      "rsa",
-      "nigeria",
-      "kenya",
-      "morocco",
-      "tunisia",
-      "bahrain",
-      "kuwait",
-      "qatar",
-      "uae",
-      "ksa",
       "cyprus",
       "czech",
+      "denmark",
+      "egypt",
       "estonia",
+      "finland",
+      "france",
+      "germany",
       "greece",
+      "hongkong",
       "hungary",
       "iceland",
+      "india",
+      "indonesia",
       "ireland",
+      "israel",
+      "italy",
+      "japan",
+      "kenya",
+      "korea",
+      "ksa",
+      "kuwait",
       "latvia",
       "lithuania",
       "luxembourg",
+      "malaysia",
+      "mexico",
+      "morocco",
+      "netherlands",
+      "newzealand",
+      "nigeria",
+      "norway",
+      "pakistan",
+      "peru",
+      "philippines",
+      "poland",
+      "portugal",
+      "qatar",
       "romania",
+      "rsa",
+      "russia",
       "serbia",
-      "slovakia"
+      "singapore",
+      "slovakia",
+      "spain",
+      "srilanka",
+      "sweden",
+      "switzerland",
+      "taiwan",
+      "thailand",
+      "tunisia",
+      "turkey",
+      "uae",
+      "uk",
+      "venezuela",
+      "vietnam"
     ],
     "crypto": [
       "crypto"
@@ -99,114 +99,113 @@
   "common_columns": {
     "price": [
       "close",
-      "open",
-      "high",
-      "low",
       "change",
       "change_abs",
-      "gap"
+      "high",
+      "low",
+      "open"
     ],
     "volume": [
       "volume",
       "Value.Traded",
-      "relative_volume_10d_calc",
-      "average_volume_10d_calc"
+      "relative_volume_10d_calc"
     ],
     "market_cap": [
-      "market_cap_basic"
+      "market_cap_basic",
+      "market_cap_calc"
     ],
-    "fundamentals": [
+    "fundamental": [
       "price_earnings_ttm",
       "earnings_per_share_basic_ttm",
-      "dividend_yield_recent",
-      "price_book_fq"
+      "dividends_yield_current",
+      "total_revenue_fy",
+      "net_income_fy"
     ],
     "technical": [
+      "Recommend.All",
       "RSI",
       "MACD.macd",
-      "MACD.signal",
       "BB.upper",
       "BB.lower",
-      "SMA20",
       "SMA50",
       "SMA200",
-      "EMA20",
       "EMA50",
       "EMA200"
     ],
-    "ratings": [
-      "Recommend.All",
-      "Recommend.MA",
-      "Recommend.Other"
-    ],
-    "info": [
+    "metadata": [
       "name",
       "description",
       "sector",
-      "industry",
       "exchange",
       "type",
-      "subtype"
+      "currency"
+    ]
+  },
+  "filter_operations": {
+    "comparison": [
+      "greater",
+      "less",
+      "equal",
+      "not_equal",
+      "greater_or_equal",
+      "less_or_equal"
+    ],
+    "range": [
+      "in_range",
+      "not_in_range"
+    ],
+    "list": [
+      "in_list",
+      "not_in_list"
+    ],
+    "text": [
+      "match",
+      "not_match",
+      "has",
+      "has_none_of"
+    ],
+    "null": [
+      "empty",
+      "not_empty"
+    ]
+  },
+  "field_type_operations": {
+    "number": [
+      "greater",
+      "less",
+      "equal",
+      "in_range",
+      "empty"
+    ],
+    "percent": [
+      "greater",
+      "less",
+      "equal",
+      "in_range"
+    ],
+    "price": [
+      "greater",
+      "less",
+      "equal",
+      "in_range"
+    ],
+    "text": [
+      "equal",
+      "match",
+      "in_list",
+      "has"
+    ],
+    "bool": [
+      "equal"
     ]
   },
-  "filter_operations": [
-    "equal",
-    "ne",
-    "gt",
-    "gte",
-    "lt",
-    "lte",
-    "in_range",
-    "has",
-    "has_none_of",
-    "isin",
-    "not_isin",
-    "match",
-    "crosses",
-    "crosses_above",
-    "crosses_below"
-  ],
-  "sort_order": [
-    "asc",
-    "desc"
-  ],
-  "timeframes": [
-    "",
-    "1",
-    "5",
-    "15",
-    "30",
-    "60",
-    "120",
-    "240",
-    "1W",
-    "1M"
-  ],
-  "common_filters": {
-    "stocks_only": {
-      "left": "type",
-      "operation": "equal",
-      "right": "stock"
-    },
-    "primary_listing": {
-      "left": "is_primary",
-      "operation": "equal",
-      "right": true
-    },
-    "active_trading": {
-      "left": "active_symbol",
-      "operation": "equal",
-      "right": true
-    },
-    "min_volume": {
-      "left": "volume",
-      "operation": "gt",
-      "right": 100000
-    },
-    "min_market_cap": {
-      "left": "market_cap_basic",
-      "operation": "gt",
-      "right": 1000000000
-    }
-  }
+  "screener_examples": [
+    "Stocks (legacy)",
+    "Stocks (v2)",
+    "Forex",
+    "Crypto",
+    "Crypto Coins",
+    "ETFs",
+    "Bonds"
+  ]
 }