Provides tools to fetch real-time quotes, historical price charts, fundamental data, SEC filings, economic/earnings calendars, option chains, corporate bonds, and more from TradingView.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@tradingview-finance MCP Server get real-time quote for AAPL"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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.
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.
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.
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.
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.
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.
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.
Related MCP server: mcp-financex
Ensure dependencies are installed using uv:
uv syncTo run the MCP server:
uv run python server.pyAdd this configuration to your claude_desktop_config.json:
{
"mcpServers": {
"tradingview-finance": {
"command": "uv",
"args": [
"--directory",
"/path/to/tvfinance-mcp",
"run",
"python",
"server.py"
]
}
}
}Get the list of bonds issued by a public corporate company.
Only works for stocks that have issued debt/bonds (e.g. "NASDAQ:AAPL", "NYSE:MSFT").
Inputs: symbol (required). Returns: result
Get global stock dividend ex-dates, payout payment dates, and dividend amounts.
Inputs: from_date, to_date. Returns: result
Get public corporate report documents, SEC filings (10-K, 10-Q, 8-K), and earnings call transcripts.
Inputs: symbol (required). Returns: result
Get global corporate earnings release events, actual/estimate EPS, and revenue surprises.
Inputs: from_date, to_date. Returns: result
Get global macro economic calendar events from TradingView.
Inputs: from_date, to_date, countries, importance. Returns: result
Get the list of Exchange-Traded Funds (ETFs) that hold the specified stock.
Inputs: symbol (required). Returns: result
Get the financial statement overview and business/regional segment revenue breakdown for a stock.
Returns a unified summary of the Income Statement, Balance Sheet, Cash Flow, statistical ratios, historical dividend records, EPS/revenue earnings estimates, and revenue broken down by business line and geographic region.
Inputs: symbol (required). Returns: object
Get analyst target prices (low, high, average) and recommendation counts (buy, hold, sell) for a stock.
Inputs: symbol (required). Returns: object
Get historical candlestick/OHLCV (Open, High, Low, Close, Volume) chart data for a TradingView symbol.
"1", "5", "15", "30" (Minutes)
"60", "240" (Hours)
"1D" (Daily - Default)
"1W", "1M" (Weekly, Monthly)
"splits" (default - splits adjusted)
"dividends" (splits + dividends adjusted)
"none" (raw unadjusted)
Inputs: symbol (required), timeframe, resolution, count, +1 more. Returns: result
Get the list of constituent assets, weight percentages, and values held inside an ETF.
Inputs: symbol (required). Returns: result
Get TradingView community ideas, social market analyses, and directional outlooks for a symbol.
Inputs: symbol (required). Returns: result
Get upcoming global stock Initial Public Offering (IPO) dates, prices, and status.
Inputs: from_date, to_date. Returns: result
Get recent news articles and optional full text markdown for a TradingView symbol.
By default, fetch_body=False is used to return only headlines, source, and short summaries.
If you need the full text of an article for deep analysis or summarization, call this tool again
with fetch_body=True and a small limit (e.g. 1 or 2) to avoid overloading the context window.
Inputs: symbol (required), limit, lang, fetch_body. Returns: result
Get grouped call and put options contract chain for a stock or index underlying symbol.
Returns a list of paired call/put contracts grouped by strike price, sorted from lowest to highest strike.
If expiration is omitted, automatically finds and uses the nearest future expiration date.
If root is omitted, automatically resolves to the default options root (e.g. "AAPL" for Apple stock).
Inputs: symbol (required), expiration, root. Returns: result
Get the real-time quote, price details, and official logo URL for a TradingView symbol.
Use this tool to fetch the current market price, daily change, volume, bid/ask, and the logo path of any asset (stocks, index, crypto, forex, bonds, futures).
Inputs: symbol (required). Returns: object
Get global corporate revenue release events, estimate revenue, and surprise statistics.
Inputs: from_date, to_date. Returns: result
Get rich metadata and company profile details for a TradingView symbol.
Returns details like Sector, Industry, CEO name, CUSIP, ISIN, website URL, founded year, location, employee count, market cap, P/E ratio, dividend yield, EPS, all-time high/low, and whether it has corporate bonds.
Inputs: symbol (required). Returns: object
Get technical analysis indicators, moving averages, oscillators, and pivot point values for a symbol.
Inputs: symbol (required). Returns: object
Query the TradingView Stock, Crypto, or Forex Screener.
This tool allows scanning across markets or fetching technical analysis indicators (like RSI, MACD, Moving Averages) and recommendations for specific symbols.
Inputs: market, columns, sort_by, sort_order, +3 more. Returns: result
Search for available TradingView screener indicator or metric column IDs by keyword.
Use this tool to dynamically discover the exact case-sensitive column IDs (like 'dividends_yield', 'total_revenue_fy', 'RSI') before passing them to query_screener.
Inputs: query (required). Returns: result
Search for symbols, indicators, assets, or indices on TradingView.
Use this tool to find tickers, symbols, or economic/FRED data when you don't know the exact prefix or symbol name (e.g., when searching for "US GDP", "US CPI", "interest rate").
Each result contains:
symbol: The symbol code (e.g. "USGDP", "AAPL", "EURUSD").
exchange: The exchange or prefix name (e.g. "ECONOMICS", "FRED", "NASDAQ", "OANDA").
ticker: The fully qualified ticker in the format 'EXCHANGE:SYMBOL' (e.g. 'ECONOMICS:USGDP', 'FRED:GDPC1', 'NASDAQ:AAPL'). This ticker should be used for other tool calls.
description: A description of what the symbol represents (e.g. "United States GDP").
type: Asset type (e.g. "economic", "stock", "forex").
provider_id: Data source provider.
currency_code: Currency used for prices (e.g. "USD").
Inputs: query (required). Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 21 tools
Most tools have distinct purposes, like get_bonds vs get_etfs vs get_options_chain. However, get_financials_overview overlaps with get_dividends_calendar and get_forecast on some data, which could cause minor confusion. Overall, descriptions help differentiate.
The majority use 'get_<noun>' pattern, but query_screener, search_screener_columns, and search_symbols break this pattern with different verbs. The inconsistency makes it harder for an agent to predict tool names.
21 tools is somewhat high for a finance data server, but each covers a specific aspect (bonds, dividends, earnings, etc.), making the set comprehensive. A few tools could be merged (e.g., revenue and earnings calendars), but overall it's reasonable.
The server covers a wide range of financial data: quotes, history, fundamentals, calendars, options, news, and screener. Missing some advanced features like insider trading or SEC filings details, but for a general finance API, it's quite complete.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
MCP server for Financial Modeling Prep API with 250+ financial data tools
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
