tradingview-mcp 1.0.0__tar.gz

tradingview_mcp-1.0.0/.gitignore

@@ -0,0 +1,41 @@
+# Reference files
+referance/
+
+# Environment
+.env
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Unit test / coverage reports
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv
+venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# UV
+uv.lock

tradingview_mcp-1.0.0/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2022 Shneor Elmaleh
+Copyright (c) 2025 Ahmet Taner Atila
+Copyright (c) 2026 Henrik (k73a)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tradingview_mcp-1.0.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: tradingview-mcp
+Version: 1.0.0
+Summary: A comprehensive MCP server for TradingView market screening with integrated screener functionality
+Author: TradingView MCP Team
+License: MIT
+License-File: LICENSE
+Keywords: crypto,mcp,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
+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>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# TradingView MCP Server
+
+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.
+
+## 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
+
+### MCP Tools
+- `screen_market`: Execute custom market screening queries
+- `get_top_gainers`: Find top gaining assets in any market
+- `get_top_losers`: Find top losing assets in any market
+- `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
+
+### 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
+
+## Installation
+
+### Using uv (Recommended)
+```bash
+uv add tradingview-mcp
+```
+
+### Using pip
+```bash
+pip install tradingview-mcp
+```
+
+### From Source
+```bash
+git clone https://github.com/your-repo/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
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "tradingview": {
+      "command": "tradingview-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+### 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
+
+### Running Tests
+```bash
+uv run pytest tests/
+```
+
+### Code Formatting
+```bash
+uv run ruff format .
+uv run ruff check . --fix
+```
+
+### Type Checking
+```bash
+uv run pyright
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

tradingview_mcp-1.0.0/README.md

@@ -0,0 +1,153 @@
+# TradingView MCP Server
+
+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.
+
+## 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
+
+### MCP Tools
+- `screen_market`: Execute custom market screening queries
+- `get_top_gainers`: Find top gaining assets in any market
+- `get_top_losers`: Find top losing assets in any market
+- `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
+
+### 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
+
+## Installation
+
+### Using uv (Recommended)
+```bash
+uv add tradingview-mcp
+```
+
+### Using pip
+```bash
+pip install tradingview-mcp
+```
+
+### From Source
+```bash
+git clone https://github.com/your-repo/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
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "tradingview": {
+      "command": "tradingview-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+### 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
+
+### Running Tests
+```bash
+uv run pytest tests/
+```
+
+### Code Formatting
+```bash
+uv run ruff format .
+uv run ruff check . --fix
+```
+
+### Type Checking
+```bash
+uv run pyright
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

tradingview_mcp-1.0.0/pyproject.toml

@@ -0,0 +1,65 @@
+[project]
+name = "tradingview-mcp"
+version = "1.0.0"
+description = "A comprehensive MCP server for TradingView market screening with integrated screener functionality"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "TradingView MCP Team" }]
+keywords = ["mcp", "tradingview", "screener", "crypto", "stocks", "trading", "technical-analysis"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+
+dependencies = [
+    "mcp>=1.0.0",
+    "requests>=2.28.0",
+    "pandas>=2.0.0",
+    "httpx>=0.24.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "ruff>=0.1.0",
+    "pyright>=1.1.0",
+]
+
+[project.scripts]
+tradingview-mcp = "tradingview_mcp:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tradingview_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/tradingview_mcp/**"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+ignore = ["E501"]
+
+[tool.pyright]
+pythonVersion = "3.10"
+typeCheckingMode = "basic"

tradingview_mcp-1.0.0/src/tradingview_mcp/__init__.py

@@ -0,0 +1,14 @@
+"""
+TradingView MCP Server - A comprehensive MCP server for TradingView market screening.
+
+This package provides:
+- Direct TradingView API integration for market screening
+- SQL-like query interface for building complex filters
+- MCP tools for market analysis and technical indicators
+- Support for 76+ markets including crypto, stocks, forex, and futures
+"""
+
+from tradingview_mcp.server import mcp, main
+
+__version__ = "1.0.0"
+__all__ = ["mcp", "main"]