tradingview-mcp 26.0.0__py3-none-any.whl → 26.2.0__py3-none-any.whl

tradingview_mcp-26.2.0.dist-info/METADATA

@@ -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.0.0.dist-info → tradingview_mcp-26.2.0.dist-info}/RECORD

@@ -1,20 +1,21 @@
 tradingview_mcp/__init__.py,sha256=V7RLq22Qp1rsMhDYNlXfWkiNaXlo7s4KkNUmSvbGKIM,455
 tradingview_mcp/column.py,sha256=MC7lWksmyaYF4SkVm97Apr8httwip-N-4aVTSyS0CQo,8871
 tradingview_mcp/constants.py,sha256=kQUhcG0U1cVLiN6LGgzWPjCGhXh_-jvB5lF15QIX1_4,12927
-tradingview_mcp/docs_data.py,sha256=3ArdbV8RE3SpNhvkkTHA0RXgrUbQoJqkZh05VVqlLLA,9001
+tradingview_mcp/docs_data.py,sha256=4mhaO-far90SSXzSl1fLZIzNBe0lOTxFeX7ITzYTBpo,17698
 tradingview_mcp/models.py,sha256=CHSQ46A2ljhvzI6YP8XRItUdoDJw1yYebiBANt9xeD0,3366
 tradingview_mcp/query.py,sha256=gkC4t-2_jtuUK3KgzU62wrIcGoaOmY--1EwAshGQb0Q,10871
 tradingview_mcp/scanner.py,sha256=oEfMzaYhQ7ggBdLlPLqKZCMxHkd6MBMaUMcm3p-YvPA,7649
-tradingview_mcp/server.py,sha256=3VosVvI3SQbqDxaahmgYj_aBUyn-0qGxfJf3n2p6OCk,67679
+tradingview_mcp/server.py,sha256=WdBov_EoJGA_BNurf1PJ6m6_ZayztjqqniItOvudkPY,51698
 tradingview_mcp/utils.py,sha256=6O89qIaZ_eYoN3m12r2q4-D8VpJajP5WuwKQbj4ZVHo,10238
 tradingview_mcp/data/__init__.py,sha256=3kot_ZG4a6jbZgyksE9z56n3skI407lsd4y2ThHotKY,298
 tradingview_mcp/data/column_display_names.json,sha256=AFdo6Q2n-wSXWHi2wEExOd2pTItyjocRbrnxqYpCa94,30137
 tradingview_mcp/data/markets.json,sha256=CehqCeVdQhWeCkMX1HWOrgCRjOomWa3VH1v2ZvPnIck,1482
 tradingview_mcp/data/extracted/__init__.py,sha256=zSVRJTO5MxBq_zfkbzUBwuz8NG3rWlYfLvpZkVDI6Ro,64
-tradingview_mcp/data/extracted/ai_quick_reference.json,sha256=h9DY1t3f5UCiv9N65Fs9kL8Y6w5qAP-BTxUgktj4KyI,3381
-tradingview_mcp/data/extracted/common_fields.json,sha256=qqaGYPH54eFJoA2NFJlQX3Ixk4qPNxAy_6--tKp3fPE,77914
-tradingview_mcp/data/extracted/fields_by_market.json,sha256=i2esozdi8HuOcbD4FF5J-X6AfHeJTLwVtSa9JNHSLjM,448166
+tradingview_mcp/data/extracted/ai_quick_reference.json,sha256=Y4TxDvG_VS7bNN1TszsmsPBAnUqx_--kK_qaV5M7g4A,3285
+tradingview_mcp/data/extracted/common_fields.json,sha256=iULTVEsA3F54BefCWeHOW-fQspdUa-re9WWHzAmUMas,156364
+tradingview_mcp/data/extracted/fields_by_market.json,sha256=nrNPtyOQcc5lVHoedlNxbBDUw79bDRmDxXhXrA4Aejg,950182
 tradingview_mcp/data/extracted/screener_code_examples.json,sha256=VCxgbMnsfV1mzDI6AvvfSzoIbieNtXHwltwMNs5KBwY,5157
+tradingview_mcp/data/extracted/stock_screener_presets.json,sha256=20oTJZeWrQXEcp04HpZ_HuePxwwsqoazBfHy8K6LSWo,1802242
 tradingview_mcp/data/metainfo/bond.json,sha256=aJzqdPFciAH4pM5nsezHUEolcDtdHCktSQsxhTqJ898,557027
 tradingview_mcp/data/metainfo/bonds.json,sha256=QoqDg7SwD1mv6aw7haG4cmNnq-agyGzK1ECvdK1fsDs,22377
 tradingview_mcp/data/metainfo/cfd.json,sha256=eWB-wqKNijyvwACcp6sHJZ4VCbP8NZpg_Ui9kums2lQ,390943
@@ -30,8 +31,8 @@ tradingview_mcp/data/screeners/main_screeners.json,sha256=kU_xGJ7ePoGN3s8g9PwGrc
 tradingview_mcp/data/screeners/markets.json,sha256=vpdrAKg4E_lgg4FxeX2GHNbnSsKQDmgfnyr2ziSdQsk,1004
 tradingview_mcp/data/screeners/stocks.json,sha256=gCnntHTJKJ7n7IqY72fZ4EuBfthtnWUpfHvPqNOvnXo,8843
 tradingview_mcp/data/screeners/stocks_failed.json,sha256=RqBp9XCZ3xvdWZMwuVGysEE2Er_XOQvBZoUHo9uyj6k,1084574
-tradingview_mcp-26.0.0.dist-info/METADATA,sha256=5MvoUOTOvcq2aTdIMX8v-BOMfHm-wqAuVMcHhjPNP9w,10178
-tradingview_mcp-26.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-tradingview_mcp-26.0.0.dist-info/entry_points.txt,sha256=GZxjGqgVbUlWDp5OzFQoCN_g1UBLyOmfVqCR5uzscnU,57
-tradingview_mcp-26.0.0.dist-info/licenses/LICENSE,sha256=1Hdpp7qGWCXVw1BP6vpdAPO4KrgO0T_c0N3ipkYHKAo,1070
-tradingview_mcp-26.0.0.dist-info/RECORD,,
+tradingview_mcp-26.2.0.dist-info/METADATA,sha256=ayxnek_OIGlG_IpQZTsE_jmR7J0LljnN1STnzVQxC3o,4303
+tradingview_mcp-26.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+tradingview_mcp-26.2.0.dist-info/entry_points.txt,sha256=GZxjGqgVbUlWDp5OzFQoCN_g1UBLyOmfVqCR5uzscnU,57
+tradingview_mcp-26.2.0.dist-info/licenses/LICENSE,sha256=1Hdpp7qGWCXVw1BP6vpdAPO4KrgO0T_c0N3ipkYHKAo,1070
+tradingview_mcp-26.2.0.dist-info/RECORD,,

tradingview_mcp-26.0.0.dist-info/METADATA

@@ -1,333 +0,0 @@
-Metadata-Version: 2.4
-Name: tradingview-mcp
-Version: 26.0.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)
-
-A comprehensive Model Context Protocol (MCP) server for TradingView market screening with fully integrated screener functionality. This server provides powerful tools for cryptocurrency and stock market analysis directly through the MCP interface.
-
-## Quick Start (No Installation Required)
-
-Use `uvx` to run directly without installing:
-
-```json
-{
-  "mcpServers": {
-    "tradingview": {
-      "command": "uvx",
-      "args": ["tradingview-mcp"]
-    }
-  }
-}
-```
-
-## 🤖 For AI Agents
-
-**📖 Read [AI.md](AI.md) for the complete guide!** You can copy the entire AI.md file to understand all capabilities.
-
-**Quick Start:**
-1. Call `get_help()` to understand how to use this MCP
-2. Call `ai_get_reference()` for markets, columns, and filter references
-
-Key points:
-- All results include `description` field with full names (e.g., "Apple Inc." not just "AAPL")
-- Use `limit` parameter to control result count (default: 25)
-- Use `search_symbols("apple", "america")` to search by company name
-
-```
-# Quick examples:
-get_top_gainers("america", 10)       # Top 10 US stock gainers
-search_symbols("tesla", "america")    # Search for Tesla
-get_symbol_info("NASDAQ:AAPL")       # Apple Inc. details
-```
-
-## Features
-
-### Core Screener Functionality
-- **Direct TradingView API Integration**: Query the TradingView scanner API without external dependencies
-- **Multi-Market Support**: 76+ markets including crypto, stocks, forex, futures, and bonds
-- **SQL-like Query Interface**: Build complex queries with filtering, sorting, and pagination
-- **250+ Technical Indicators**: Access a comprehensive set of technical analysis columns
-- **AI-Friendly Design**: Includes `description` (full name), token-saving limits, and help tools
-
-### MCP Tools
-
-#### 🔍 Discovery & Help Tools (AI Start Here!)
-- `get_help(topic)`: **📖 Required reading!** Get usage guide and examples
-- `search_symbols(query, market)`: 🔍 Search by company name (e.g., "Apple", "Tesla")
-- `get_symbol_info(symbol)`: Get detailed symbol information
-- `ai_get_reference()`: AI quick reference guide
-
-#### Screening Tools
-- `screen_market`: Execute custom market screening queries
-- `get_top_gainers`: Find top gaining assets (includes full company names)
-- `get_top_losers`: Find top losing assets (includes full company names)
-- `get_most_active`: Most traded by volume
-- `get_premarket_movers`: Pre-market gainers, losers, and most active
-- `get_postmarket_movers`: Post-market activity analysis
-- `get_technical_analysis`: Detailed technical analysis for specific symbols
-- `scan_bollinger_bands`: Bollinger Band squeeze detection
-- `scan_volume_breakout`: Volume breakout detection
-- `scan_rsi_extremes`: RSI overbought/oversold scanner
-- `scan_macd_crossover`: MACD crossover detection
-- `get_all_symbols`: Retrieve all symbols for a market
-- `advanced_query`: Execute advanced queries with AND/OR logic
-
-#### AI-Friendly Reference Tools
-- `search_available_fields`: Search for fields/columns by name or description
-- `get_field_info`: Get display name and type for a specific field
-- `get_code_example`: Get Python code examples for screener types
-- `list_fields_for_market`: List available fields with pagination
-- `get_common_fields_summary`: Get commonly used fields by category
-- `get_screener_preset`: Retrieve predefined screener presets
-- `get_market_metainfo`: Field definitions and allowed values per market
-
-### MCP Resources
-- `markets://list`: List all available markets
-- `columns://list`: List all available technical indicator columns
-- `exchanges://crypto`: List cryptocurrency exchanges
-- `presets://list`: List predefined screening presets
-- `docs://params`: Screener params format and schema
-- `docs://screeners`: Predefined screener presets overview
-- `docs://fields`: Field display names (paginated)
-- `docs://markets`: Markets metadata
-- `docs://ai-reference`: AI quick reference guide
-- `docs://code-examples`: Python code examples for screeners
-
-## Installation
-
-### Using uvx (Recommended - No Install)
-```json
-{
-  "mcpServers": {
-    "tradingview": {
-      "command": "uvx",
-      "args": ["tradingview-mcp"]
-    }
-  }
-}
-```
-
-### Using uv
-```bash
-uv add tradingview-mcp
-```
-
-### Using pip
-```bash
-pip install tradingview-mcp
-```
-
-### From Source
-```bash
-git clone https://github.com/k73a/tradingview-mcp.git
-cd tradingview-mcp
-uv sync
-```
-
-## Usage
-
-### Running the MCP Server
-
-#### Stdio Transport (Default)
-```bash
-tradingview-mcp
-```
-
-#### HTTP Transport
-```bash
-tradingview-mcp streamable-http --host 127.0.0.1 --port 8000
-```
-
-### MCP Client Configuration
-
-#### Using uvx (Recommended)
-```json
-{
-  "mcpServers": {
-    "tradingview": {
-      "command": "uvx",
-      "args": ["tradingview-mcp"]
-    }
-  }
-}
-```
-
-#### Using installed package
-```json
-{
-  "mcpServers": {
-    "tradingview": {
-      "command": "tradingview-mcp",
-      "args": []
-    }
-  }
-}
-```
-
-### For AI Agents: Getting Started
-
-1. **First, call `ai_get_reference()`** to understand available markets, columns, and filters
-2. Use `search_available_fields("your query")` to find specific columns
-3. Use `get_code_example("Stocks (legacy)")` to see query patterns
-4. Build queries using `screen_market()` or `advanced_query()`
-
-### Example Queries
-
-#### Basic Market Screening
-```python
-# Get top 50 stocks by trading volume
-await client.call_tool("screen_market", {
-    "market": "america",
-    "columns": ["name", "close", "volume", "change"],
-    "sort_by": "volume",
-    "ascending": False,
-    "limit": 50
-})
-```
-
-#### Technical Analysis Screening
-```python
-# Find stocks with RSI below 30 (oversold)
-await client.call_tool("scan_rsi_extremes", {
-    "market": "america",
-    "condition": "oversold",
-    "threshold": 30,
-    "limit": 20
-})
-```
-
-#### Cryptocurrency Screening
-```python
-# Get top crypto gainers
-await client.call_tool("get_top_gainers", {
-    "market": "crypto",
-    "limit": 25
-})
-```
-
-## API Reference
-
-### Markets
-The following markets are supported:
-- **Crypto**: `crypto`, `coin`
-- **Traditional Finance**: `america`, `uk`, `germany`, `japan`, etc. (67 countries)
-- **Other**: `forex`, `futures`, `bonds`, `cfd`, `options`
-
-### Technical Indicators
-Common indicators include:
-- Price: `open`, `high`, `low`, `close`, `volume`
-- Moving Averages: `SMA5`, `SMA10`, `SMA20`, `SMA50`, `SMA100`, `SMA200`, `EMA5`, `EMA10`, `EMA20`, `EMA50`, `EMA100`, `EMA200`
-- Oscillators: `RSI`, `RSI7`, `MACD.macd`, `MACD.signal`, `Stoch.K`, `Stoch.D`
-- Bollinger Bands: `BB.upper`, `BB.lower`
-- Others: `VWAP`, `ATR`, `ADX`, `CCI20`, etc.
-
-See `columns://list` resource for the complete list.
-
-## Development
-
-### Setup Development Environment
-```bash
-git clone https://github.com/k73a/tradingview-mcp.git
-cd tradingview-mcp
-uv sync --all-extras
-```
-
-### Running Tests
-```bash
-uv run pytest tests/ -v
-```
-
-### Code Formatting
-```bash
-uv run ruff format .
-uv run ruff check . --fix
-```
-
-### Type Checking
-```bash
-uv run pyright
-```
-
-### Debug Mode
-
-Enable structured debug responses from tools by setting:
-
-```bash
-export TRADINGVIEW_MCP_DEBUG=1
-```
-
-### Docs Data Path (Optional)
-
-If you want the full TradingView Screener docs datasets (e.g., large metainfo files),
-point the loader to your docs data directory:
-
-```bash
-export TRADINGVIEW_SCREENER_DOCS_DATA=/path/to/TradingView-Screener-docs/data
-```
-
-## Publishing & Releases
-
-This project uses GitHub Actions for automated publishing to PyPI:
-
-### Automatic Updates
-- **Weekly auto-update**: Every Monday, the workflow checks for dependency updates, runs tests, and publishes a new version if there are changes
-- **Manual trigger**: You can manually trigger updates from the GitHub Actions tab
-
-### Manual Release
-To create a manual release:
-
-1. Update version in `pyproject.toml`
-2. Commit and create a tag:
-   ```bash
-   git commit -am "Bump version to x.y.z"
-   git tag vx.y.z
-   git push origin main --tags
-   ```
-3. GitHub Actions will automatically build and publish to PyPI
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed release instructions.
-
-## Contributing
-
-Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
-## License
-
-MIT License - see [LICENSE](LICENSE) for details.