---
title: "TradingView MCP: Market Data, Screeners and Backtests"
url: "https://mcpshelf.co/servers/tradingview"
description: "TradingView MCP gives an assistant prices, technical indicators, screeners and strategy backtests for stocks, crypto and forex, with no account. Setup and tools."
updated: "2026-10-27"
site: "MCP Shelf"
---

# TradingView MCP

> Prices, indicators, screeners and backtests for stocks, crypto and forex, no account needed.

## At a glance

This open source Python server answers market questions with public data: TradingView's screener and technical ratings, Yahoo Finance prices, and optional news sentiment. The model can scan an exchange for top movers or volume breakouts, run a multi-timeframe read on a symbol, and backtest one of nine simple strategies, including a walk-forward test that warns when a strategy only fits the past.

It is an independent project, not made by TradingView, and it never signs in to a TradingView account. The author also sells a hosted copy called TradingMCP; the self-hosted server here is free under the MIT licence. Nothing it says is financial advice.

|  |  |
| --- | --- |
| Made by | Atilla Ahmet Taner, an independent developer (not TradingView Inc.) |
| GitHub | https://github.com/atilaahmettaner/tradingview-mcp |
| Licence | MIT |
| PyPI package | [tradingview-mcp-server](https://pypi.org/project/tradingview-mcp-server/) 0.8.1 (24 Aug 2026) |
| GitHub stars | 5.1K |
| Last commit | 25 Oct 2026 |
| Tools | 37 |
| Runs on | Your computer or hosted |
| Install check | Started in our test |
| Category | [Knowledge and work apps](https://mcpshelf.co/categories/knowledge-and-work) |

**Our check:** We ran this exact config on 27 Oct 2026: it started and answered with 37 tools. The project is Python only: the real package is tradingview-mcp-server on PyPI. The author warns that copies under other accounts add an npm package that installs malware, so avoid any npm version.

## Tools

We listed 37 tools on 27 Oct 2026. Every one of them only reads.

| Tool | Kind | What it is for |
| --- | --- | --- |
| `top_gainers` | reads | Lists the biggest risers on an exchange over a timeframe, with Bollinger Band context. |
| `top_losers` | reads | Lists the biggest fallers on an exchange. |
| `bollinger_scan` | reads | Scans an exchange for tight Bollinger Bands, a common sign that a big move may follow. |
| `rating_filter` | reads | Filters symbols by their Bollinger Band rating. |
| `coin_analysis` | reads | Full technical read on one coin or stock: indicators, ratings and levels. |
| `consecutive_candles_scan` | reads | Finds symbols with several rising or falling candles in a row. |
| `advanced_candle_pattern` | reads | Looks for candle patterns across several timeframes. |
| `volume_breakout_scanner` | reads | Finds symbols breaking out on both price and volume. |
| `volume_confirmation_analysis` | reads | Checks whether volume backs up the recent move on one symbol. |
| `smart_volume_scanner` | reads | Combines volume spikes with technical filters to shortlist symbols. |
| `multi_agent_analysis` | reads | Has a technical, a sentiment and a risk view argue over one symbol and reports their verdict. |
| `egx_market_overview` | reads | An overview of the Egyptian Exchange. |
| `egx_sector_scan` | reads | Egyptian stocks grouped by sector. |
| `egx_sector_scanner` | reads | Which Egyptian sectors are strong or weak, with top picks. |
| `egx_index_analysis` | reads | How the members of an Egyptian index are doing. |
| `egx_stock_screener` | reads | Ranks Egyptian stocks by setup strength. |
| `egx_trade_plan` | reads | A full trade plan with entries, stops and targets for one Egyptian stock. |
| `egx_fibonacci_retracement` | reads | Fibonacci levels for an Egyptian stock. |
| `multi_timeframe_analysis` | reads | Checks whether weekly, daily, 4-hour, hourly and 15-minute signals agree. |
| `market_sentiment` | reads | News sentiment for a stock or coin, from Marketaux. Needs a key. |
| `financial_news` | reads | Recent market headlines, filtered by symbol if you like. Needs a Marketaux key. |
| `combined_analysis` | reads | Technical analysis, news sentiment and headlines for one symbol in a single call. |
| `backtest_strategy` | reads | Tests one of nine rule-based strategies on past prices and reports return, drawdown, Sharpe ratio and win rate. |
| `compare_strategies` | reads | Runs all nine strategies on one symbol and ranks them. |
| `walk_forward_backtest_strategy` | reads | Tests a strategy on data it was not tuned on and flags overfitting. |
| `yahoo_price` | reads | A live quote from Yahoo Finance for a stock, coin, ETF or index. |
| `market_snapshot` | reads | A quick view of major indices, top coins, currencies and key ETFs. |
| `bitcoin_market_pulse` | reads | Bitcoin price, dominance and total crypto market cap with a risk note. |
| `stock_extended_hours` | reads | Pre-market and after-hours prices for a US stock. |
| `stock_options_chain` | reads | The calls and puts for one US stock and expiry. |
| `stock_options_unusual_activity` | reads | Option strikes with unusually high volume against open interest. |
| `futures_market_overview` | reads | The most traded futures contracts, by category. |
| `futures_top_movers` | reads | Futures with the biggest moves today. |
| `futures_category_snapshot` | reads | Quotes for the main contracts in one category, such as energy or metals. |
| `futures_watchlist` | reads | The list of well-known futures symbols it understands, by category. |
| `stock_screener` | reads | Screens stocks by share type, such as common or preferred. |
| `stock_prices` | reads | Price and daily change for a list of exchange-prefixed tickers. |

### How clearly it describes its tools

37 of 37 tools have a description and 37 of 37 say whether they change things. The tool list takes at least ~6,000 tokens of context. Every tool says whether it only reads or can change things, so a client can ask before the risky ones. The tool list is large: switch off the tools you do not use if your client allows it.

## Set it up

### Claude Desktop

Where: claude_desktop_config.json (Settings → Developer → Edit Config)

```json
{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": [
        "--from",
        "tradingview-mcp-server",
        "tradingview-mcp"
      ]
    }
  }
}
```

### Claude Code

Where: Your terminal, in the project folder

```bash
claude mcp add-json tradingview '{"command":"uvx","args":["--from","tradingview-mcp-server","tradingview-mcp"]}'
```

### Cursor

Where: ~/.cursor/mcp.json, or .cursor/mcp.json in a project

```json
{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": [
        "--from",
        "tradingview-mcp-server",
        "tradingview-mcp"
      ]
    }
  }
}
```

### VS Code

Where: .vscode/mcp.json in your project

```json
{
  "servers": {
    "tradingview": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "tradingview-mcp-server",
        "tradingview-mcp"
      ]
    }
  }
}
```

### Windsurf

Where: ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": [
        "--from",
        "tradingview-mcp-server",
        "tradingview-mcp"
      ]
    }
  }
}
```

### ChatGPT

Where: Not supported

ChatGPT only connects to remote servers by URL. This one runs on your computer, so use Claude, Cursor or VS Code.

Add "MARKETAUX_API_TOKEN" in env to switch on financial_news and market_sentiment. Claude Desktop on a Mac often needs the full path to uvx.

### Remote option

The author's paid hosted version (TradingMCP), with sign-in and monthly limits. It serves the same tools plus charts drawn in the chat.

```
https://mcp.tradingmcp.ai/mcp
```

## Settings

| Setting | Kind | Required | What it does |
| --- | --- | --- | --- |
| `MARKETAUX_API_TOKEN` | env | no | A free Marketaux key that switches on the news and sentiment tools. The free tier allows 100 requests a day, and results are cached for four hours. |
| `--from tradingview-mcp-server` | flag | yes | Tells uvx which PyPI package holds the tradingview-mcp command. |

## What it can touch

**It can read**

- Public market data from TradingView's screener and Yahoo Finance
- News from Marketaux, if you add a key

**It can change**

**Safer setup:** It only reads public data and has no access to any brokerage or TradingView account, so it cannot place trades.

## Before you start

- uv, with Python 3.10 to 3.13 (3.14 is not supported yet)
- Optional: a free Marketaux key for the news and sentiment tools

## Good for

- A quick technical read on a stock or coin from a chat
- Screening an exchange for gainers, losers or unusual volume
- Trying a simple trading rule on past data before taking it seriously

## If it does not work

**Requests time out on the first launch on Windows**
Python 3.14 is not supported yet. Install Python 3.13 or older and point uvx at it with --python 3.13.

**The news tools say they are not configured**
Add MARKETAUX_API_TOKEN in env. Every other tool works without it.

**Claude Desktop says uvx was not found**
Use the full path to uvx, such as /Users/you/.local/bin/uvx, because desktop apps do not see your shell PATH.

**An analysis returns empty values**
TradingView sometimes returns nothing for bursts of requests. The server retries and caches, but ask for fewer symbols at once if it keeps happening.

## Similar servers

| Server | Tools | Runs on | Stars |
| --- | --- | --- | --- |
| [Obsidian MCP](https://mcpshelf.co/servers/obsidian) | 15 | Your computer | 4.5K |
| [Google Workspace MCP](https://mcpshelf.co/servers/google-workspace) | 43 | Your computer | 3.4K |
| [12306 MCP](https://mcpshelf.co/servers/12306) | 8 | Your computer | 2.4K |
| [Google Search Console MCP](https://mcpshelf.co/servers/search-console) | 21 | Your computer | 2K |

## Questions

### Is it made by TradingView?

No. It is an independent project that uses public data. TradingView launched its own MCP server in 2026 for paid TradingView plans.

### Do I need a TradingView account?

No. It never signs in to TradingView or controls the TradingView app.

### Is the hosted TradingMCP the same thing?

It is the author's paid hosted copy of the same tools. The server listed here is free to run yourself under the MIT licence.

### Why are there tools for the Egyptian Exchange?

The author added a set of EGX tools alongside the global ones. Leave them unused if you do not trade there.

### Can I trust its signals?

Treat them as a starting point for your own research. The project says plainly that nothing it produces is financial advice.

Full docs on GitHub: https://github.com/atilaahmettaner/tradingview-mcp

---

From [MCP Shelf](https://mcpshelf.co/): A short shelf of MCP servers that are worth installing. Index for agents: https://mcpshelf.co/llms.txt