
TradingMCP (atilaahmettaner/tradingview-mcp), a community TradingView server
Not the official TradingView MCP server. This one is built by the community. TradingView makes its own: TradingView MCP Server →
Lets your AI assistant screen stocks and crypto, run technical analysis and backtest simple strategies.
This community server lets Claude, Cursor, ChatGPT and other assistants screen stocks and crypto, run technical analysis, backtest strategies and draw charts. You can run it free on your own computer, or pay for the hosted version. It is not made by TradingView, and the screener library it uses says US stock prices come back 15 minutes late. If you pay for TradingView's Essential plan or higher and want fundamentals, filings, watchlists and alerts from your own account, use the official TradingView server instead.
Good for
- Traders who want screeners and technical analysis inside Claude, Cursor or ChatGPT
- Hobbyists testing a simple strategy on past prices without writing code
- Developers who want a free, self-hosted market data server with no TradingView login
- Anyone who wants a morning market brief across crypto, stocks and gold
Works in
5 supported · 9 should work
Tap an app to see how to set it up and any known problems.
Documented by the hosted service's setup guide. tradingmcp.ai
Documented in the README. On macOS the config needs the full path to uvx.
Known problems
- Fixed
Seven tools hung forever with no error when run locally on Windows
Workaround: Update to 0.8.1 or later.
Reported Aug 2026 · GitHub
- Fixed
Times out on first launch on Windows when Python 3.14 is picked
Workaround: Add "--python", "3.13" to the uvx args, or run uv tool install --python 3.13 tradingview-mcp-server first.
Reported Apr 2026 · GitHub
Documented by the hosted service's setup guide. Use Agent mode, since Ask mode does not call tools. tradingmcp.ai
The repo ships a Codex plugin. Restart Codex so the tools load in a new session. GitHub
Hosted version only. Needs ChatGPT Plus, Pro or Business with Developer mode on. tradingmcp.ai
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install TradingMCP MCP
Claude Code
- 1
Copy this prompt.
Add the TradingMCP MCP server to Claude Code. Run this command: claude mcp add tradingview -- uvx --from tradingview-mcp-server tradingview-mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv, Python 3.10 to 3.13.
No TradingView account or API key is needed. It needs Python 3.10 to 3.13, so if the first launch times out on Python 3.14, add "--python", "3.13" to the args. The news and sentiment tools need a free Marketaux key in MARKETAUX_API_TOKEN (100 requests a day); without it the other tools still work. Install only the PyPI package tradingview-mcp-server, because copies of this repo under other accounts have added malware. The hosted TradingMCP option (paid, from $9 a month) needs no install. Its private link carries your API key, so treat it like a password.
Built from the package data we hold. Not yet tested by us.
Tools
Gives one verdict from chart signals, news sentiment and headlines
Pulls technical indicators, news sentiment and recent headlines for one symbol into a single combined read, so you do not have to check three sources. Use it when you want a quick all-round view of a stock or coin.
Try: “Give me a combined technical and news read on NVDA”
Network ·
combined_analysisRuns a full technical analysis on one coin or stock
Calculates the technical indicators for a single symbol on an exchange and timeframe you choose. Use it when you want the detailed numbers behind a chart for one asset.
Try: “Run a full technical analysis on BTCUSDT on Binance, 4h”
Network ·
coin_analysisChecks whether weekly, daily and intraday trends agree
Compares a symbol across timeframes from weekly down to 15 minutes to show whether the trends line up. Use it before acting on a short-term signal so you know the bigger picture.
Try: “Do a multi-timeframe analysis of ETH on KuCoin”
Network ·
multi_timeframe_analysisGets a live price quote for a stock, coin, ETF or index
Returns a real-time quote from Yahoo Finance for any stock, crypto, ETF or index symbol. Use it for a quick price check.
Try: “What is the current price of AAPL?”
Network ·
yahoo_priceShows major indices, top crypto, FX rates and key ETFs at once
Returns a global overview of the major indices, leading cryptocurrencies, currency rates and key ETFs in one call. Use it to start the day or check how markets are doing overall.
Try: “Give me a snapshot of global markets right now”
Network ·
market_snapshotLooks up prices for several named stocks at once
Returns the current price and daily percent change for a list of specific stock symbols. Use it when you already know the tickers you care about.
Try: “Get prices for NASDAQ:NVDA and KRX:005930”
Network ·
stock_pricesLists the biggest risers on an exchange
Returns the top gaining assets for an exchange and timeframe, using Bollinger Band analysis. It covers crypto exchanges and stock markets. Use it to see what is moving up right now.
Try: “Show me the top gainers on Binance over the last 15 minutes”
Network ·
top_gainersLists the biggest fallers on an exchange
Returns the top losing assets for an exchange and timeframe, for crypto and stock markets. Use it to spot sharp drops or oversold names.
Try: “Which coins are the biggest losers on KuCoin right now?”
Network ·
top_losersTests one trading strategy against past prices
Runs a chosen strategy over historical price data and reports performance figures such as return and drawdown. Use it to see how an idea would have done before you trust it. It does not place trades.
Try: “Backtest the RSI strategy on BTC-USD for 2 years”
Network ·
backtest_strategyRaces all nine built-in strategies on one symbol
Runs the nine built-in strategies on the same symbol and ranks them by performance. Use it to find which approach has worked best on an asset over a period.
Try: “Compare all strategies on MSFT for 2 years”
Network ·
compare_strategiesChecks if a strategy holds up on data it was not tuned on
Backtests a strategy with a walk-forward split to detect overfitting, validating it on unseen data. Use it after a normal backtest looks good to see whether the result is robust.
Try: “Run a walk-forward backtest of supertrend on SPY”
Network ·
walk_forward_backtest_strategyShows news sentiment for a stock or coin
Returns news sentiment for a stock or crypto symbol from a licensed news data provider. Use it to gauge whether coverage of an asset is turning positive or negative.
Try: “What is the news sentiment on TSLA?”
Network ·
market_sentimentFetches recent financial headlines
Returns recent financial news, optionally for a specific symbol and category, from a licensed provider. Use it to catch up on what is being reported about an asset.
Try: “Show me the latest crypto news headlines”
Network ·
financial_newsFinds assets whose price range has tightened
Scans an exchange for assets with low Bollinger Band width, the squeeze pattern that often comes before a bigger move. Use it to build a watchlist of coiled setups.
Try: “Scan KuCoin for Bollinger squeezes on the 4h chart”
Network ·
bollinger_scanFilters assets by their Bollinger Band rating
Lists assets on an exchange that match a Bollinger Band rating you pick, for a given timeframe. Use it to narrow a large market down to those with a particular signal strength.
Try: “Filter Binance coins with a Bollinger rating of 2 on 5m”
Network ·
rating_filterFinds assets breaking out on both volume and price
Detects coins where a volume breakout and a price breakout happen together. Use it to find moves that have real trading activity behind them.
Try: “Find volume breakouts on Binance”
Network ·
volume_breakout_scannerScans for unusual volume combined with technical signals
Combines volume analysis with technical indicators to surface assets worth a closer look. Use it when plain volume screens return too much noise.
Try: “Run the smart volume scanner on KuCoin”
Network ·
smart_volume_scannerChecks whether volume backs up a price move
Gives a detailed look at whether trading volume confirms the current move for one coin. Use it to judge if a breakout is likely to hold.
Try: “Does volume confirm the move in SOLUSDT?”
Network ·
volume_confirmation_analysisFinds assets with a run of growing or shrinking candles
Scans for coins showing a streak of consecutively growing or shrinking candles. Use it to spot steady momentum or fading moves.
Try: “Scan for coins with several growing candles in a row”
Network ·
consecutive_candles_scanDetects candlestick patterns across several timeframes
Analyses candle patterns using data from multiple timeframes. Use it when you want pattern signals confirmed beyond a single chart.
Try: “Check candlestick patterns on ETHUSDT”
Network ·
advanced_candle_patternRuns a technical, sentiment and risk debate on one symbol
Has three analyst roles (technical, sentiment and risk) weigh in on a single symbol and returns the debate. Use it when you want competing viewpoints rather than one score.
Try: “Run the multi-agent debate on AAPL”
Network ·
multi_agent_analysisEstimates whether large players are accumulating one symbol
Reads price and volume history for one symbol to estimate large-holder, or smart money, activity. It is a proxy built from price and volume, not actual holdings data. Use it to look for accumulation or distribution.
Try: “Run smart money analysis on NVDA”
Network ·
smart_money_analysisLists common or preferred shares for a country market
Lists common or preferred stocks for a TradingView country market such as america, korea or germany, with price, currency, change and dividend yield, ranked by market cap. Use it to browse a national market.
Try: “List the largest common stocks in Germany”
Network ·
stock_screenerGives a one-call Bitcoin overview with a risk read
Returns Bitcoin price, market dominance, total crypto market cap and a risk assessment in one call. Use it for a fast read on the crypto backdrop.
Try: “Give me the Bitcoin market pulse”
Network ·
bitcoin_market_pulseShows pre-market and after-hours prices for a US stock
Returns real-time pre-market and after-hours prices for a US stock symbol. Use it before the open or after the close to see where a stock is trading.
Try: “What is TSLA trading at in pre-market?”
Network ·
stock_extended_hoursPulls the full options chain for a US stock
Returns the calls and puts for a US stock symbol for one expiry date. Use it to look at strikes, prices and open positions before an options trade.
Try: “Show the options chain for AAPL for the next expiry”
Network ·
stock_options_chainFinds options strikes with unusually heavy activity
Ranks strikes by the ratio of volume to open interest for a US stock, a common sign of unusual positioning. Use it to see where traders are concentrating bets.
Try: “Show unusual options activity on AMD”
Network ·
stock_options_unusual_activityLists the most traded futures contracts
Returns top futures contracts sorted by trading volume. Use it to see where activity is concentrated in futures markets.
Try: “Give me an overview of the most traded futures”
Network ·
futures_market_overviewLists futures with the biggest moves today
Returns futures contracts with the largest percentage moves for the day. Use it to find what is moving in commodities, indices and rates.
Try: “Which futures are moving the most today?”
Network ·
futures_top_moversQuotes the main contracts in one futures category
Quotes all major front-month contracts for a futures category you choose. Use it to check a whole group, such as energy or metals, at a glance.
Try: “Show me a snapshot of the energy futures”
Network ·
futures_category_snapshotLists well-known futures symbols by category
Returns the categorized list of well-known front-month futures symbols the server knows about. Use it to find the right symbol before asking for a quote.
Try: “Show me the futures watchlist”
Network ·
futures_watchlistGives an overview of the Egyptian Exchange
Returns a broad overview of the Egyptian Exchange (EGX) market. Use it as the starting point for Egyptian stocks.
Try: “Give me an overview of the Egyptian market”
Network ·
egx_market_overviewScans Egyptian stocks within one sector
Scans EGX stocks by sector, and lists the available sectors if you do not name one. Use it to see how a particular sector is doing.
Try: “Scan the banking sector on EGX”
Network ·
egx_sector_scanShows which Egyptian sectors are hot or cold
Identifies hot and cold sectors on the EGX and highlights top picks, to show where money is rotating. Use it to decide which sector to look at first.
Try: “Which EGX sectors are leading right now?”
Network ·
egx_sector_scannerBreaks down how an Egyptian index's members are doing
Analyses an EGX index such as EGX30, showing how each constituent is performing with full indicators. Use it to see what is driving the index.
Try: “Analyse the EGX30 index”
Network ·
egx_index_analysisRanks strong Egyptian stocks with possible setups
Ranks EGX stocks and finds strong ones with actionable setups. Use it to build a shortlist of Egyptian stocks.
Try: “Screen EGX for the strongest stocks”
Network ·
egx_stock_screenerDrafts a trade plan for one Egyptian stock
Generates a full trade plan for a specific EGX stock. It is analysis, not advice, and does not place orders. Use it to see suggested levels for a stock you are watching.
Try: “Draft a trade plan for COMI on EGX”
Network ·
egx_trade_planCalculates Fibonacci levels for an Egyptian stock
Runs a Fibonacci retracement analysis for an EGX stock over a lookback period. Use it to find potential support and resistance levels.
Try: “Give me Fibonacci retracement levels for COMI”
Network ·
egx_fibonacci_retracementRanks Egyptian index members by accumulation signs
Ranks EGX index constituents by evidence of smart money accumulation. Use it to see which Egyptian stocks big buyers may be building positions in.
Try: “Which EGX30 stocks show smart money accumulation?”
Network ·
egx_smart_money_scanner
Read from the source code
Pros and cons
Good
- Free to self-host under the MIT license.
- No TradingView account or API key needed.
- Covers screeners, multi-timeframe analysis, backtests and in-chat charts.
- Cannot trade or touch a broker account.
- Works with Claude, Cursor, Codex and ChatGPT (hosted).
- Active maintainer who fixes bugs quickly.
Watch out
- Not made by TradingView, and it uses an unofficial data route.
- TradingView's terms bar machine-driven use without an agreement.
- Its screener library reports US stock data 15 minutes late.
- Scans fail for 30 to 90 seconds when TradingView throttles.
- Fake npm copies of the repo carry malware.
- Hosted version costs $9 or $29 a month.
Permissions
low risk · 6 things to watch
Low risk
It only reads market data and cannot trade, but it relies on an unofficial TradingView route and fake copies of the project carry malware.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Fake copies of this repo carry npm malware
Copies under other GitHub accounts add npm packages flagged as a remote-access trojan. The real project is Python only, so install from this repo or the PyPI package, never from npm. github.com
TradingView's terms bar machine-driven use of its data
The server reads an undocumented TradingView endpoint through unofficial libraries. TradingView's terms license its data for display only and ask for a separate agreement for machine-driven use, so automated use is at your own risk. tradingview.com
US stock prices can be 15 minutes late
The screener library it uses says US exchanges come back 15 minutes late without a TradingView login. Crypto is live, so check timestamps before acting on a stock quote. github.com
The hosted private link works like a password
Setups without sign-in put your API key in the link. Anyone with it can use up your quota, so keep it out of shared configs. tradingmcp.ai
It can return old data during outages
If TradingView keeps failing, results can come from a cache up to 6 hours old by default. Check timestamps. github.com
The optional proxy routes traffic via a third party
If you fill in the proxy settings, Yahoo Finance requests go through a residential proxy provider. Leave them blank to skip it. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Every tool only reads public market data and runs calculations. There is no trading, no broker connection and no TradingView account, so there is nothing to switch on. |
|---|---|
| Talks to | scanner.tradingview.com. Yahoo Finance. Marketaux (optional) |
| Sign-in and keys | Self-hosted needs no sign-in. The hosted version puts your API key in the private link. |
Alternatives
Use the official TradingView server if you pay for an Essential plan and want fundamentals, alerts and your own watchlists. Pick this one for free self-hosted screeners and backtests, or tradesdontlie's server to drive your own TradingView Desktop chart.
| Server | Official | Runs | Can change things | GitHub stars |
|---|---|---|---|---|
| For TradingView | ||||
| TradingView MCP Server (official) | Official | Hosted | – | – |
| TradingMCPThis page | Community | HostedLocal | No | 5.2K |
| tradesdontlie/tradingview-mcp | Community | Local | – | 7K |
| fiale-plus/tradingview-mcp-server | Community | Local | – | 52 |
| Other tools for the same job | ||||
| Alpha Vantage MCP | Community | Hosted | – | 224 |
What people say
People like that it needs no TradingView login and gets bugs fixed quickly, and dislike its uneven error handling and the fake copies of the repo.
What people like
- No TradingView account, login or key is needed, so nothing of yours can be banned or exposed.
- The maintainer fixes detailed bug reports fast: a hang reported on 19 Aug 2026 shipped as a fix five days later.
Common complaints
- Error replies come in two shapes, so an assistant often cannot tell a wrong symbol from an outage.
- Pre-market change was once measured from the wrong close and could show the wrong direction (since fixed).
- Bundled symbol lists went stale and scans missed tickers that changed exchange (since fixed).
- With Docker, the news key never reaches the container and the news tools fail silently.
In their words
“Seven tools never return when called through the MCP stdio server — no error, no timeout, no traceback. The call just hangs and the client waits indefinitely.”DcherukuriGitHub issueJul 2026
“A client cannot branch reliably on either shape.”Loryo80GitHub issueOct 2026
“It can report the wrong sign.”OmarHazem123GitHub issueOct 2026
“Anyone who follows `.env.example` verbatim gets no news data and no error anywhere.”rajanski
Questions
Do I need a TradingView account or API key?
No. The server never logs into TradingView and needs no key. The only optional key is a free Marketaux token for the news and sentiment tools.
Is it free?
Yes, if you run it yourself under the MIT license. The hosted version, TradingMCP, costs $9 a month for 2,500 calls or $29 a month for 10,000 calls, with a 14-day money-back guarantee.
How fresh is the price data?
Crypto is live. Stocks, FX and futures can be delayed, and the screener library it uses says US exchanges come back 15 minutes late without a TradingView login.
Is using it allowed under TradingView's terms?
TradingView's terms license its data for display-only, personal use and bar machine-driven or commercial use without an agreement. The project says it is not affiliated with TradingView and leaves compliance to you.
How is it different from TradingView's official MCP server?
TradingView's beta server needs a paid Essential plan and adds fundamentals, filings, watchlists and alerts. This one is free to self-host and adds backtests, multi-timeframe scans and in-chat charts.
Is there an npm package?
No. The project is Python only. Copies of the repo under other GitHub accounts have added npm packages that carry malware, so install from the PyPI package or this repo.
Can it place trades?
No. It only reads market data and runs analysis and backtests. It does not connect to brokers or place orders.
Why do I get empty results or errors from screeners?
TradingView sometimes returns empty replies for 30 to 90 seconds when it is hit too fast. The server retries, and if it still fails, wait about a minute and ask again.
Claude Desktop times out on first launch. What do I do?
Python 3.14 is not supported yet. Add "--python", "3.13" to the uvx args, or run uv tool install --python 3.13 tradingview-mcp-server before opening Claude Desktop.
What is the hosted TradingMCP server URL?
The hosted address is https://mcp.tradingmcp.ai/mcp. Some apps sign in with your account, and others use a private link that carries your API key.
Examples
Find the day's biggest crypto movers on one exchange
Show today's top crypto gainers on Binance
SourceFull technical read on one stock
Run a full technical analysis of NVDA
SourceCheck whether timeframes agree before a trade idea
What's the multi-timeframe read on gold?
SourceTest a simple strategy on past prices
Backtest an RSI strategy on BTC on the daily timeframe
SourceRank all built-in strategies on one ticker
Compare all 9 strategies on MSFT for 2 years
SourceMorning overview of global markets (hosted)
give me this morning's market brief
Source
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
tradingview-mcp-server- Registry
- PyPI
- Endpoint
https://mcp.tradingmcp.ai/mcp- Transport
- stdio, Streamable HTTP
- Auth
- OAuth
- Version
- 0.9.1
- License
- MIT
- Last commit
- Oct 29, 2026
- Open issues
- 5
- Listed in
- Official MCP registry
WebsiteTradingMCP setup guideGitHubPyPIOfficial MCP RegistrySelf-hosting install guideTradingMCP plansIssuesPrivacy policyTradingMCP terms
Other TradingView MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 16Hide
- github.com · github.com
- tradingmcp.ai · tradingmcp.ai
- github.com · github.com
- www.tradingview.com · tradingview.com
- github.com · github.com
- tradingview-mcp server.py · github.com
- github.com · github.com
- www.tradingview.com · tradingview.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com