# tradingview-finance MCP Server

An MCP (Model Context Protocol) server providing Model-usable tools to fetch real-time quotes, historical price charts, fundamental datasets, SEC filings, economic/earnings calendars, option chains, and corporate bond data from TradingView.

> [!CAUTION]
> **CRITICAL LEGAL NOTICE & DISCLAIMER: READ BEFORE USE**
>
> **BEFORE ACCESSING OR USING THIS REPOSITORY, YOU MUST READ AND AGREE TO THE FULL [LEGAL DISCLAIMER & TERMS OF USE](DISCLAIMER.md).**
>
> 1. **STRICTLY FOR EDUCATIONAL & PERSONAL RESEARCH ONLY**: This project is an open-source educational research tool designed to analyze web protocols. It is **NOT** a commercial product, **NOT** a financial service, and **MUST NOT** be used for production or commercial purposes.
> 2. **NO AFFILIATION WITH TRADINGVIEW**: This server is **NOT** affiliated with, sponsored by, endorsed by, or associated with TradingView, Inc. or any of its partners or affiliates. "TradingView" is a registered trademark of TradingView, Inc.
> 3. **USE AT YOUR OWN RISK (NO WARRANTY)**: This software is provided "AS IS", without warranty of any kind, express or implied. The author, contributors, and maintainers **ACCEPT ZERO LIABILITY** for any damages, losses, server bans, IP blocks, or account suspensions that may result from using this software.
> 4. **COMPLIANCE & TERMS OF SERVICE**: Users are solely and fully responsible for ensuring compliance with TradingView's Terms of Use, policies, and local laws. The author does **not** encourage, condone, or facilitate automated scraping, commercial exploitation, or any access patterns that violate TradingView's policies.
> 5. **NO FINANCIAL OR INVESTMENT ADVICE**: Any data retrieved by this tool is strictly informational. It does **not** constitute financial, trading, or investment advice. The author is **not** a financial advisor and shall **not** be held liable for any trading decisions or investment losses.

---

## Features & Tools

This MCP server exposes the following tools to Claude or any other compatible MCP host:

* `search_symbols(query)`: Search for tickers, economic indexes, or FRED data.
* `get_symbol_profile(symbol)`: Retrieve company overview metadata.
* `get_quote(symbol)`: Fetch real-time price quote and official logo URL.
* `get_history(symbol, ...)`: Fetch historical daily/intraday OHLCV price bars.
* `get_news(symbol, ...)`: Get headlines and full text articles in Markdown.
* `get_options_chain(symbol, ...)`: Fetch strike price groupings and paired call/put contracts.
* `get_bonds(symbol)`: Get bonds issued by a corporate entity.
* `get_etfs(symbol)`: Find ETFs holding the specified stock symbol.
* `get_holdings(symbol)`: Get ETF constituent weight breakdowns.
* `get_documents(symbol)`: List SEC filings, reports, and transcript docs.
* `get_ideas(symbol)`: Get community technical analysis and outlook ideas.
* `get_financials_overview(symbol)`: Get segments, income statements, balance sheets, and key statistics.
* `get_forecast(symbol)`: Retrieve analyst target prices and consensus recommendations.
* `get_technicals(symbol)`: Get technical indicators and oscillator consensual ratings.
* `get_economic_calendar(...)`: Retrieve macro economic calendar events.
* `get_earnings_calendar(...)`: Retrieve global corporate earnings reports.
* `get_dividends_calendar(...)`: Fetch dividend ex-date events.
* `get_ipo_calendar(...)`: Query Initial Public Offering listings.
* `get_revenue_calendar(...)`: Fetch revenue surprise datasets.

## Development & Usage

Ensure dependencies are installed using `uv`:

```bash
uv sync
```

### Running Server Directly

To run the MCP server:

```bash
uv run python server.py
```

### Desktop App Integration (Claude Desktop App Config)

Add this configuration to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "tradingview-finance": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/tvfinance-mcp",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}
```