{"id":49833144,"url":"https://github.com/fiale-plus/tradingview-mcp-server","last_synced_at":"2026-05-13T22:07:29.349Z","repository":{"id":320461938,"uuid":"1082159548","full_name":"fiale-plus/tradingview-mcp-server","owner":"fiale-plus","description":"Unofficial MCP and CLI for TradingView API","archived":false,"fork":false,"pushed_at":"2026-04-10T23:44:18.000Z","size":2170,"stargazers_count":27,"open_issues_count":3,"forks_count":14,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T07:12:50.051Z","etag":null,"topics":["cli","financial-data","marketdata","mcp","tradingview"],"latest_commit_sha":null,"homepage":"https://fiale.plus/tradingview","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fiale-plus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-23T20:26:41.000Z","updated_at":"2026-04-23T17:33:08.000Z","dependencies_parsed_at":"2025-10-24T00:18:53.716Z","dependency_job_id":null,"html_url":"https://github.com/fiale-plus/tradingview-mcp-server","commit_stats":null,"previous_names":["fiale-plus/tradingview-mcp-server"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/fiale-plus/tradingview-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiale-plus%2Ftradingview-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiale-plus%2Ftradingview-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiale-plus%2Ftradingview-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiale-plus%2Ftradingview-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fiale-plus","download_url":"https://codeload.github.com/fiale-plus/tradingview-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fiale-plus%2Ftradingview-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33001457,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"ssl_error","status_checked_at":"2026-05-13T13:14:51.610Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","financial-data","marketdata","mcp","tradingview"],"created_at":"2026-05-13T22:07:28.551Z","updated_at":"2026-05-13T22:07:29.339Z","avatar_url":"https://github.com/fiale-plus.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"docs/images/demo.webp\" alt=\"TradingView MCP Server Demo\" width=\"100%\"\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![NPM Version](https://img.shields.io/npm/v/tradingview-mcp-server?style=flat-square)](https://www.npmjs.com/package/tradingview-mcp-server)\n[![NPM Downloads](https://img.shields.io/npm/dm/tradingview-mcp-server?style=flat-square)](https://www.npmjs.com/package/tradingview-mcp-server)\n[![Test Status](https://img.shields.io/github/actions/workflow/status/fiale-plus/tradingview-mcp-server/test.yml?branch=main\u0026label=tests\u0026style=flat-square)](https://github.com/fiale-plus/tradingview-mcp-server/actions/workflows/test.yml)\n[![License](https://img.shields.io/github/license/fiale-plus/tradingview-mcp-server?style=flat-square)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-Compatible-blue?style=flat-square)](https://modelcontextprotocol.io)\n\n**Unofficial** MCP server **and CLI** for TradingView's market screener API — stocks, forex, crypto \u0026 ETFs.\n\n### AI-powered investment research for patient, systematic investors.\n\n**Two modes, one package:** Use as an MCP server with Claude, or as a standalone CLI tool that pipes to `jq`, `csvtool`, or any Unix workflow.\n\n\u003c/div\u003e\n\n---\n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [CLI Usage](#cli-usage)\n- [Configuration](#configuration)\n- [MCP Tools](#mcp-tools)\n- [Screening Fields](#screening-fields)\n- [Pre-built Strategies](#pre-built-strategies)\n- [Investor Commands](#investor-commands)\n- [Operators](#operators)\n- [Development](#development)\n- [Disclaimer](#disclaimer)\n\n---\n\n## Features\n\n- **Dual mode: MCP + CLI** — use as an MCP server with Claude or as a standalone `tradingview-cli` command\n- **100+ screener fields** including Piotroski F-Score, Altman Z-Score, Graham Number, analyst consensus, and dividend growth streaks\n- **18 filter operators** including `crosses_above` / `crosses_below` for golden cross detection\n- **14 pre-built strategies** covering value, growth, quality, GARP, deep value, breakouts, compounders, and macro monitoring\n- **Symbol discovery** — search for TradingView symbols by name, ticker, or description via `search_symbols`\n- **Technical analysis** — TradingView-style buy/sell/neutral summaries and multi-timeframe TA ranking via `get_ta_summary` and `rank_by_ta`\n- **Market metadata** — discover available screener fields per market via `get_market_metainfo`\n- **9 investor workflow commands** — from `/due-diligence` to `/macro-dashboard` — built on top of the MCP tools\n- **Multi-asset coverage** — stocks, ETFs, forex, and crypto with asset-specific field discovery via `list_fields`\n- **Smart caching and rate limiting** — configurable TTL and requests-per-minute to keep usage responsible\n\n---\n\n## Installation\n\n### Option 1: NPM (Recommended)\n\n```bash\nnpm install -g tradingview-mcp-server\n```\n\n### Option 2: Clone Repository (includes demo commands)\n\n```bash\ngit clone https://github.com/fiale-plus/tradingview-mcp-server.git\ncd tradingview-mcp-server\nnpm install\n\n# Quick setup — creates project-level MCP config\n./local-setup.sh          # Linux/Mac\nlocal-setup.bat           # Windows\n\n# Restart Claude Code and try: /market-regime or /run-screener\n```\n\n---\n\n## CLI Usage\n\nAfter installing the package, the `tradingview-cli` command is available globally:\n\n```bash\n# List all pre-built screening strategies\ntradingview-cli presets\n\n# Screen stocks using a preset\ntradingview-cli screen stocks --preset quality_stocks --limit 10\n\n# Screen with custom filters\ntradingview-cli screen stocks --filters '[{\"field\":\"price_earnings_ttm\",\"operator\":\"less\",\"value\":15}]'\n\n# Look up specific symbols (indexes, stocks)\ntradingview-cli lookup NASDAQ:AAPL TVC:SPX NYSE:MSFT\n\n# Discover available screening fields\ntradingview-cli fields --asset-type stock --category fundamental\n\n# Search for a symbol\ntradingview-cli search apple --exchange NASDAQ\n\n# Get market metadata\ntradingview-cli metainfo america --fields name,close,market_cap_basic\n\n# Technical analysis summary\ntradingview-cli ta NASDAQ:AAPL NASDAQ:NVDA\n\n# Rank symbols by TA score\ntradingview-cli rank-ta NASDAQ:AAPL NASDAQ:MSFT NASDAQ:NVDA --timeframes 60,1D --weights '{\"1D\":3}'\n```\n\n### Output Formats\n\n```bash\n# JSON (default) — pipe to jq\ntradingview-cli screen stocks --preset value_stocks | jq '.stocks[].name'\n\n# CSV — pipe to file or csvtool\ntradingview-cli screen stocks --preset value_stocks -f csv \u003e results.csv\n\n# Table — human-readable terminal output\ntradingview-cli screen stocks --preset value_stocks -f table\n```\n\n### CLI Commands\n\n| Command | Description |\n|---|---|\n| `screen stocks [opts]` | Screen stocks by fundamental/technical criteria |\n| `screen forex [opts]` | Screen forex pairs |\n| `screen crypto [opts]` | Screen cryptocurrencies |\n| `screen etf [opts]` | Screen ETFs |\n| `lookup \u003csymbols...\u003e` | Look up specific symbols by ticker |\n| `search \u003cquery\u003e [opts]` | Search for symbols by name, ticker, or description |\n| `metainfo \u003cmarket\u003e [opts]` | Get metadata about a market screener |\n| `ta \u003csymbols...\u003e [opts]` | Get technical analysis summary for symbols |\n| `rank-ta \u003csymbols...\u003e [opts]` | Rank symbols by weighted TA scores |\n| `fields [opts]` | List available screening fields |\n| `preset \u003cname\u003e` | Get a preset strategy's details |\n| `presets` | List all available presets |\n\n### Screen Options\n\n| Flag | Description |\n|---|---|\n| `--filters \u003cjson\u003e` | Filter array as JSON string |\n| `--preset \u003cname\u003e` | Load a preset (merges with `--filters`) |\n| `--markets \u003cmarket\u003e` | Market to screen (repeatable, stocks/etf only) |\n| `--sort-by \u003cfield\u003e` | Sort by field |\n| `--sort-order \u003casc\\|desc\u003e` | Sort direction |\n| `--limit \u003cn\u003e` | Max results (1-200, default 20) |\n| `--columns \u003ccol\u003e` | Columns to include (repeatable) |\n| `-f, --format \u003cfmt\u003e` | Output: `json`, `csv`, or `table` |\n\n---\n\n## Configuration\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` on Mac:\n\n```json\n{\n  \"mcpServers\": {\n    \"tradingview\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"tradingview-mcp-server\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\nCreate `.mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"tradingview\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"tradingview-mcp-server\"]\n    }\n  }\n}\n```\n\nEnable in `.claude/settings.local.json`:\n\n```json\n{\n  \"enableAllProjectMcpServers\": true\n}\n```\n\n### Environment Variables\n\n| Variable | Default | Description |\n|---|---|---|\n| `CACHE_TTL_SECONDS` | `300` | How long to cache API responses (seconds) |\n| `RATE_LIMIT_RPM` | `10` | Maximum API requests per minute |\n\n---\n\n## MCP Tools\n\nTwelve tools are exposed to Claude:\n\n| Tool | Description | Key Parameters |\n|---|---|---|\n| `screen_stocks` | Screen stocks by fundamental and technical criteria | `filters`, `markets`, `sort_by`, `limit`, `columns` |\n| `screen_forex` | Screen forex pairs by technical criteria | `filters`, `sort_by`, `limit` |\n| `screen_crypto` | Screen cryptocurrencies by market and technical criteria | `filters`, `sort_by`, `limit` |\n| `screen_etf` | Screen ETFs by performance and technical criteria | `filters`, `markets`, `sort_by`, `limit` |\n| `lookup_symbols` | Direct lookup by ticker — required for indexes like `TVC:SPX` | `symbols` (up to 100), `columns` |\n| `list_fields` | Discover available fields for any asset type | `asset_type` (`stock`, `forex`, `crypto`, `etf`), `category` |\n| `search_symbols` | Search for symbols by name, ticker, or description | `query`, `exchange`, `asset_type`, `limit` |\n| `get_market_metainfo` | Get metadata about a market screener and available fields | `market`, `fields`, `mode` (`summary`/`raw`) |\n| `get_ta_summary` | TradingView-style technical analysis summary (buy/sell/neutral) | `symbols`, `timeframes`, `include_components` |\n| `rank_by_ta` | Rank symbols by weighted TA scores across timeframes | `symbols`, `timeframes`, `weights` |\n| `get_preset` | Retrieve a pre-configured screening strategy by key | `preset_name` |\n| `list_presets` | List all available preset strategies with descriptions | — |\n\n### Filter Structure\n\nAll screening tools accept filters in this shape:\n\n```json\n{ \"field\": \"return_on_equity\", \"operator\": \"greater\", \"value\": 15 }\n{ \"field\": \"RSI\", \"operator\": \"in_range\", \"value\": [40, 65] }\n{ \"field\": \"SMA50\", \"operator\": \"crosses_above\", \"value\": \"SMA200\" }\n{ \"field\": \"exchange\", \"operator\": \"in_range\", \"value\": [\"NASDAQ\", \"NYSE\"] }\n```\n\nCross-field comparison (second example above) enables golden cross / death cross detection without needing a value on the right-hand side.\n\n### Symbol Discovery\n\nUse `search_symbols` to find exact TradingView identifiers before screening:\n\n```json\n// Search for Apple\n{ \"query\": \"apple\" }\n\n// Narrow by exchange and type\n{ \"query\": \"bitcoin\", \"exchange\": \"BINANCE\", \"asset_type\": \"crypto\" }\n```\n\nReturns normalized symbols with exchange, type, and currency.\n\n### Market Metainfo\n\nUse `get_market_metainfo` to discover available fields for a market:\n\n```json\n// All fields for US stocks\n{ \"market\": \"america\" }\n\n// Specific fields only\n{ \"market\": \"america\", \"fields\": [\"name\", \"close\", \"market_cap_basic\"] }\n\n// Raw passthrough for debugging\n{ \"market\": \"america\", \"mode\": \"raw\" }\n```\n\n### Technical Analysis Summary\n\nUse `get_ta_summary` for TradingView-style buy/sell/neutral labels:\n\n```json\n// Single symbol, default timeframes (60m, 4H, 1D, 1W)\n{ \"symbols\": [\"NASDAQ:AAPL\"] }\n\n// Multiple symbols with custom timeframes\n{ \"symbols\": [\"NASDAQ:AAPL\", \"NASDAQ:NVDA\"], \"timeframes\": [\"60\", \"240\", \"1D\", \"1W\"] }\n```\n\nReturns labels (`strong_buy`, `buy`, `neutral`, `sell`, `strong_sell`) plus raw scores based on oscillators and moving averages.\n\n### TA Ranking\n\nUse `rank_by_ta` to compare symbols by weighted technical alignment:\n\n```json\n// Equal-weight ranking\n{ \"symbols\": [\"NASDAQ:AAPL\", \"NASDAQ:MSFT\", \"NASDAQ:NVDA\"] }\n\n// Weight daily timeframe 3x more\n{ \"symbols\": [\"NASDAQ:AAPL\", \"NASDAQ:MSFT\"], \"weights\": { \"1D\": 3, \"1W\": 2 } }\n```\n\nReturns ranked list with per-timeframe breakdown and weighted average score.\n\n---\n\n## Screening Fields\n\nUse `list_fields` to browse fields. Pass `asset_type` to get tailored lists for each asset class.\n\n### Stocks (~80 fields)\n\n**Valuation**\n`price_earnings_ttm`, `price_book_fq`, `price_sales_current`, `enterprise_value_current`, `enterprise_value_ebitda_ttm`, `enterprise_value_to_ebit_ttm`, `price_earnings_growth_ttm` (PEG), `ebitda`\n\n**Profitability \u0026 Returns**\n`return_on_equity`, `return_on_assets`, `return_on_invested_capital_fq`, `gross_margin_ttm`, `operating_margin_ttm`, `net_margin_ttm`, `after_tax_margin`, `pre_tax_margin_ttm`, `free_cash_flow_margin_ttm`\n\n**Growth**\n`total_revenue_yoy_growth_ttm`, `earnings_per_share_diluted_yoy_growth_ttm`, `revenue_per_share_ttm`, `total_revenue`, `net_income`, `earnings_per_share_diluted_ttm`\n\n**Balance Sheet**\n`debt_to_equity`, `total_debt`, `total_assets`, `current_ratio`, `free_cash_flow_ttm`, `free_cash_flow_fq`\n\n**Dividends**\n`dividend_yield_recent`, `dividends_yield_current`, `dividend_payout_ratio_ttm`, `continuous_dividend_payout_years`, `dps_yoy_growth_ttm`\n\n**Composite Scores** (unique differentiators)\n\n| Field | Description |\n|---|---|\n| `piotroski_f_score_ttm` | 0–9 financial strength composite. Score ≥7 = strong, ≤2 = weak |\n| `altman_z_score_ttm` | Bankruptcy predictor. \u003e2.99 = safe, 1.81–2.99 = grey zone, \u003c1.81 = distress |\n| `graham_numbers_ttm` | Intrinsic value = sqrt(22.5 × EPS × BVPS). Price below = undervalued |\n\n**Analyst Data**\n`Recommend.All` (composite −1 to +1), `analyst_recommendations_buy`, `analyst_recommendations_sell`, `analyst_recommendations_neutral`, `price_target_average`, `price_target_high`, `price_target_low`\n\n**Technical**\n`RSI`, `SMA50`, `SMA200`, `EMA10`, `VWAP`, `ATR`, `ADX`, `Volatility.M`, `beta_1_year`, `beta_3_year`, `beta_5_year`, `Recommend.MA`, `Recommend.Other`\n\n**Performance \u0026 Price Levels**\n`close`, `change`, `volume`, `average_volume_90d_calc`, `average_volume_30d_calc`, `relative_volume_10d_calc`, `Perf.5D`, `Perf.W`, `Perf.1M`, `Perf.3M`, `Perf.6M`, `Perf.Y`, `Perf.YTD`, `Perf.3Y`, `Perf.5Y`, `Perf.10Y`, `Perf.All`, `price_52_week_high`, `price_52_week_low`, `all_time_high`, `all_time_low`, `High.All`\n\n**Metadata**\n`sector`, `industry`, `exchange`, `market`, `is_primary`, `indexes`, `fundamental_currency_code`, `earnings_release_next_trading_date_fq`\n\n### ETFs\n`expense_ratio`, `shares_outstanding`, `dividends_yield_current`, `close`, `volume`, `Perf.W` through `Perf.Y`, `RSI`, `ATR`\n\n### Crypto\n`close`, `change`, `volume`, `market_cap_basic`, `RSI`, `ATR`, `Volatility.M`, `Perf.W` through `Perf.Y`\n\n### Forex\n`close`, `change`, `volume`, `RSI`, `ATR`, `ADX`, `Volatility.D`, `SMA50`, `SMA200`, `Perf.W` through `Perf.3M`\n\n---\n\n## Pre-built Strategies\n\nRetrieve any preset with `get_preset` or browse all with `list_presets`.\n\n| Key | Name | Style | What It Screens For |\n|---|---|---|---|\n| `quality_stocks` | Quality Stocks (Conservative) | Quality | ROE \u003e12%, low debt, low volatility, golden cross |\n| `value_stocks` | Value Stocks | Value | P/E \u003c15, P/B \u003c1.5, ROE \u003e10% |\n| `dividend_stocks` | Dividend Stocks | Income | Yield \u003e3%, large cap, D/E \u003c1.0 |\n| `momentum_stocks` | Momentum Stocks | Momentum | RSI 50–70, golden cross, 1M performance \u003e5% |\n| `growth_stocks` | Growth Stocks | Growth | ROE \u003e20%, operating margin \u003e15% |\n| `quality_growth_screener` | Quality Growth Screener | Quality + Growth | 16 filters: ROE, margins, revenue growth, technicals, exchange filter |\n| `quality_compounder` | Quality Compounders (Munger/Buffett) | Compounder | Gross margin \u003e40%, ROIC \u003e15%, FCF margin \u003e15%, growing revenue |\n| `garp` | GARP (Growth at Reasonable Price) | GARP | PEG \u003c2, ROE \u003e15%, revenue growth \u003e10% |\n| `deep_value` | Deep Value (Contrarian) | Deep Value | P/E \u003c10, P/B \u003c1.5, positive FCF |\n| `breakout_scanner` | Breakout Scanner | Momentum | Near 52-week high, golden cross, RSI 50–75, above-average volume |\n| `earnings_momentum` | Earnings Momentum | Earnings | EPS growth YoY \u003e20%, revenue growth \u003e10%, RSI 45–70 |\n| `dividend_growth` | Dividend Growth (Compounding Income) | Dividend Growth | Yield 1–6%, payout ratio \u003c70%, positive FCF, consecutive years paying |\n| `macro_assets` | Macro Asset Monitor | Macro | VIX, DXY, 10Y yield, Gold, WTI Oil, Bitcoin — direct symbol lookup |\n| `market_indexes` | Global Market Indexes | Market Regime | 13 global indexes (US, Europe, Asia, Nordic) with ATH and performance data |\n\n---\n\n## Investor Commands\n\nThe repository ships with 9 ready-to-use Claude Code commands in `.claude/commands/`. Clone the repo and run `./local-setup.sh` to activate them.\n\n| Command | Usage | What It Does |\n|---|---|---|\n| `/market-regime` | `/market-regime` | Analyzes Nasdaq, OMX Stockholm 30, and Nikkei 225 vs ATH. Shows drawdown, RSI, and bull/correction/bear regime status |\n| `/run-screener` | `/run-screener` | Interactive wizard to pick a preset strategy, run it, display a compact table, and save results to CSV |\n| `/due-diligence` | `/due-diligence AAPL` | Structured due diligence report: valuation, quality, growth, balance sheet, dividends, technicals, performance, and checklist assessment |\n| `/compare-peers` | `/compare-peers AAPL MSFT GOOGL` | Side-by-side comparison of 2–5 stocks across valuation, quality, growth, and momentum with category rankings |\n| `/sector-rotation` | `/sector-rotation` | Screens top stocks in all 11 GICS sectors, calculates average performance, assigns Accelerating/Decelerating signals, and recommends a preset |\n| `/smart-screen` | `/smart-screen` | Determines current market regime (bull/correction/bear) from SPX, then auto-selects and runs the most appropriate preset |\n| `/macro-dashboard` | `/macro-dashboard` | Multi-asset snapshot: US and global indexes, VIX, DXY, 10Y yield, Gold, Oil, BTC with auto-interpreted macro signals |\n| `/portfolio-risk` | `/portfolio-risk AAPL MSFT JPM XOM` | Portfolio concentration risk, sector breakdown, beta analysis, and diversification recommendations |\n| `/investment-thesis` | `/investment-thesis NVDA` | Data-driven investment thesis with bull/bear case, key metrics table, technical setup, entry/exit framework, and monitoring checklist |\n\n---\n\n## Operators\n\nAll screening tools support the following operators in filter conditions:\n\n| Operator | Description | Example |\n|---|---|---|\n| `greater` | Field \u003e value | `return_on_equity \u003e 15` |\n| `less` | Field \u003c value | `price_earnings_ttm \u003c 20` |\n| `greater_or_equal` | Field \u003e= value | `close \u003e= 10` |\n| `less_or_equal` | Field \u003c= value | `Volatility.M \u003c= 3` |\n| `equal` | Exact match | `sector = \"Technology\"` |\n| `not_equal` | Not equal | `exchange != \"OTC\"` |\n| `in_range` | Value within `[min, max]` or in a list | `RSI in [45, 65]` or `exchange in [\"NASDAQ\", \"NYSE\"]` |\n| `not_in_range` | Value outside range or list | `RSI not_in [70, 100]` |\n| `crosses` | Field crosses the reference (either direction) | `SMA50 crosses SMA200` |\n| `crosses_above` | Field crosses above the reference | `SMA50 crosses_above SMA200` (golden cross) |\n| `crosses_below` | Field crosses below the reference | `SMA50 crosses_below SMA200` (death cross) |\n| `match` | Text contains substring | `name match \"tech\"` |\n| `above_percent` | Field is N% above reference | `close above_percent SMA200` |\n| `below_percent` | Field is N% below reference | `close below_percent SMA200` |\n| `has` | Field contains value (list fields) | `indexes has \"S\u0026P 500\"` |\n| `has_none_of` | Field contains none of the values | filters out specific index members |\n| `empty` | Field has no value | `dividend_yield_recent empty` |\n| `not_empty` | Field has a value | `all_time_high not_empty` |\n\nString fields (`sector`, `exchange`, `industry`, `market`) use `equal` for single values and `in_range` for lists.\n\n---\n\n## Development\n\n```bash\nnpm install          # Install dependencies\nnpm run build        # Compile TypeScript to dist/\nnpm test             # Run all tests\nnpm run test:watch   # Run tests in watch mode\nnpm run dev          # Run directly with tsx (no build step)\n```\n\nRun a single test file:\n\n```bash\nnpm test -- fields.test.ts\n```\n\nAfter making changes, restart Claude to reload the MCP server (no hot-reload).\n\n### Adding a New Field\n\n1. Add to `STOCK_FIELDS` in `src/tools/fields.ts` with `name`, `label`, `category`, `type`, `description`\n2. Optionally add to `EXTENDED_COLUMNS` in `src/tools/screen.ts`\n\n### Adding a New Preset\n\nAdd to `PRESETS` in `src/resources/presets.ts` with `filters`, `markets`, `sort_by`, `sort_order`, and optional `columns`.\n\n### Adding a New Tool\n\n1. Create implementation in `src/tools/`\n2. Register in `ListToolsRequestSchema` handler in `src/index.ts`\n3. Add case in `CallToolRequestSchema` handler\n\n---\n\n## Disclaimer\n\nThis is an **unofficial** tool. It is not affiliated with, endorsed by, or connected to TradingView. It uses TradingView's public scanner API, which may change without notice. No authentication is required; access level is the same as the TradingView website without login.\n\n**Not investment advice.** Screening results are for informational and educational purposes only. All investment decisions are your sole responsibility. Past performance does not indicate future results. Consult qualified financial advisors before making investment decisions.\n\nThis software is provided \"AS IS\" under the [MIT License](LICENSE), without warranty of any kind.\n\n---\n\n## Links\n\n- [Model Context Protocol](https://spec.modelcontextprotocol.io)\n- [TradingView](https://www.tradingview.com)\n- [Claude Desktop](https://claude.ai/download)\n- [Claude Code](https://docs.claude.com/claude-code)\n\n---\n\n**Smarter screens, not faster trades.**\n\nBuilt with the [Model Context Protocol](https://modelcontextprotocol.io)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiale-plus%2Ftradingview-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiale-plus%2Ftradingview-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiale-plus%2Ftradingview-mcp-server/lists"}