Skip to content
Back to search
100
MCP live MCP 2026-07-28 streamable-http

TipRanks

com.tipranks/tipranks

Live TipRanks market data: analyst ratings, Smart Score, technicals, options, portfolios.

Uptime
100.0%
1 direct probes · 30d
Response
170ms
last probe
Tools
71
callable
Resources
0
readable
Prompts
0
available

Tools · 71

list_my_portfolios

List 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…

get_portfolio_holdings

Returns 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 h…

get_portfolio_overview

Returns 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 dire…

get_portfolio_analysis

Returns 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_portf…

get_portfolio_performance

Returns 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 colum…

get_assets_data

Returns 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 a…

get_assets_events

Returns 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-…

get_assets_news

Returns 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…

get_latest_news

Latest 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 spe…

get_article

Fetch 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 t…

get_assets_warnings

Returns risk warnings for tickers. Args: tickers: Comma-separated ticker symbols Returns: warning type, date, and detail fields per ticker.

get_trending_stocks

Returns currently trending stocks that recently received analyst ratings. Args: num: Number of results (default 20) filter: exactly one of 'analysts', 'bloggers', 'both'. Anything…

get_company_kpis

Returns 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 …

get_market_movers

Returns today's market movers: biggest gainers, losers, most active. Args: category: 1=DollarVolume, 2=PercentGainers, 3=PercentLosers, 4=GainersRegular, 5=LosersRegular…

get_top_rated_stocks

Returns stocks most recommended by the best-performing analysts (by analyst track record). Args: num: Number of results sector: Sector filter (financial, healthcare, technology, e…

get_top_smart_score_stocks

Returns stocks with the highest TipRanks Smart Score (perfect 10 / Outperform). Args: num: Number of results sector: Sector filter (financial, healthcare, technology, etc.) or emp…

get_economic_calendar

Returns 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…

get_peers

Peer/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, …

get_politicians

Returns the list of politicians tracked for trading activity. Returns: name, party, state, position, net worth, profile.

get_politician_activity

Returns a specific politician's stock trades or holdings. First call get_politicians to find the politicianId. Args: politicianId: Politician ID from get_politicians activity…

get_earnings_calendar

Returns 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) …

get_ticker_earnings

Upcoming 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 re…

get_ipo_calendar

Returns upcoming and recent IPOs. Args: fromDate: Start date ISO format (default: today) toDate: End date ISO format (default: 30 days from now)

get_clinical_trials

Returns 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 ascendi…

get_stock_splits

Returns the stock-split calendar with split ratios and direction (Forward / Reverse). Use for upcoming splits, reverse-split alerts, historical split lookup. Args: fromDate: Start…

get_buybacks

Returns 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 firs…

get_bulls_bears_summary

Returns 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 …

get_investor_sentiment

Returns crowd / retail investor sentiment for a stock. Args: ticker: Stock ticker (e.g. 'NVDA') Returns JSON with these top-level keys: - investorStatsOverview: stats aggregate…

get_blogger_sentiment

Returns 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 (TipRa…

get_top_hedge_fund_managers

Returns 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 anyt…

get_hedge_fund_activity

Returns 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 T…

get_best_performing_experts

Returns the best-performing experts ranked by TipRanks success rate and average return. Args: expert_type: One of: analyst, insider, hedgeFund, blogger, firm (default: analyst) nu…

get_technical_analysis

Returns RSI, MACD, Stochastics, ADX, moving averages, and pivot points for individual stocks. Stocks only — ETFs like SPY, QQQ, VTI are not supported here. For ETFs, use get_etf_analysis,…

get_etf_analysis

Returns analyst consensus for ETFs based on weighted average of holdings' ratings. Args: tickers: Comma-separated ETF tickers (e.g. 'QQQ,SPY,VTI')

get_etf_forecast

Returns the analyst forecast for a specific ETF: consensus, price target, upside. Args: ticker: ETF ticker (e.g. 'QQQ')

get_etf_top_stocks

Returns the top stock holdings within an ETF along with their analyst ratings. Args: ticker: ETF ticker (e.g. 'QQQ')

get_etf_exposures

Returns 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 (defaul…

get_etf_screener

Filters ETFs by asset class, category, and focus. Args: assetClass: Alternatives, AssetAllocation, Commodities, Currency, Equity, FixedIncome category: BroadMarket, Sector, HighDi…

get_commodity_quote

Returns 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). Args: …

get_all_commodities_quotes

Returns 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, …

get_commodity_historical

Daily 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, d…

get_forex_quote

Returns the real-time exchange rate quote for a forex pair. Common pairs: EURUSD, GBPUSD, USDJPY, USDCHF, AUDUSD, USDCAD. Args: symbol: Forex pair symbol (e.g. 'EURUSD')

get_all_forex_quotes

Real-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…

get_forex_historical

Daily 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, …

get_index_quote

Returns the real-time quote for a major market index. Index symbols: ^GSPC (S&P 500), ^IXIC (Nasdaq), ^DJI (Dow Jones), ^GSPTSE (TSX), ^FTSE (FTSE 100), ^N225 (Nikkei), ^AORD (All Ords), …

get_index_historical

Daily 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 — {…

get_crypto_quote

Returns the real-time price quote for a specific cryptocurrency. Common symbols: BTCUSD (Bitcoin), ETHUSD (Ethereum), SOLUSD (Solana), BNBUSD (BNB), XRPUSD (XRP), ADAUSD (Cardano), DOGEUSD (D…

get_all_crypto_quotes

Real-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…

get_crypto_historical

Daily 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 — {symb…

get_crypto_news

Latest 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 effect…

get_sector_analysis

Returns sector-level analysis for all 11 US sectors: average P/E, analyst upside, buy ratio, stock count. Sorted by average analyst upside.

get_market_performance

Returns market-wide performance for a specific country: average returns, sector breakdown, top/bottom performers. Args: country: Country code: 'us', 'ca', 'gb', 'de', 'il', 'au', 'hk'…

get_earnings_history

Quarterly 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_reven…

get_financials

Financial 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), …

get_earnings_call_summary

Returns 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 highli…

get_ai_stock_analysis

TipRanks 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. E…

get_dividend_history

Dividend 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,…

get_stock_quotes

Real-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 …

get_stock_prices

Historical 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, …

get_stock_catalyst

TipRanks-generated catalyst summary explaining why a stock is moving. Each entry: {ticker, summary, sentiment, updated} where sentiment is 'positive' | 'neutral' | 'negative'. Updated through…

get_market_commentary

Cached equities market sentiment snapshot. Returns {overallSentiment, atmosphere, keyThemes, tailwinds, headwinds}. Generated by TipRanks' AI pipeline with web search, refreshed every ~4 …

get_insider_transactions

Individual 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/…

get_hedge_fund_holdings

Hedge-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}…

get_etf_holdings

List 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',…

get_analysts_by_firm

List 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 (…

get_recent_analyst_ratings

Recent 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 …

get_options_expirations

List 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'). …

get_options_chain

Contracts 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_op…

get_options_contract

Snapshot 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-thousan…

get_options_unusual_trades

Recent 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…

get_my_usage

Your 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). Hand…

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "tipranks": {
      "url": "https://mcp.tipranks.com/mcp/",
      "transport": "streamable-http"
    }
  }
}