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.

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:

uv sync

Running Server Directly

To run the MCP server:

uv run python server.py

Desktop App Integration (Claude Desktop App Config)

Add this configuration to your claude_desktop_config.json:

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