Live TipRanks market data: analyst ratings, Smart Score, technicals, options, portfolios.
Connect Remote server
claude mcp add --transport http tipranks https://mcp.tipranks.com/mcp/{
"mcpServers": {
"tipranks": {
"url": "https://mcp.tipranks.com/mcp/"
}
}
}{
"servers": {
"tipranks": {
"type": "http",
"url": "https://mcp.tipranks.com/mcp/"
}
}
}Settings > Connectors > Add custom connector
URL: https://mcp.tipranks.com/mcp/Tools 71 found in our last check
list_my_portfoliosList the portfolios you authorized this connector to access. Returns the portfolios that were on your TipRanks account at the time you signed in, each with its id and name. If you've added or renamed portfolios since, re-authorize to refresh.
get_portfolio_holdingsReturns all holdings for one of your TipRanks portfolios. Per holding: ticker, shares, price, cost basis (AvgExecutionPrice), P/E ratio, dividend yield, market cap, sector, country, 52-week high/low, percentage of portfolio, beta, EPS. Plus total value, cash, stock count. Args:…
get_portfolio_overviewReturns lifetime / 1mo / 6mo / 12mo / YTD returns, Sharpe ratio, and a monthly-return time series. The monthly history field is chart-ready — a list of {month, return} points suitable for direct plotting. Args: portfolio_id: One of the IDs returned by list_my_portfolios.
get_portfolio_analysisReturns asset allocation by type/country/top stocks and distribution by sector, market cap, dividend yield, beta, and P/E. Args: portfolio_id: One of the IDs returned by list_my_portfolios.
get_portfolio_performanceReturns full performance: stats, gains, best trade, recent activity, a daily-yield time series benchmarked against S&P 500 (chart-ready — aligned dates with portfolio and benchmark yield columns, plot directly as overlaid lines), monthly returns, risk profile, beta, dividend yie…
get_assets_dataReturns key TipRanks stock data for one or more tickers. Args: tickers: Ticker symbols — a comma-separated string ("AAPL,MSFT,C") or a JSON array (["AAPL","MSFT","C"]). Both are accepted. Returns JSON {"assetsData": [...one compact entry per ticker...]}. This is a headline summa…
get_assets_eventsReturns upcoming dividend and earnings events for tickers. Args: tickers: Comma-separated ticker symbols (e.g. "AAPL,MSFT") from_date: Optional start date (ISO format, e.g. "2026-03-01") to_date: Optional end date (ISO format, e.g. "2026-06-01") Returns: dividend dates, earnings…
get_assets_newsReturns recent news articles for tickers, aggregated from many news sites, each with a sentiment tag and source URL (headlines only — no article body). For general/market TipRanks news without a specific ticker, or for an article excerpt, use get_latest_news. This tool serves th…
get_latest_newsLatest TipRanks news articles (newest first) from TipRanks's own editorial/wire feed — each with a text excerpt, unlike get_assets_news. Use for general market news (no ticker), news on a specific stock with a short summary of each story, or to browse a news category. This is al…
get_articleFetch the full text of a single TipRanks article. Resolve a TipRanks article URL (e.g. from get_latest_news / get_assets_news), a slug, or a numeric post id to its title, excerpt, full body text (HTML-stripped, capped at 8000 chars), author, category, date, canonical URL, and an…
get_assets_warningsReturns risk warnings for tickers. Args: tickers: Comma-separated ticker symbols Returns: warning type, date, and detail fields per ticker.
get_trending_stocksReturns currently trending stocks that recently received analyst ratings. Args: num: Number of results (default 20) filter: exactly one of 'analysts', 'bloggers', 'both'. Anything else is refused — the feed would otherwise answer it with the 'both' list. daysAgo: Days to look ba…
get_company_kpisReturns company-specific operational KPIs: segment revenue, geographic breakdown, active users/devices, gross margins by type, opex breakdown. Full history runs back to 2014 and is large, so this returns the most recent `count` periods per metric by default — pass count=0 for th…
get_market_moversReturns today's market movers: biggest gainers, losers, most active. Args: category: 1=DollarVolume, 2=PercentGainers, 3=PercentLosers, 4=GainersRegular, 5=LosersRegular, 6=UnusualVolume country: 1=US, 2=Canada, 3=UK num: Number of results
get_top_rated_stocksReturns 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', 'It…
get_top_smart_score_stocksReturns 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'…
get_economic_calendarReturns 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), se…
get_peersPeer/competitor companies for a stock, with comparative metrics for side-by-side analysis. Read-only, no side effects. Use to find and compare a company against similar names (competitors, same-sector peers). For that company's own data use get_assets_data; for a sector-wide bre…
get_politiciansReturns the list of politicians tracked for trading activity. Returns: name, party, state, position, net worth, profile.
get_politician_activityReturns a specific politician's stock trades or holdings. First call get_politicians to find the politicianId. Args: politicianId: Politician ID from get_politicians activity: 'trades' or 'holdings'
get_earnings_calendarReturns 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 aft…
get_ticker_earningsUpcoming and recent earnings dates for a specific stock — scheduled report dates with EPS/revenue estimates where available. Read-only, no side effects. Use this to find when a company reports. For past actual-vs-estimate results use get_earnings_history; for a cross-market sche…
get_ipo_calendarReturns upcoming and recent IPOs. Args: fromDate: Start date ISO format (default: today) toDate: End date ISO format (default: 30 days from now)
get_clinical_trialsReturns the FDA / clinical-trial calendar — upcoming drug approval target dates and the tickers behind each drug. Window is fixed at today − 14 days to today + 60 days, sorted by date ascending. Use for upcoming FDA decisions, PDUFA dates, biotech catalysts. Returns: { data: [{…
get_stock_splitsReturns the stock-split calendar with split ratios and direction (Forward / Reverse). Use for upcoming splits, reverse-split alerts, historical split lookup. Args: fromDate: Start date YYYY-MM-DD (default: 30 days ago) toDate: End date YYYY-MM-DD (default: 30 days from now) type…
get_buybacksReturns share-buyback / stock-repurchase activity in one of two modes: - CROSS-MARKET (no ticker): latest reported buybacks across all companies, sorted by dollar amount spent (largest first). Use for 'biggest buybacks', 'top repurchase companies'. A single company may appear mu…
get_bulls_bears_summaryReturns the discrete bull and bear key points for stocks — the individual sentence bullets TipRanks shows on its stock pages, each tagged with a topic. Args: tickers: Comma-separated tickers (e.g. 'AAPL,TSLA') Returns JSON: {"data": [...one entry per ticker...]}. Each entry has:…
get_investor_sentimentReturns crowd / retail investor sentiment for a stock. Args: ticker: Stock ticker (e.g. 'NVDA') Returns JSON with these top-level keys: - investorStatsOverview: stats aggregated across ALL TipRanks portfolios that hold the ticker. Fields: * numberOfPortfolios: total active portf…
get_blogger_sentimentReturns the financial-blogger consensus for a stock plus the underlying blogger articles. Distinct from get_recent_analyst_ratings (Wall Street analysts) and get_investor_sentiment (TipRanks crowd positioning). Args: ticker: Stock ticker (e.g. 'AAPL') limit: Max blogger articles…
get_top_hedge_fund_managersReturns top-performing hedge fund managers ranked by success rate and returns. Args: num: Number of managers to return (default 10, max 100 — the upstream returns 100 for anything higher)
get_hedge_fund_activityReturns per-fund hedge-fund holdings and recent transactions for a ticker — which institutions hold it, how much each changed (bought/sold), the holding value, % of portfolio, and the fund's TipRanks rank/stars. Complements get_hedge_fund_holdings (the aggregate share-count time…
get_best_performing_expertsReturns the best-performing experts ranked by TipRanks success rate and average return. Args: expert_type: One of: analyst, insider, hedgeFund, blogger, firm (default: analyst) num: Number of results (default: 10, max: 25)
get_technical_analysisReturns RSI, MACD, Stochastics, ADX, moving averages, and pivot points for stocks and ETFs. Covers stocks and ETFs alike (e.g. 'NVDA', 'SPY', 'QQQ', 'VTI') with the same payload shape. For an ETF's analyst consensus, forecast, holdings or exposures, use get_etf_analysis, get_etf…
get_etf_analysisReturns analyst consensus for ETFs based on weighted average of holdings' ratings. Args: tickers: Comma-separated ETF tickers (e.g. 'QQQ,SPY,VTI')
get_etf_forecastReturns the analyst forecast for a specific ETF: consensus, price target, upside. Args: ticker: ETF ticker (e.g. 'QQQ')
get_etf_top_stocksReturns the top stock holdings within an ETF along with their analyst ratings. Args: ticker: ETF ticker (e.g. 'QQQ')
get_etf_exposuresReturns the list of ETFs that hold a specific stock, sorted by holding market value (largest first). Args: ticker: Stock ticker (e.g. 'MSFT', 'AAPL') page: Page number (default 1) page_size: Results per page (default 20, max 100) Returns per ETF: etfTicker, etfCompanyName, etfCa…
get_etf_screenerFilters 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 fun…
get_commodity_quoteReturns the real-time price quote for a specific commodity. Common symbols: GCUSD (gold), SIUSD (silver), CLUSD (crude oil), NGUSD (natural gas), HGUSD (copper), PLUSD (platinum). yearHigh / yearLow are the feed's trailing-year range, roughly the past 12-13 months: call them tra…
get_all_commodities_quotesReturns real-time quotes for all commodities in a single request. Each row carries the commodity's display name and a changePercentage derived from price and change, alongside the raw price, change and volume. Use the name given in the response — several symbols are non-mnemonic…
get_commodity_historicalDaily OHLC price history for a commodity, covering the whole date range you ask for. Chart-ready: while the range fits in one response, each row is the price feed's own daily row — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, ordere…
get_forex_quoteReturns the real-time exchange rate quote for a forex pair. Common pairs: EURUSD, GBPUSD, USDJPY, USDCHF, AUDUSD, USDCAD. yearHigh / yearLow are the feed's trailing-year range, roughly the past 12-13 months: call them trailing-year figures. For a year-to-date or calendar-year ch…
get_all_forex_quotesReal-time forex quotes: the most-traded pairs, each with a display name. The feed carries 1,550 pairs in alphabetical order, which is far more than one response can hold — so this returns the most prominent `limit` of them (majors first, then by volume), and the response states…
get_forex_historicalDaily OHLC price history for a forex pair, covering the whole date range you ask for. Chart-ready: while the range fits in one response, each row is the price feed's own daily row — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, order…
get_index_quoteReturns the real-time quote for a major market index. Index symbols: ^GSPC (S&P 500), ^NDX (Nasdaq 100), ^IXIC (Nasdaq Composite), ^DJI (Dow Jones), ^RUT (Russell 2000), ^GSPTSE (TSX), ^FTSE (FTSE 100), ^GDAXI (DAX 40), ^FCHI (CAC 40), ^STOXX50E (Euro STOXX 50), ^IBEX (IBEX 35),…
get_index_historicalDaily OHLC price history for a major market index, covering the whole date range you ask for. Chart-ready: while the range fits in one response, each row is the price feed's own daily row — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest firs…
get_crypto_quoteReturns the real-time price quote for a specific cryptocurrency. Common symbols: BTCUSD (Bitcoin), ETHUSD (Ethereum), SOLUSD (Solana), BNBUSD (BNB), XRPUSD (XRP), ADAUSD (Cardano), DOGEUSD (Dogecoin). yearHigh / yearLow are the feed's trailing-year range, roughly the past 12-13…
get_all_crypto_quotesReal-time crypto quotes: the largest coins, each with a display name. The feed carries 4,771 coins in alphabetical order, which is far more than one response can hold — so this returns `limit` of them ordered by market capitalisation, largest first, and the response states how m…
get_crypto_historicalDaily OHLC price history for a cryptocurrency, covering the whole date range you ask for. Chart-ready: while the range fits in one response, each row is the price feed's own daily row — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, o…
get_crypto_newsLatest cryptocurrency news — a market-wide feed across all coins (not filtered to a single asset), ordered newest-first: article headlines, snippets, and source URLs. Read-only, no side effects. Use for broad crypto/market headlines. For news about a specific holding use get_ass…
get_sector_analysisReturns sector-level analysis for all 11 US sectors: average P/E, analyst upside, buy ratio, stock count. Sorted by average analyst upside.
get_market_performanceReturns 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.
get_earnings_historyQuarterly earnings time series for a ticker. Chart-ready: each quarter row is {period, report_date, actual_eps, estimate_eps, eps_surprise_pct, prior_year_eps, eps_yoy_change_pct, actual_revenue, estimate_revenue, revenue_surprise_pct, net_income, ...}, ordered oldest-first so a…
get_financialsFinancial statements time series for a ticker, chart-ready. Each period is a flat ~25-field object spanning the income statement (revenue, gross / operating / EBITDA / net margins, EPS, R&D), the balance sheet (total assets, total debt, total equity, net debt, cash + short-term…
get_earnings_call_summaryReturns the most recent earnings call summary for a ticker — management guidance text, overall call sentiment (positive / neutral / negative with a one-line rationale), and AI-extracted highlights and lowlights from the call as {title, content} bullets. This is a structured summ…
get_ai_stock_analysisTipRanks AI Stock Analysis — the 0-100 AI score for one or more stocks. Six frontier models (OpenAI, Anthropic, Gemini, xAI, DeepSeek, Perplexity) research each covered stock independently. Every model returns its own 0-100 score, rating (outperform / neutral / underperform), pr…
get_dividend_historyDividend payment history for a ticker. Chart-ready: includes the current snapshot (yield %, payout ratio, frequency, annualised payout) plus two time series — a per-payment list [{ex_date, pay_date, amount, yield_pct, is_special, ...}] (newest first, capped at `count`) and an an…
get_stock_quotesReal-time price quote for one or more stocks or ETFs. Returns price, intraday OHLC, day change (amount + percent), volume, previous close, market cap, currency, exchange, and market-state flags (is_market_open / is_premarket / is_after_market). When extended-hours data is presen…
get_stock_pricesHistorical daily closing prices for up to 5 stocks or ETFs. Per ticker: {ticker, period, series:[{date, price}], summary} with summary fields first_price, last_price, change_pct, high, low, trading_days. Series is downsampled to ~250 evenly-spaced points (latest point always ret…
get_stock_catalystTipRanks-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…
get_market_commentaryCached equities market sentiment snapshot. Returns {overallSentiment, atmosphere, keyThemes, tailwinds, headwinds}. Generated by TipRanks' AI pipeline with web search, refreshed every ~4 hours; this endpoint reads the cache only and does not trigger regeneration. If no recent ca…
get_insider_transactionsIndividual corporate-insider (officers/directors, Form 4) transactions for a ticker, newest first. Each row: insider_name, role, is_officer, is_director, action (e.g. "Auto Sell", "Grant/Award/Other Acquisition"), side (buy/sell), shares, price (approximate — value / shares; the…
get_hedge_fund_holdingsHedge-fund share-count history for a ticker. Returns the most recent `limit` snapshots (max 60) plus a summary block (snapshot_count, first/last date and shares). Each row: {date, shares}. Sourced from quarterly 13F filings; lags by up to 45 days. For a snapshot of current senti…
get_etf_holdingsList the constituents of an ETF. Base mode (default): returns every holding with its weight % in the index — {ticker, name, weight_pct}. Top-performers mode: pass `sort_by` (one of '5d', 'month', 'ytd', 'year') and a `limit` > 0 to get the top N constituents by that period's ret…
get_analysts_by_firmList analysts at a given firm (case-insensitive substring match). Each row: {name, firm, rank, avg_return_1y_pct, covered_tickers_sample, total_covered}. Results are deduped by analyst name (keeping the best rank) and sorted by rank ascending. When `sector` is provided, the per-…
get_recent_analyst_ratingsRecent 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 (i…
get_options_expirationsList 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…
get_options_chainContracts 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 I…
get_options_contractSnapshot 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. G…
get_options_unusual_tradesRecent unusual option trades for an underlying (size/sweep alerts). Returns the most recent `limit` flagged trades with the side, strike, expiry, size, and notional value. Useful for spotting large bullish or bearish positioning. Args: ticker: Underlying ticker (e.g. 'AAPL'). li…
get_my_usageYour current TipRanks MCP usage against the monthly tool-call quota. Reports calls used this calendar month, your limit, how many remain, your plan tier, and when the quota resets (UTC). Handy to check before running a large batch of calls. This call is free — it never counts ag…
Details
| Endpoint | https://mcp.tipranks.com/mcp/ (Streamable HTTP) |
| First published | 21 Jul 2026 |
| Last updated | 21 Jul 2026 |
| Registry name | com.tipranks/tipranks |
More finance and crypto servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.