npm package: @phoenixaihub/tradingview-mcp
Description: MCP server for TradingView — screener, quotes, 30+ technical indicators, and symbol search
Latest version: 0.1.0

# TradingView MCP Server

[![npm version](https://img.shields.io/npm/v/@phoenixaihub/tradingview-mcp)](https://www.npmjs.com/package/@phoenixaihub/tradingview-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)

> MCP server for TradingView — stock screener, real-time quotes, 30+ technical indicators, and symbol search. No API key required.

## Quick Start

```bash
npx @phoenixaihub/tradingview-mcp
```

Or install globally:

```bash
npm install -g @phoenixaihub/tradingview-mcp
tradingview-mcp
```

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "tradingview": {
      "command": "npx",
      "args": ["-y", "@phoenixaihub/tradingview-mcp"]
    }
  }
}
```

### OpenClaw

Add to `mcp-config.json`:

```json
{
  "mcpServers": {
    "tradingview": {
      "command": "npx",
      "args": ["-y", "@phoenixaihub/tradingview-mcp"]
    }
  }
}
```

---

## Tools

| Tool | Description | Key Inputs |
|------|-------------|------------|
| `screen_stocks` | Screen US stocks with custom filters | `filters` (volume, RSI, price, etc.) |
| `get_quote` | Real-time price quote for any symbol | `symbol` |
| `get_indicators` | 30+ technical indicators for a symbol | `symbol`, `indicators[]` |
| `search_symbols` | Search symbols by name or ticker | `query` |

---

## Indicators

All 30+ indicators available via `get_indicators`:

| Category | Indicators |
|----------|------------|
| **Momentum** | `rsi`, `rsi7`, `macd_macd`, `macd_signal`, `macd_hist`, `stoch_k`, `stoch_d`, `cci20`, `adx` |
| **Moving Averages** | `sma10`, `sma20`, `sma50`, `sma200`, `ema10`, `ema20`, `ema50`, `ema200` |
| **Volatility** | `atr` |
| **Volume** | `volume`, `vwap`, `average_volume_10d`, `average_volume_30d`, `relative_volume` |
| **Price** | `close`, `open`, `high`, `low`, `change` |
| **Fundamental** | `market_cap` |

---

## Examples

### Screen high-volume oversold stocks

```json
{
  "filters": [
    { "left": "volume", "operation": "greater", "right": 1000000 },
    { "left": "RSI", "operation": "less", "right": 30 }
  ]
}
```

### Get technical indicators

```json
{
  "symbol": "AAPL",
  "indicators": ["rsi", "macd_macd", "sma50", "sma200", "atr", "vwap"]
}
```

### Search symbols

```json
{ "query": "Tesla" }
```

---

## Comparison

| Feature | @phoenixaihub/tradingview-mcp | Other tradingview-mcp | tradingview-ta (Python) |
|---------|:---:|:---:|:---:|
| MCP native | ✅ | ✅ | ❌ |
| Stock screener | ✅ | ❌ | ❌ |
| 30+ indicators | ✅ | Limited | ✅ |
| Real-time quotes | ✅ | ✅ | ❌ |
| Symbol search | ✅ | ❌ | ❌ |
| No API key | ✅ | ✅ | ✅ |
| npx one-liner | ✅ | ✅ | ❌ |

---

## Roadmap

- [ ] Chart snapshot capture (visual analysis)
- [ ] WebSocket streaming for real-time mode
- [ ] Forex & crypto screener support
- [ ] Watchlist management
- [ ] Alert creation
- [ ] Custom timeframe indicators (15m, 1h, 4h, 1W)
- [ ] SSE transport for remote deployments

---

## Development

```bash
git clone https://github.com/phoenix-assistant/tradingview-mcp-server.git
cd tradingview-mcp-server
npm install
npm run build
npm start
```

---

## Disclaimer

This project is **not affiliated with or endorsed by TradingView**. It uses TradingView's publicly accessible endpoints for personal and educational use. Use responsibly and respect TradingView's terms of service. Do not use for data redistribution or commercial data resale.

---

## License

MIT © [Phoenix Assistant](https://github.com/phoenix-assistant)