# Tv Mcp

> A high-performance FastMCP server for programmatically scraping TradingView market data. The server provides unified endpoints for retrieving historical price data, computing technical indicators, and extracting market-relevant news. It is designed for automated research workflows, trading systems, and data-driven analytics pipelines.

- **Type:** MCP server
- **Install:** `agentstack add mcp-smitkunpara-tv-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [smitkunpara](https://agentstack.voostack.com/s/smitkunpara)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [smitkunpara](https://github.com/smitkunpara)
- **Source:** https://github.com/smitkunpara/tv-mcp
- **Website:** https://tradingview-mcp.vercel.app

## Install

```sh
agentstack add mcp-smitkunpara-tv-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# TradingView MCP Server

FastMCP server for TradingView data with an authenticated SSE endpoint for remote clients.

This repository is configured for SSE-first deployment on Vercel.

## Quick Start

```bash
git clone https://github.com/smitkunpara/tradingview-mcp.git
cd tradingview-mcp
uv sync
cp .env.example .env
```

Set required values in `.env`:

- `TRADINGVIEW_COOKIE`
- `TV_CLIENT_KEY`

## Run Local SSE Server

```bash
export TV_CLIENT_KEY="your-client-key"
uv run tradingview-mcp-sse
```

Defaults:

- Host: `0.0.0.0`
- Port: `8000`
- SSE endpoint: `/sse`
- Health endpoint: `/health`

Optional overrides:

```bash
export MCP_HTTP_HOST="0.0.0.0"
export MCP_HTTP_PORT="8000"
export MCP_SSE_PATH="/sse"
```

Authentication headers accepted on SSE endpoint:

- `X-API-Key: `
- `X-Client-Key: `
- `Authorization: Bearer `

Optional OAuth mode:

- Set `TV_OAUTH_JWKS_URL` (and optional issuer/audience/scope settings) to validate JWT bearer tokens.
- API key authentication remains available as fallback.

## Smoke Test (Vercel)

```bash
uv run python scripts/vercel_sse_smoke_test.py --url https://tradingview-mcp.vercel.app --client-key "$TV_CLIENT_KEY"
```

## Available Tools

| Category | Tools |
|---|---|
| Market Data | `get_historical_data`, `get_all_indicators` |
| News | `get_news_headlines`, `get_news_content` |
| Community | `get_ideas`, `get_minds` |
| Options | `get_option_chain_greeks`, `get_option_chain_oi` |

## Documentation

| Guide | Description |
|---|---|
| [Configuration Reference](docs/configuration.md) | Environment variables and runtime configuration |
| [Deployment Guide](docs/deployment.md) | SSE deployment on Vercel |

## License

MIT — see [LICENSE](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [smitkunpara](https://github.com/smitkunpara)
- **Source:** [smitkunpara/tv-mcp](https://github.com/smitkunpara/tv-mcp)
- **License:** MIT
- **Homepage:** https://tradingview-mcp.vercel.app

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-smitkunpara-tv-mcp
- Seller: https://agentstack.voostack.com/s/smitkunpara
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.