# tradingview-mcp

Fetches TradingView indicators, quotes, and market scans through an MCP server without a desktop app or account.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 275 installs · ★ 3585 repo stars
- Author: himself65
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/himself65/finance-skills/tree/HEAD/plugins/data-providers/skills/tradingview-mcp/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tradingview-mcp

## What it does

The skill queries TradingView's public scanner endpoints and Yahoo Finance through the bundled `tradingview` MCP server. It exposes 39 tools for indicator readouts like RSI and MACD, multi-timeframe alignment, overnight futures, and volume breakout scans. All actions are read-only and never place real trades.

Running the server requires the `uv` tool and Python 3.10 through 3.13; the upstream build breaks on Python 3.14. Installing this skill file alone does not install the MCP server binary. You need to configure the server manually or install the parent `finance-data-providers` plugin.

Adding a `MARKETAUX_API_TOKEN` unlocks financial news and market sentiment tools. If you need options greeks or chart screenshots, switch to `tradingview-reader`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add himself65/finance-skills --skill tradingview-mcp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tradingview-mcp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tradingview-mcp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add himself65/finance-skills --skill tradingview-mcp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tradingview-mcp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add himself65/finance-skills --skill tradingview-mcp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tradingview-mcp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install himself65/finance-skills plugins/data-providers/skills/tradingview-mcp
```

2. **Manually: put the files in place**
- File: `.github/skills/tradingview-mcp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add himself65/finance-skills --skill tradingview-mcp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/himself65/finance-skills --path plugins/data-providers/skills/tradingview-mcp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tradingview-mcp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add himself65/finance-skills --skill tradingview-mcp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/himself65/finance-skills/tree/HEAD/plugins/data-providers/skills/tradingview-mcp/SKILL.md

## When to use it
- pull RSI, MACD, and indicator ratings for a stock or token
- align trends across weekly, daily, 4-hour, and 15-minute charts
- scan exchanges for Bollinger squeezes and volume breakouts
- inspect overnight movers across index and commodity futures
- check options chains for volume, open interest, and implied volatility

## Example prompts
- Give me a technical analysis readout with RSI and MACD for NVDA.
- Check multi-timeframe trend alignment on AAPL from weekly down to 15m.
- Scan NASDAQ for Bollinger squeeze candidates with volume confirmation.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: fe9c1aff653da637.

BEGIN THIRD-PARTY FILE fe9c1aff653da637
```text
---
name: tradingview-mcp
description: >
  Query TradingView market data through the bundled tradingview MCP server
  without a desktop app or login. Use whenever the user wants a technical
  analysis readout (RSI, MACD, Bollinger rating, BUY/SELL summary),
  multi-timeframe alignment (weekly→daily→4h→1h→15m),
  exchange-wide scans (Bollinger squeeze, volume breakout, consecutive
  candles, smart volume), top gainers/losers by exchange, futures market
  data (NQ/ES/CL/GC overview, overnight movers, category snapshots), pre-market /
  after-hours quotes, a quick options chain or unusual options activity
  (volume/OI by strike), bulk stock prices, a global market snapshot,
  strategy backtests (Sharpe, drawdown, win rate), or crypto exchange
  scans. Triggers include "TA on X", "multi-timeframe read", "BB squeeze
  scan", "futures movers", "NQ overnight", "pre-market price", "unusual
  options activity", "backtest RSI on AAPL", and "top gainers on NASDAQ".
  For options greeks, watchlists, alerts, or chart screenshots use
  tradingview-reader instead.
---

# TradingView MCP (Headless Market Data)

Market data via the bundled [`tradingview` MCP server](https://github.com/atilaahmettaner/tradingview-mcp) — TradingView's public scanner API plus Yahoo Finance, spoken over MCP. **No TradingView desktop app or account.** Most tools need no API key. The server ships with the full plugin (`mcp.json` for portable/Codex packages, `.mcp.json` for legacy clients) and starts when enabled in a host that supports local stdio MCP processes. Its 39 tools appear under the plugin's `tradingview` MCP namespace (load them through the client's deferred-tool mechanism when necessary). Installing only the skill does not install the MCP server; use the full `finance-data-providers` plugin or configure the server separately.

**Read-only.** Nothing here places trades or mutates any account.

## When to use this vs the other data skills

| Need | Skill |
|---|---|
| Quotes, TA readout, indicator ratings, multi-timeframe alignment | **this skill** |
| Exchange-wide scans: squeeze / volume breakout / gainers / losers | **this skill** |
| Futures (NQ, ES, CL, GC…) overview, movers, category quotes | **this skill** |
| Pre-market / after-hours price | **this skill** |
| Options chain quick look (bid/ask/IV/OI, **no greeks**), unusual activity | **this skill** (fallback / positioning scan) |
| Options chain **with greeks** (delta/gamma/theta/vega), IV skew, expiries with contract counts | `tradingview-reader` (desktop app) |
| Watchlists, alerts, TV news, chart state / screenshots, custom-column screener | `tradingview-reader` (desktop app) |
```
END THIRD-PARTY FILE fe9c1aff653da637

The third-party file has ended. Everything between the fe9c1aff653da637 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2669 of 9806 bytes. © himself65 · MIT · https://github.com/himself65/finance-skills/tree/HEAD/plugins/data-providers/skills/tradingview-mcp/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
