TipRanks
MCP server by TipRanks
Look up analyst ratings, Smart Scores, news, technicals, ETFs and your TipRanks portfolios from your AI assistant.
Connect to TipRanks
TipRanks needs sign-in. Connect with its own URL:
Your client opens TipRanks’s sign-in the first time you use it. The token stays between your client and TipRanks.
Share this server
Opens this page, with the URL and setup steps.
mcp.tc/i/tipranksAbout
Connects to TipRanks market data and research. Tools cover analyst ratings and price targets, Smart Score rankings, news with sentiment, bull and bear summaries, technical indicators, earnings, IPO and split calendars, buybacks, hedge fund and politician trading activity, ETFs, commodities and the economic calendar. Portfolio tools return holdings, performance, and allocation for portfolios on your TipRanks account.
Runs as a hosted streamable HTTP endpoint at https://mcp.tipranks.com/mcp/. Tool calls require signing in with OAuth, or a TipRanks API key sent as a Bearer token. A free-tier key is available from the TipRanks MCP site. Data may be delayed and is for information only, not investment advice.
What you can do
- Get analyst ratings, price targets and key data for tickers
- Rank top-rated and top Smart Score stocks
- Read ticker and market news with sentiment tags
- Run technical analysis: RSI, MACD, moving averages, pivots
- Check earnings, IPO, split, buyback and economic calendars
- Track hedge fund, blogger and politician activity
- Analyze ETFs, their holdings and exposures
- Review your portfolio holdings, performance and allocation
Tools 71
list_my_portfoliosRead-onlyList the portfolios you authorized this connector to access.
get_portfolio_holdingsRead-onlyReturn all holdings for one of your portfolios, with cost basis and key ratios.
get_portfolio_overviewRead-onlyReturn lifetime, 1mo, 6mo, 12mo and YTD returns, Sharpe ratio and monthly history.
get_portfolio_analysisRead-onlyReturn allocation by type, country, sector, market cap, yield, beta and P/E.
get_portfolio_performanceRead-onlyReturn performance stats, best trade, recent activity and daily yield versus the S&P 500.
get_assets_dataRead-onlyReturn key TipRanks stock data for one or more tickers.
get_assets_eventsRead-onlyReturn upcoming dividend and earnings events for tickers.
get_assets_newsRead-onlyReturn recent news headlines for tickers with sentiment tags and source URLs.
get_latest_newsRead-onlyReturn the latest TipRanks editorial news with text excerpts.
get_articleRead-onlyFetch the full text of a TipRanks article by URL, slug or post id.
get_assets_warningsRead-onlyReturn risk warnings for tickers.
get_trending_stocksRead-onlyReturn trending stocks that recently received analyst ratings.
Show 59 more tools
get_company_kpisRead-onlyReturn company operational KPIs such as segment revenue and margins.
get_market_moversRead-onlyReturn today's top gainers, losers and most active stocks.
get_top_rated_stocksRead-onlyReturn stocks most recommended by the best-performing analysts.
get_top_smart_score_stocksRead-onlyReturn stocks with the highest TipRanks Smart Score.
get_economic_calendarRead-onlyReturn upcoming and recent economic events such as Fed meetings, CPI and GDP.
get_peersRead-onlyReturn peer companies for a stock with comparative metrics.
get_politiciansRead-onlyList politicians tracked for trading activity.
get_politician_activityRead-onlyReturn a specific politician's stock trades or holdings.
get_earnings_calendarRead-onlyReturn upcoming earnings dates across stocks for a date range.
get_ticker_earningsRead-onlyReturn upcoming and recent earnings dates for one stock.
get_ipo_calendarRead-onlyReturn upcoming and recent IPOs.
get_clinical_trialsRead-onlyReturn the FDA and clinical-trial calendar with related tickers.
get_stock_splitsRead-onlyReturn upcoming and recent stock splits with ratios and direction.
get_buybacksRead-onlyReturn share buyback activity across the market or for one ticker.
get_bulls_bears_summaryRead-onlyReturn bull and bear key points for stocks.
get_investor_sentimentRead-onlyReturn crowd and retail investor sentiment for a stock.
get_blogger_sentimentRead-onlyReturn financial-blogger consensus for a stock with underlying articles.
get_top_hedge_fund_managersRead-onlyReturn top hedge fund managers ranked by success rate and returns.
get_hedge_fund_activityRead-onlyReturn per-fund holdings and recent transactions for a ticker.
get_best_performing_expertsRead-onlyReturn top analysts, insiders, hedge funds, bloggers or firms by success rate.
get_technical_analysisRead-onlyReturn RSI, MACD, stochastics, ADX, moving averages and pivots for stocks and ETFs.
get_etf_analysisRead-onlyReturn analyst consensus for ETFs based on weighted holdings' ratings.
get_etf_forecastRead-onlyReturn analyst forecast, price target and upside for an ETF.
get_etf_top_stocksRead-onlyReturn top holdings of an ETF with their analyst ratings.
get_etf_exposuresRead-onlyList ETFs that hold a given stock, largest holding first.
get_etf_screenerRead-onlyFilter ETFs by asset class, category and focus.
get_commodity_quoteRead-onlyReturn a real-time price quote for one commodity.
get_all_commodities_quotesRead-onlyReturn real-time quotes for all commodities in one request.
get_commodity_historicalRead-onlyGet commodity historical OHLCV
get_forex_quoteRead-onlyGet forex quote
get_all_forex_quotesRead-onlyGet forex market overview
get_forex_historicalRead-onlyGet forex historical OHLCV
get_index_quoteRead-onlyGet index quote
get_index_historicalRead-onlyGet index historical OHLCV
get_crypto_quoteRead-onlyGet crypto quote
get_all_crypto_quotesRead-onlyGet crypto market overview
get_crypto_historicalRead-onlyGet crypto historical OHLCV
get_crypto_newsRead-onlyGet crypto news
get_sector_analysisRead-onlyGet sector-level analysis
get_market_performanceRead-onlyGet country market performance
get_earnings_historyRead-onlyGet earnings history
get_financialsRead-onlyGet financial statements
get_earnings_call_summaryRead-onlyGet earnings call summary
get_ai_stock_analysisRead-onlyGet AI Stock Analysis scores
get_dividend_historyRead-onlyGet dividend history
get_stock_quotesRead-onlyGet real-time stock quotes
get_stock_pricesRead-onlyGet historical stock price series
get_stock_catalystRead-onlyGet AI catalyst summary for stocks
get_market_commentaryRead-onlyGet cached market commentary
get_insider_transactionsRead-onlyGet insider transactions
get_hedge_fund_holdingsRead-onlyGet hedge fund holdings history
get_etf_holdingsRead-onlyGet ETF constituents and weights
get_analysts_by_firmRead-onlyList analysts by firm
get_recent_analyst_ratingsRead-onlyGet recent analyst ratings
get_options_expirationsRead-onlyList option expirations
get_options_chainRead-onlyGet option chain
get_options_contractRead-onlyGet option contract snapshot
get_options_unusual_tradesRead-onlyGet unusual option trades
get_my_usageRead-onlyGet my MCP usage
Read from the live server on 17 Nov 2026. Read-only, Writes and Can delete are hints the server declares; your client decides whether to ask before running a tool.
Example prompts
Give me the full picture on NVDA: consensus, price target and Smart Score.
Which stocks have a Smart Score of 10 in the healthcare sector?
Show technical analysis for SPY and QQQ on the daily timeframe.
How is my TipRanks portfolio performing compared with the S&P 500?
Set up
Every client connects to mcp.tipranks.com, and TipRanks asks you to sign in the first time. Pick yours; the page remembers your choice.
Claude Code
- Run this in a terminal, in your project folder:
claude mcp add --transport http tipranks https://mcp.tipranks.com/mcp/- Start Claude Code, type
/mcp, pick tipranks and choose Authenticate. A browser window opens for the TipRanks sign-in.
Add --scope user to make it available in every project, not just this one.
Claude Desktop
- Open Customize → Connectors, click + Add, then Add custom connector.
- Name it TipRanks and paste this URL:
https://mcp.tipranks.com/mcp/- Click Add, then Connect, and sign in when TipRanks asks.
Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.
claude.ai
- Open the connector form on claude.ai. This button fills in the name and URL for you:
Add to claude.ai (opens in a new tab)
- Check that the URL reads
https://mcp.tipranks.com/mcp/and click Add. - Click Connect and sign in when TipRanks asks.
Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.
ChatGPT
- On chatgpt.com, go to Plugins, select +, then Add custom MCP server.
- Enter a name for the server.
- Under Connection, paste
https://mcp.tipranks.com/mcp/as the server URL, then for authentication choose OAuth. ChatGPT sends you to TipRanks to sign in. - Check I understand and want to continue, then select Create as a plugin.
Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).
Cursor
Add to Cursor (opens in a new tab)
Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):
{
"mcpServers": {
"tipranks": {
"url": "https://mcp.tipranks.com/mcp/"
}
}
}Cursor shows Needs authentication next to the server. Click the button beside it to sign in.
VS Code
Install in VS Code (opens in a new tab)
Or from a terminal:
code --add-mcp '{"name":"tipranks","type":"http","url":"https://mcp.tipranks.com/mcp/"}'Or commit it to the repo in .vscode/mcp.json:
{
"servers": {
"tipranks": {
"type": "http",
"url": "https://mcp.tipranks.com/mcp/"
}
}
}VS Code asks you to sign in the first time the server starts.
Devin Desktop
- Add it to
~/.config/devin/mcp_config.json(macOS and Linux) or%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"tipranks": {
"serverUrl": "https://mcp.tipranks.com/mcp/"
}
}
}- Refresh the MCP server list in Cascade and sign in when asked.
Devin Desktop is the new name for Windsurf. It reads serverUrl (or url) for remote servers.
Codex
codex mcp add tipranks --url https://mcp.tipranks.com/mcp/
codex mcp login tipranksOr edit ~/.codex/config.toml directly:
[mcp_servers.tipranks]
url = "https://mcp.tipranks.com/mcp/"Gemini CLI
gemini mcp add --transport http tipranks https://mcp.tipranks.com/mcp/Then, inside Gemini CLI, run /mcp auth tipranks to sign in.
This adds it to the current project. Add -s user to use it everywhere.
Any client
Most clients accept this shape. Some name the URL field differently: serverUrl in Devin Desktop, httpUrl in Gemini CLI’s settings file.
{
"mcpServers": {
"tipranks": {
"type": "http",
"url": "https://mcp.tipranks.com/mcp/"
}
}
}Zed puts servers under context_servers in its settings. Cline needs "type": "streamableHttp", or it assumes SSE.
Client only starts local servers? Bridge it with npx -y mcp-remote https://mcp.tipranks.com/mcp/.
Embed
Show TipRanks in a README or on your site. Each embed links to this page, uses the server’s own URL, and sets no cookies. How embeds work
The card, the iframe and the JSON are in English. Add ?lang=it, fr, de or es to their address for another language.
README badge
[](https://mcp.tc/i/tipranks)<a href="https://mcp.tc/i/tipranks"><img src="https://mcp.tc/i/tipranks/badge.svg" alt="TipRanks on mcp.tc" height="20"></a>It follows the reader’s light or dark mode. Add ?theme=light or ?theme=dark to fix it, or ?style=compact to show the mark without the word.
Website card
<script src="https://mcp.tc/w/tipranks.js" async></script>The card appears where the tag is. Add data-theme="dark" or data-size="compact" to the tag to change it. The file holds everything it needs, so it makes no other requests and sets no cookies.
iframe
<iframe src="https://mcp.tc/embed/tipranks" title="TipRanks on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Use it on pages that don’t allow scripts. Add ?theme=light or ?theme=dark to the address to fix the colors.
JSON
The listing as data for your own pages and tools: name, tagline, the server’s own URL, tools and the “Add to” links. Any site can read it (CORS is open).
https://mcp.tc/i/tipranks.jsonAI prompt
Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the TipRanks card to your site.
Add the mcp.tc card for TipRanks, an MCP server, to my website. It is one static script: no build step, no package to install, no cookies.
Put this tag where the card should appear. The card renders right before it:
```html
<script src="https://mcp.tc/w/tipranks.js" async></script>
```
To show the card somewhere else, put this placeholder there and load the same script once, for example before `</body>`. Keep the link inside: visitors without JavaScript see it.
```html
<div data-mcptc="tipranks"><a href="https://mcp.tc/i/tipranks">TipRanks on mcp.tc</a></div>
```
Options:
- `data-theme="light"` or `"dark"` on the tag or the placeholder fixes the colors. Without it, the card follows the visitor’s light or dark mode.
- `data-size="compact"` gives a smaller card without the tagline.
- The CSS variable `--mcptc-max-width` on the placeholder or a parent sets the width (default `520px`).
- `?lang=` on the script URL sets the card’s language: `en`, `it`, `fr`, `de` or `es`.
If the site has a Content Security Policy, allow `script-src https://mcp.tc` and `img-src data:` (the icon is inline).
For a README or other Markdown docs, use the badge instead:
```markdown
[](https://mcp.tc/i/tipranks)
```
Reference: https://mcp.tc/embedChange history
We read this server’s tool list every 3 hours and record what changes. Last read 18 Nov 2026, 05:33 UTC.
-
5 tools changed.
Details, 26 Oct 2026, 14:45 UTC
Changed 5
get_etf_screenerdescription and input schemaBeforeFilters ETFs by asset class, category, and focus. Args: assetClass: Alternatives, AssetAllocation, Commodities, Currency, Equity,
FixedIncomecategory:BroadMarket,Sector,HighDividendYield, SizeAndStyle, Corporate, etc.focus: LargeCap,SmallCap, MidCap, TotalMarket, Financials, HealthCare,InformationTechnology,Energy, RealEstate, HighDividendYield, HighYield, etc.Use this for a sector question ('tech ETFs' -> InformationTechnology); the screener has no `sector` filter. limit: Rows to return (default 20, max 100). Returns: `count` (all ETFs matching the filters) and `data` rows: ticker, name, price, smartScore, analystConsensus, priceTarget, upsidePct, dividendYieldPct, expenseRatioPct, aum, currency, assetClass, segment, category, focus, index, brand, holdingsCount, isCurrencyHedged and isUcitsCompliant (true/false), andisLeveraged/isInverse/isActivelyManaged when true.AfterFilters ETFs by asset class, category, and focus. Args: assetClass: Alternatives, AssetAllocation, Commodities, Currency, Equity, FixedIncome. Its parameter description lists the category and focus values each class answers. category: e.g. SizeAndStyle (Equity's broad-market funds), Sector, CorporateBroadBased. focus: e.g. TotalMarket, LargeCap, InformationTechnology, HighYield. Use this for a sector question ('tech ETFs' -> InformationTechnology); the screener has no `sector` filter. For a factor or region fund (momentum, growth, emerging markets), look up the ETFs you know for it by ticker with get_assets_data. limit: Rows to return (default 20, max 100). Returns: `count` (all ETFs matching the filters) and `data` rows: ticker, name, price, smartScore, analystConsensus, priceTarget, upsidePct, dividendYieldPct, expenseRatioPct, aum, currency, assetClass, segment, category, focus, index, brand, holdingsCount, isCurrencyHedged and isUcitsCompliant (true/false), and isLeveraged/isInver…
- Description of
assetClassBeforeAsset class
filter, e.g. 'Equity', 'FixedIncome', 'Commodities'AfterAsset class filter. Each class with the category and focus values it answers, spelled exactly as listed (a category or focus taken from another assetClass matches no ETF): Equity: category SizeAndSty…
- Description of
categoryBeforeCategory filter, e.g. 'Sector',
'BroadMarket', 'HighDividendYield'AfterCategory filter, e.g. 'SizeAndStyle', 'Sector', 'CorporateBroadBased' (the values per assetClass are listed under assetClass)
- Description of
get_recent_analyst_ratingsdescription and input schemaBeforeRecent Wall Street analyst rating actions on a single stock, covering the trailing 12 months (newest first). `ratings` holds one row per analyst, their latest rating, newest first. Each row carries the analyst's
nameand firm, the rating (Buy/Hold/Sell), the action (initiated/upgraded/downgraded/reiterated/ maintained), the pricetarget,and the analyst's TipRanks credibility (numOfStars 0-5, rank, successRate as a fraction, excessReturn as the average return) plus the source article title/quote.`counts` gives exact last30Days / last90Days / last12Months totals (analysts whose latest rating fallsin thewindow, split buy/hold/sell) over every rating fetched, as of `asOf`; answer 'how many analysts rated X inthepast month' from `counts`, sincealong list may show only itsnewestrows. Fortheaggregate consensus and average/best price target, use get_assets_data instead. Args: ticker: Stock ticker (e.g. 'NVDA', 'AAPL'). Returns: {ticker, asOf, totalRatings, counts, ratings}. recomm…AfterRecent Wall Street analyst rating actions on a single stock, covering the trailing 12 months (newest first). `ratings` holds one row per analyst, their latest rating, newest first. Each row carries the analyst's name, expertUID and firm, the rating (Buy/Hold/Sell), the action (initiated/upgraded/downgraded/reiterated/ maintained), recommendationDate and timestamp, the price target in its own currency (priceTarget, priceTargetCurrencyCode) and converted (convertedPriceTarget, convertedPriceTargetCurrencyCode), and the analyst's TipRanks credibility (numOfStars 0-5, rank, successRate as a fraction, excessReturn as the average return) plus the source article title/quote. The response is size-bounded, so a long list comes in pages: when rows are left out the result carries `nextOffset`; call again with that offset for the next page, until a result has no `nextOffset`. `totalRatings` is the full count. The source returns at most the 100 newest ratings; when it hit that limit the result car…
- New parameters:
offset
- New parameters:
get_stock_catalystdescriptionBeforeTipRanks-generated catalyst summary explaining why a stock is moving. Each entry: {ticker, summary, sentiment, updated} where sentiment is 'positive' | 'neutral' |
'negative'. Updated throughoutthetrading day.Use to explain today's move for a specific stock. Args: tickers: Comma-separated tickers (e.g. 'AMZN' or 'AMZN,NVDA').AfterTipRanks-generated catalyst summary explaining why a stock is moving. Each entry: {ticker, price_move, summary, sentiment, updated} where sentiment is 'positive' | 'neutral' | 'negative' and price_move, present once today's session has traded, is the stock's actual change today from the live quote. Use to explain today's move for a specific stock. Args: tickers: Comma-separated tickers (e.g. 'AMZN' or 'AMZN,NVDA').
get_top_rated_stocksdescription and input schemaBeforeReturns stocks most recommended by the best-performing analysts (by analyst track
record).Args: num: Number of results sector: Sector filter (financial, healthcare, technology, etc.) or empty for all country: 'US', 'Canada', 'UK','Global'.NOTE: UK tickers use GB: prefix but country param is 'UK'.AfterReturns stocks most recommended by the best-performing analysts (by analyst track record) in one market. Args: num: Number of results sector: Sector filter (financial, healthcare, technology, etc.) or empty for all country: 'US', 'Canada', 'UK', 'Germany', 'France', 'Spain', 'Italy', 'Netherlands', 'Switzerland', 'Australia', 'Singapore', 'Japan', 'Israel'; any other country returns no_match. NOTE: UK tickers use GB: prefix but country param is 'UK'.
- Description of
sectorBeforeLowercase sectorfilter: financial, healthcare, consumerdefensive, consumercyclical,utilities, materials, technology, industrials, energy, communicationservices, realestate(default: allsectors)AfterSector filter: technology, financial, healthcare, energy, utilities, industrials, materials, consumerdefensive, consumercyclical, services (default: all sectors). This feed files oil & gas under its…
- Description of
countryBefore'US', 'Canada', 'UK',or'Global'(default:US). UK tickersarereturnedwith a'GB:' prefix but the country value is still 'UK'.After'US','Canada','UK','Germany','France','Spain','Italy','Netherlands','Switzerland','Australia','Singapore','Japan', or 'Israel' (default: US); these are the only markets with a list, each list covers…
- Description of
get_top_smart_score_stocksdescription and input schemaBeforeReturns stocks with the highest TipRanks Smart Score (perfect 10 /
Outperform).Args: num: Number ofresultssector:Sector filter (financial, healthcare, technology, etc.)or empty for all country: 'US', 'Canada', 'UK', 'Germany', 'Spain','France', 'India', 'Italy', 'Israel','Australia', 'Singapore','Japan','HongKong','Global'.NOTE: UK tickers use GB: prefix but the country param is 'UK'.AfterReturns up to 10 stocks with the highest TipRanks Smart Score (perfect 10 / Outperform) in one market. Args: num: Number of results; the feed returns at most 10 whatever this asks sector: Keeps the rows of that top-10 list in this sector, or empty for all country: 'US', 'Canada', 'UK', 'Germany', 'Spain', 'Australia', 'Singapore', 'HongKong', 'Global'; any other country returns no_match. NOTE: UK tickers use GB: prefix but the country param is 'UK'.
- Description of
sectorBeforeLowercase sector filter:financial, healthcare, consumerdefensive, consumercyclical, utilities,materials,technology, industrials, energy,communicationservices, realestate (default: all sectors)AfterKeeps only the rows of the market's top-10 list in this sector: financial, healthcare, consumerdefensive, consumercyclical, utilities, basicmaterials, technology, industrials, energy, communicationse…
- Description of
countryBefore'US','Canada','UK','Germany','Spain','France','India','Italy','Israel','Australia','Singapore','Japan','HongKong',or 'Global' (default:US).UK tickers arereturned with a 'GB:' prefix but the count…After'US','Canada','UK','Germany','Spain','Australia','Singapore','HongKong', or 'Global' (default: US); these are the only markets with a list, and any other country returns no_match. UK tickers are retu…
- Description of
-
1 tool changed.
Details, 25 Oct 2026, 14:46 UTC
Changed 1
get_market_performancedescriptionBeforeReturns market-wide performance for a specific country: average returns, sector breakdown, top/bottom performers. Args: country:
Countrycode: 'us', 'ca','gb','de', 'il', 'au', 'hk', 'sg', etc.AfterReturns market-wide performance for a specific country: average returns, sector breakdown, top/bottom performers. Args: country: Market code: 'us', 'ca', 'uk', 'de', 'il', 'au', 'hk', 'sg', etc.
-
3 tools changed.
Details, 21 Oct 2026, 10:42 UTC
Changed 3
get_earnings_calendardescriptionBeforeReturns upcoming earnings dates across all stocks for a date range. Args: fromDate: Start date YYYY-MM-DD (default: today) toDate: End date YYYY-MM-DD
(default: 14 days from now)exchange: Optional exchange filter, e.g. 'US' for US-only resultsAfterReturns upcoming earnings dates across all stocks for a date range. Serves at most 15 days per call (fromDate through fromDate+14); a longer range is shortened, and the result's fromDate/toDate give the window actually served. For a longer period, call again starting the day after toDate. Args: fromDate: Start date YYYY-MM-DD (default: today) toDate: End date YYYY-MM-DD (default and maximum: fromDate+14) exchange: Optional exchange filter, e.g. 'US' for US-only results
get_etf_screenerdescriptionBeforeFilters ETFs by asset class, category, and focus. Args: assetClass: Alternatives, AssetAllocation, Commodities, Currency, Equity, FixedIncome category: BroadMarket, Sector, HighDividendYield, SizeAndStyle, Corporate, etc. focus: LargeCap, SmallCap, MidCap, TotalMarket, Financials, HealthCare, InformationTechnology, Energy, RealEstate, HighDividendYield, HighYield, etc. Use this for a sector question ('tech ETFs' -> InformationTechnology); the screener has no `sector` filter. limit: Rows to return (default 20, max 100).
AfterFilters ETFs by asset class, category, and focus. Args: assetClass: Alternatives, AssetAllocation, Commodities, Currency, Equity, FixedIncome category: BroadMarket, Sector, HighDividendYield, SizeAndStyle, Corporate, etc. focus: LargeCap, SmallCap, MidCap, TotalMarket, Financials, HealthCare, InformationTechnology, Energy, RealEstate, HighDividendYield, HighYield, etc. Use this for a sector question ('tech ETFs' -> InformationTechnology); the screener has no `sector` filter. limit: Rows to return (default 20, max 100). Returns: `count` (all ETFs matching the filters) and `data` rows: ticker, name, price, smartScore, analystConsensus, priceTarget, upsidePct, dividendYieldPct, expenseRatioPct, aum, currency, assetClass, segment, category, focus, index, brand, holdingsCount, isCurrencyHedged and isUcitsCompliant (true/false), and isLeveraged/isInverse/isActivelyManaged when true.
get_recent_analyst_ratingsdescriptionBeforeRecent Wall Street analyst rating actions on a single stock, covering the trailing 12 months (newest first). Each row carries the analyst's name and firm, the rating (Buy/Hold/Sell), the action
(initiated/upgraded/downgraded/reiterated/maintained),the price target, and the analyst's TipRanks credibility (numOfStars 0-5, rank,success rate,average return) plus the source article title/quote. For the aggregate consensus and average/best price target, use get_assets_data instead. Args: ticker: Stock ticker (e.g. 'NVDA', 'AAPL'). Returns:a list of rating actions. recommendationDate is a 'MM/DD/YYYY' string; numOfStars is the analyst's 0-5 TipRanks star rating.AfterRecent Wall Street analyst rating actions on a single stock, covering the trailing 12 months (newest first). `ratings` holds one row per analyst, their latest rating, newest first. Each row carries the analyst's name and firm, the rating (Buy/Hold/Sell), the action (initiated/upgraded/downgraded/reiterated/ maintained), the price target, and the analyst's TipRanks credibility (numOfStars 0-5, rank, successRate as a fraction, excessReturn as the average return) plus the source article title/quote. `counts` gives exact last30Days / last90Days / last12Months totals (analysts whose latest rating falls in the window, split buy/hold/sell) over every rating fetched, as of `asOf`; answer 'how many analysts rated X in the past month' from `counts`, since a long list may show only its newest rows. For the aggregate consensus and average/best price target, use get_assets_data instead. Args: ticker: Stock ticker (e.g. 'NVDA', 'AAPL'). Returns: {ticker, asOf, totalRatings, counts, ratings}. recomm…
-
1 tool changed.
Details, 20 Oct 2026, 07:39 UTC
Changed 1
get_economic_calendardescriptionBeforeReturns upcoming and recent economic events (Fed meetings, jobs reports, CPI, GDP). Defaults to US events at High/Medium impact only because the raw feed includes hundreds of low-impact items from every country. Args: daysBack: Days to look back (default 0) daysForward: Days to look forward (default 7) fromDate: Start date ISO format (alternative to daysBack) toDate: End date ISO format (alternative to daysForward) countries: Comma-separated country names to keep (default 'US'). Pass an empty string to disable the country filter. Common values: 'US','UK','Germany','Japan','China','Canada','France'. impact:
Comma-separated impact levels to keep (default 'High,Medium'). Valid values: 'High','Medium','Low'. Pass empty to keep all levels. limit: Max events returned after filtering (default 50, max 200). Returns: { totalMatched, returned, filters, economicCalendar: [...] }.AfterReturns upcoming and recent economic events (Fed meetings, jobs reports, CPI, GDP). Defaults to US events at High/Medium impact only because the raw feed includes hundreds of low-impact items from every country. For what data was released (how the jobs report or CPI came in), set daysBack to 35; the result keeps the latest actual of each High-impact release (payrolls, CPI, ISM), then the events nearest today. A row with a numeric actual and estimate carries vsEstimate {diff, label: above|below|in line}, actual minus estimate; the label gives direction only, so judge good or bad yourself. Args: daysBack: Days to look back (default 0) daysForward: Days to look forward (default 7) fromDate: Start date ISO format (alternative to daysBack) toDate: End date ISO format (alternative to daysForward) countries: Comma-separated country names to keep (default 'US'). Pass an empty string to disable the country filter. Common values: 'US','UK','Germany','Japan','China','Canada','France'. impact: Co…
-
4 tools changed.
Details, 19 Oct 2026, 10:41 UTC
Changed 4
get_etf_holdingsinput schema- Description of
sort_byBeforeOptional
prices fieldto sortby descending (e.g. 'prices.5d.gain', 'prices.twoWeeks.gain', 'prices.month.gain');when set, returns top performers instead of the full list.AfterOptional period to sort by, descending: '5d', 'month', 'ytd' or 'year'; when set, returns top performers instead of the full list.
- Description of
get_options_chaindescriptionBeforeContracts at one expiration, enriched with price + OI + volume. Each row: ticker (OCC), contract_type, strike, name, price, volume, open_interest, open_interest_change, change_percent, day_open / high / low, last_trade_date. Quotes are typically delayed ~15 minutes.
Greeksand implied volatility areNOT exposed bythisdata source — do not fabricate them.Args: ticker: Underlying (e.g. 'AAPL'). expiration_date: One of the dates from get_options_expirations (YYYY-MM-DD). contract_type: '' for both, or 'call' or 'put'. strike_gte: Filter strikes >= this value (optional).strike_lte: Filter strikes <= this value (optional). limit: Max contracts to return (default 50).AfterContracts at one expiration, enriched with price + OI + volume. Each row: ticker (OCC), contract_type, strike, name, price, volume, open_interest, open_interest_change, change_percent, day_open / high / low, last_trade_date. Quotes are typically delayed ~15 minutes. GREEKS AND IV: the results carry price, open interest and volume; delta/gamma/theta/vega and implied volatility are not part of this data. When the user asks for greeks, IV or a '30-delta call' style query, fetch the chain first (get_options_expirations, then this tool), present the matching strikes with price, open interest and volume, and state plainly that greeks and IV are unavailable. Report only values that appear in the results, and leave delta and IV unestimated, including rules of thumb. Args: ticker: Underlying (e.g. 'AAPL'). expiration_date: One of the dates from get_options_expirations (YYYY-MM-DD). contract_type: '' for both, or 'call' or 'put'. strike_gte: Filter strikes >= this value (optional). strike_lte:…
get_options_contractdescriptionBeforeSnapshot one OCC contract — price, OI, intraday OHLCV, last trade. The contract_ticker is an OCC-format symbol like 'O:AAPL260520C00205000' (O: + underlying + YYMMDD + C/P + strike-in-thousandths-8-digits). The 'O:' prefix is optional. Quotes are typically delayed ~15 minutes.
Greeksand implied volatility are notavailable fromthisdata source.Args: contract_ticker: OCC contract symbol.AfterSnapshot one OCC contract — price, OI, intraday OHLCV, last trade. The contract_ticker is an OCC-format symbol like 'O:AAPL260520C00205000' (O: + underlying + YYMMDD + C/P + strike-in-thousandths-8-digits). The 'O:' prefix is optional. Quotes are typically delayed ~15 minutes. GREEKS AND IV: the results carry price, OI, OI change, volume, day OHLC and last_trade_date; delta/gamma/theta/vega, implied volatility and bid/ask are not part of this data. When the user asks for them, call this tool, present what it returns, and state plainly that those fields are unavailable. Report only values that appear in the results, and leave greeks and IV unestimated, including rules of thumb. Args: contract_ticker: OCC contract symbol.
get_options_expirationsdescriptionBeforeList future expiration dates for a ticker's listed options. Excludes past expirations. Use the result as input to get_options_chain. Args: ticker: Underlying ticker (e.g. 'AAPL').
AfterList future expiration dates for a ticker's listed options. Excludes past expirations. Use the result as input to get_options_chain. Also use it FIRST when the user asks for greeks, IV or delta on a ticker's options: the chain it leads to is the data we can present. Args: ticker: Underlying ticker (e.g. 'AAPL').
-
Tracking started: 71 tools.
FAQ
Can I paste mcp.tc/i/tipranks into my MCP client?
No. mcp.tc links are pages, not server addresses. Connect with https://mcp.tipranks.com/mcp/, so your client talks to TipRanks directly. The sign-in token only works there anyway. The quick link is for sharing: it opens this page, with setup steps for every client.
Does TipRanks need an API key or a sign-in?
Yes, you need a TipRanks account. The first time your client connects, it opens TipRanks’s sign-in page. The token goes straight to the server’s own URL, never through mcp.tc.
Is TipRanks a remote or a local server?
Remote. TipRanks hosts it at https://mcp.tipranks.com/mcp/, and it speaks Streamable HTTP. There’s nothing to install.
What can TipRanks do?
It has 71 tools, including list_my_portfolios, get_portfolio_holdings and get_portfolio_overview. You can get analyst ratings, price targets and key data for tickers, rank top-rated and top Smart Score stocks and read ticker and market news with sentiment tags.
Which clients can use it?
Any client that supports remote MCP servers: Claude Code, Claude Desktop, claude.ai, ChatGPT, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. The setup steps cover each one.
Does mcp.tc track changes to TipRanks?
Yes. TipRanks’s History tab shows each change we find to its tools, down to descriptions and parameters, plus new versions and edits by its owner. Follow the listing to get an email when it changes.
Who wrote this page?
mcp.tc’s robot read TipRanks’s own metadata (its MCP handshake, tool list and public pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.
mcp.tc isn’t affiliated with TipRanks. This page was built from TipRanks’s public metadata, last checked on 17 Nov 2026, and an AI model wrote the description, so it can be wrong. Names and marks belong to their owners. Something off? Report this listing.