Model Context Protocol (MCP) server for freee API integration
Nothing to run from here
TipRanks is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
96/100
tool-list score
71
tools declared
remote
at its publisher
—
calls last 7d
What it does
Live TipRanks market data: analyst ratings, Smart Score, technicals, options, portfolios.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http tipranks-mcp https://mcp.tipranks.com/mcp/
# 2 — ask your agent for something these tools do
# list_my_portfolios, get_portfolio_holdings, get_portfolio_overview and 68 more
TipRanks costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
TIAll 1 server
tipranks1 server
1 category
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http tipranks-mcp https://mcp.tipranks.com/mcp/Reconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
71 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
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 renamed portfolios since, re-authorize to refresh.
No parameter schema on file.
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 high/low, percentage of portfolio, beta, EPS. Plus total value, cash, stock count. Args: portfolio_id: One of the IDs returned by list_my_portfolios.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| portfolio_id | integer | yes | — |
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 direct plotting. Args: portfolio_id: One of the IDs returned by list_my_portfolios.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| portfolio_id | integer | yes | — |
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_portfolios.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| portfolio_id | integer | yes | — |
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 columns, plot directly as overlaid lines), monthly returns, risk profile, beta, dividend yield/amount. Args: portfolio_id: One of the IDs returned by list_my_portfolios.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| portfolio_id | integer | yes | — |
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 are accepted. Returns JSON {"assetsData": [...one compact entry per ticker...]}. This is a headline summary tuned to stay small enough for a whole portfolio to fit in a single response. Fi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — |
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-03-01") to_date: Optional end date (ISO format, e.g. "2026-06-01") Returns: dividend dates, earnings dates, and coupon dates per ticker.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — | |
| from_date | string | no | — |
| to_date | string | no | — |
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 a specific ticker, or for an article excerpt, use get_latest_news. This tool serves the CURRENT news window only: it returns each ticker's most recent articles, and from_date just trims
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — | |
| count | integer | no | — |
| from_date | string | no | Optional recency floor 'YYYY-MM-DD', applied to the recent articles this tool returns. It cannot pull older news into range — for a past date window use get_latest_news with from_date + to_date. |
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 specific stock with a short summary of each story, or to browse a news category. This is also the tool for news from a specific PAST date range — pass from_date AND to_date together; the arch
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | no | — | |
| category | string | no | Optional single category: 'news', 'the-fly', 'blurbs', 'catalyst', 'ratings', 'cryptocurrencies', 'insider-trading', 'newswire', 'private-companies', 'company-announcements'. Omitted = editorial/wire |
| from_date | string | no | — |
| limit | integer | no | — |
| to_date | string | no | Optional 'YYYY-MM-DD' upper bound on the publish date, inclusive of that whole day. Pair with from_date to read a specific past window; from_date on its own returns the newest stories since that date. |
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 text (HTML-stripped, capped at 8000 chars), author, category, date, canonical URL, and any tagged tickers. Args: identifier: Numeric post id, slug, or a tipranks.com article URL.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| identifier | string | yes | A TipRanks article identifier: the numeric post id, the slug, or a full tipranks.com article URL. |
Returns risk warnings for tickers. Args: tickers: Comma-separated ticker symbols Returns: warning type, date, and detail fields per ticker.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — |
Returns 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 back: 3, 7, or any number from 30 up. Every other value (1, 2
| Parameter | Type | Required | Notes |
|---|---|---|---|
| num | integer | no | — |
| filter | string | no | Exactly one of 'analysts', 'bloggers' or 'both' (default: analysts). Any other value is rejected rather than answered. |
| daysAgo | integer | no | Days to look back: 3, 7, or any number from 30 up — anything else (1, 2, 14…) is rejected. Default 7. Use 30 or more when filtering by sector or country, as narrow windows often return very few stocks |
| trendingType | string | no | Exactly 'best-rated' or 'worst-rated'; omit for all (default). Any other value is rejected rather than silently returning the unranked list. |
| country | string | no | Country name, e.g. 'US','Canada','UK','Germany','Israel','Australia' (default: US) |
| sector | string | no | Sector filter: energy, financial, general, healthcare, industrials, services, technology or utilities. Omit for all sectors; a sector outside this list is refused rather than answered. Rows for sector |
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 this returns the most recent count periods per metric by default — pass count=0 for the full history, or group to fetch a single group. Args: ticker: Stock ticker (e.g. 'AAPL'
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| count | integer | no | — |
| group | string | no | Optional single KPI group by slug or title (e.g. 'revenue_geography', 'Revenue by Segment'). Omit for all groups. |
Returns 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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | integer | yes | 1=DollarVolume, 2=PercentGainers (ext hours), 3=PercentLosers (ext hours), 4=GainersRegular, 5=LosersRegular, 6=UnusualVolume |
| country | integer | no | 1=US, 2=Canada, 3=UK (default: 1) |
| num | integer | no | — |
Returns 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'.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| num | integer | no | — |
| sector | string | no | Lowercase sector filter: financial, healthcare, consumerdefensive, consumercyclical, utilities, materials, technology, industrials, energy, communicationservices, realestate (default: all sectors) |
| country | string | no | 'US', 'Canada', 'UK', or 'Global' (default: US). UK tickers are returned with a 'GB:' prefix but the country value is still 'UK'. |
Returns stocks with the highest TipRanks Smart Score (perfect 10 / Outperform). Args: num: Number of results sector: 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'. N
| Parameter | Type | Required | Notes |
|---|---|---|---|
| num | integer | no | — |
| sector | string | no | Lowercase sector filter: financial, healthcare, consumerdefensive, consumercyclical, utilities, materials, technology, industrials, energy, communicationservices, realestate (default: all sectors) |
| country | string | no | 'US','Canada','UK','Germany','Spain','France','India','Italy','Israel','Australia','Singapore','Japan','HongKong', or 'Global' (default: US). UK tickers are returned with a 'GB:' prefix but the countr |
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 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),
| Parameter | Type | Required | Notes |
|---|---|---|---|
| daysBack | integer | no | — |
| daysForward | integer | no | — |
| fromDate | string | no | — |
| toDate | string | no | — |
| countries | string | no | Comma-separated country names to keep (default 'US'); pass '' to keep all. Examples: 'US','UK','Germany','Japan','China'. |
| impact | string | no | Comma-separated impact levels to keep: High, Medium, Low (default 'High,Medium'); pass '' to keep all. |
| limit | integer | no | — |
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, same-sector peers). For that company's own data use get_assets_data; for a sector-wide breakdown use get_sector_analysis.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol, e.g. 'AAPL'. |
Returns the list of politicians tracked for trading activity. Returns: name, party, state, position, net worth, profile.
No parameter schema on file.
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: 'trades' or 'holdings'
| Parameter | Type | Required | Notes |
|---|---|---|---|
| politicianId | integer | yes | Politician ID, as returned by get_politicians. |
| activity | string | no | 'trades' or 'holdings' (default: trades) |
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) exchange: Optional exchange filter, e.g. 'US' for US-only results
| Parameter | Type | Required | Notes |
|---|---|---|---|
| fromDate | string | no | — |
| toDate | string | no | — |
| exchange | string | no | — |
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 reports. For past actual-vs-estimate results use get_earnings_history; for a cross-market schedule use get_earnings_calendar.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol, e.g. 'NVDA'. |
Returns upcoming and recent IPOs. Args: fromDate: Start date ISO format (default: today) toDate: End date ISO format (default: 30 days from now)
| Parameter | Type | Required | Notes |
|---|---|---|---|
| fromDate | string | no | — |
| toDate | string | no | — |
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 ascending. Use for upcoming FDA decisions, PDUFA dates, biotech catalysts. Returns: { data: [{ targetDate, clinicalTrials: [{ drugName, ticker }] }], count, window }.
No parameter schema on file.
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 date YYYY-MM-DD (default: 30 days ago) toDate: End date YYYY-MM-DD (default: 30 days from now) type: Optional filter — 'Forward' or 'Reverse' (case-insensitive). Empty s
| Parameter | Type | Required | Notes |
|---|---|---|---|
| fromDate | string | no | — |
| toDate | string | no | — |
| type | string | no | Optional filter: 'Forward' or 'Reverse' (case-insensitive); omit to return both. |
| limit | integer | no | — |
| ticker | string | no | Optional. Return only this company's splits within the window, e.g. 'NVDA'. Pair with a wide fromDate for 'has X ever split'. |
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 first). Use for 'biggest buybacks', 'top repurchase companies'. A single company may appear multiple times for different fiscal quarters. - PER-TICKER (ticker provided): historical quarter
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | Optional. If provided, returns the per-ticker historical buyback series; if omitted, returns the cross-market list. |
| limit | integer | no | — |
| page | integer | no | — |
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 tickers (e.g. 'AAPL,TSLA') Returns JSON: {"data": [...one entry per ticker...]}. Each entry has: - ticker, updatedOn - bullish: list of bullish point sentences - bearish: list o
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — |
Returns 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 portfolios on the platform. * portfoliosHoldingStock: how many of th
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
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 (TipRanks crowd positioning). Args: ticker: Stock ticker (e.g. 'AAPL') limit: Max blogger articles to return (default 20, max 50) Returns JSON: {ticker, company, consensus, article
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| limit | integer | no | — |
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 anything higher)
| Parameter | Type | Required | Notes |
|---|---|---|---|
| num | integer | no | — |
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 TipRanks rank/stars. Complements get_hedge_fund_holdings (the aggregate share-count timeseries). Args: ticker: Stock ticker (e.g. 'AAPL') limit: Max funds to return (default 2
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| limit | integer | no | — |
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) num: Number of results (default: 10, max: 25)
| Parameter | Type | Required | Notes |
|---|---|---|---|
| expert_type | string | no | One of: analyst, insider, hedgeFund, blogger, firm (default: analyst) |
| num | integer | no | — |
Returns 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_forecast, get_etf_top_stocks, or get_etf_exposures. Args: tickers: Comma-separated sto
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — | |
| timeFrame | string | no | One of '1m','5m','15m','30m','1h','5h','day','3d','week','2w','month' (default: 'day'). Request '5h' for one ticker per call. |
Returns analyst consensus for ETFs based on weighted average of holdings' ratings. Args: tickers: Comma-separated ETF tickers (e.g. 'QQQ,SPY,VTI')
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — |
Returns the analyst forecast for a specific ETF: consensus, price target, upside. Args: ticker: ETF ticker (e.g. 'QQQ')
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
Returns the top stock holdings within an ETF along with their analyst ratings. Args: ticker: ETF ticker (e.g. 'QQQ')
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
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 (default 1) page_size: Results per page (default 20, max 100) Returns per ETF: etfTicker, etfCompanyName, etfCategory, aum, expenseRatio, holdingWeight (% of ETF in this stock), holdingMarke
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| page | integer | no | — |
| page_size | integer | no | — |
Filters 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,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| assetClass | string | no | Asset class filter, e.g. 'Equity', 'FixedIncome', 'Commodities' |
| category | string | no | Category filter, e.g. 'Sector', 'BroadMarket', 'HighDividendYield' |
| focus | string | no | Focus filter, e.g. 'LargeCap', 'InformationTechnology', 'HighYield'. This is the screener's SECTOR filter — there is no separate sector parameter. |
| limit | integer | no | Rows to return (default: 20, max: 100). |
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). 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 change, a dated extreme or an exact 52-week
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Commodity symbol, e.g. 'GCUSD' (gold), 'CLUSD' (crude oil). |
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, change and volume. Use the name given in the response — several symbols are non-mnemonic (HEUSX is Lean Hogs, SBUSX is Sugar, ZSUSX is Soybeans).
No parameter schema on file.
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, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, ordered for direct plotting as a price history. A range too long to return day by day is aggregated into coar
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Commodity symbol, e.g. 'GCUSD' (gold). |
| from_date | string | no | — |
| to_date | string | no | — |
Returns 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 change, a dated extreme or an exact 52-week figure use get_forex_historical, since the quote does not
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Forex pair, uppercase with no slash, e.g. 'EURUSD', 'GBPUSD', 'USDJPY'. |
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 most prominent limit of them (majors first, then by volume), and the response states how many were left out. Pass symbols for specific pairs, or call get_forex_quote for a single one.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbols | string | no | Optional comma-separated pairs to return instead of the ranked slice, e.g. 'EURUSD,USDJPY'. Slash and dash forms are accepted. |
| limit | integer | no | How many ranked pairs to return (default 40, max 75). Ignored when symbols is given. |
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, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, ordered for direct plotting as an exchange-rate history. A range too long to return day by day is aggregated
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Forex pair, uppercase with no slash, e.g. 'EURUSD'. |
| from_date | string | no | — |
| to_date | string | no | — |
Returns 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), ^N225 (Nikkei), ^AXJO (ASX 200), ^AORD (All Ords), ^HSI (Hang Seng), ^STI (STI), ^BSESN (Sensex),
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Index symbol, e.g. '^GSPC' for the S&P 500. |
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 — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, ordered for direct plotting as an index history. A range too long to return day by day is aggregated
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Index symbol, e.g. '^GSPC' for the S&P 500. |
| from_date | string | yes | — |
| to_date | string | no | — |
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 (Dogecoin). 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 change, a dated extrem
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Crypto symbol, e.g. 'BTCUSD' (Bitcoin), 'ETHUSD' (Ethereum). |
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 of them ordered by market capitalisation, largest first, and the response states how many were left out. Pass symbols for specific coins, or call get_crypto_quote for a single one. Re
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbols | string | no | Optional comma-separated coins to return instead of the ranked slice, e.g. 'BTCUSD,ETHUSD'. Bare tickers like 'BTC' resolve to the USD pair. |
| limit | integer | no | How many ranked coins to return (default 40, max 75). Ignored when symbols is given. |
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 — {symbol, date, open, high, low, close, volume, change, changePercent, vwap} — newest first, ordered for direct plotting as a price history. A range too long to return day by day is aggregated into
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Crypto symbol, e.g. 'BTCUSD' (Bitcoin). |
| from_date | string | no | — |
| to_date | string | no | — |
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 effects. Use for broad crypto/market headlines. For news about a specific holding use get_assets_news; for the general (non-crypto) editorial feed use get_latest_news.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | 0-indexed page of recent articles (0 = most recent); increase to page further back in time. |
Returns sector-level analysis for all 11 US sectors: average P/E, analyst upside, buy ratio, stock count. Sorted by average analyst upside.
No parameter schema on file.
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', 'sg', etc.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| country | string | no | — |
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_revenue, estimate_revenue, revenue_surprise_pct, net_income, ...}, ordered oldest-first so a bar chart of actual vs. estimate EPS, or a YoY trend line, plots directly. Also returns next_qu
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| quarters | integer | no | — |
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), the balance sheet (total assets, total debt, total equity, net debt, cash + short-term investments), the cash flow statement (operating cash flow, free cash flow, capex, dividends paid,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| period | string | no | 'annual' (default), 'quarterly', or 'ttm' |
| count | integer | no | — |
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 highlights and lowlights from the call as {title, content} bullets. This is a structured summary derived from the call, not the raw transcript text. Useful for "what did management say about X
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
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. Every model returns its own 0-100 score, rating (outperform / neutral / underperform), price target, and a weighted factor breakdown across financial performance, technical analysis, valuat
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | Comma-separated tickers (e.g. 'AAPL' or 'AAPL,MSFT,NVDA'), up to 25 | |
| provider | no | Optional single AI provider to report on. Map what the user said to the provider: Claude is Anthropic, ChatGPT/GPT is OpenAI, Grok is xAI, Sonar is PerPlexity. Omit for the headline score that matches | |
| detail | string | no | 'consensus' (default) returns each model's score and factor breakdown; 'full' adds each model's written reasoning. Ignored on multi-ticker calls. |
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, pay_date, amount, yield_pct, is_special, ...}] (newest first, capped at count) and an annual_totals list [{year, amount, yield_pct}] suitable for a yearly bar chart. All yields are emi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| count | integer | no | — |
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 flags (is_market_open / is_premarket / is_after_market). When extended-hours data is present, the entry includes a pre_post_market block — when the regular session is closed, that's the
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — |
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, trading_days. Series is downsampled to ~250 evenly-spaced points (latest point always retained) so the payload stays small for charting. period must be one of: 1m, 3m, 6m, ytd, 1y, 2y, 3
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — | |
| period | string | no | — |
TipRanks-generated catalyst summary explaining why a stock is moving. Each entry: {ticker, summary, sentiment, updated} where sentiment is 'positive' | 'neutral' | 'negative'. Updated throughout the trading day. Use to explain today's move for a specific stock. Args: tickers: Comma-separated tickers (e.g. 'AMZN' or 'AMZN,NVDA').
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tickers | yes | — |
Cached 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 cache exists, returns {"status": "unavailable"}. The content is AI-generated commentary, not auth
No parameter schema on file.
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/Award/Other Acquisition"), side (buy/sell), shares, price (approximate — value / shares; the source has no exact price), value, date, filing_link (the SEC Form-4 URL), and insider_stars.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| limit | integer | no | — |
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}. Sourced from quarterly 13F filings; lags by up to 45 days. For a snapshot of current sentiment without the timeseries, use get_assets_data and read hedgeFundSentimentData. Args:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| limit | integer | no | — |
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', 'month', 'ytd', 'year') and a limit > 0 to get the top N constituents by that period's return. Each row carries weight_pct, current_price, return_pct for the chosen period, and analyst_
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| sort_by | string | no | Optional period to sort by, descending: '5d', 'month', 'ytd' or 'year'; when set, returns top performers instead of the full list. |
| limit | integer | no | — |
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 (keeping the best rank) and sorted by rank ascending. When sector is provided, the per-analyst coverage list is filtered to tickers in that sector and the row shape becomes {name, firm,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| firm | string | yes | — |
| sector | string | no | — |
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 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 arti
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
List 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').
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
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_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 volat
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| expiration_date | string | yes | Exact expiration in YYYY-MM-DD. REQUIRED — call get_options_expirations first to discover valid dates. |
| contract_type | string | no | 'call' or 'put'; omit to return both sides. |
| strike_gte | no | — | |
| strike_lte | no | — | |
| limit | integer | no | — |
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-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; de
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contract_ticker | string | yes | OCC-format option ticker, e.g. 'O:AAPL260520C00205000'. The 'O:' prefix is optional. |
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 large bullish or bearish positioning. Args: ticker: Underlying ticker (e.g. 'AAPL'). limit: Max trades to return (default 25).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | — |
| limit | integer | no | — |
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). Handy to check before running a large batch of calls. This call is free — it never counts against the quota. What counts: every tool call is metered once whether or not it returns data, so an
No parameter schema on file.
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install TipRanks or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
ATool-list grade · score 96 / 100
Release 1.2.0 · scanned 20 Oct 2026
Graded from the tools this server lists, not from its source code.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
Threat score100
Client score96
Findings0 threat · 0 capability
Capabilityminimal
Coveragemanifest
Verificationnot in this report
Surface digestaabae7b8897c5abac2b804ce5115414208658cdf38a5454993a74f8273c01c38
Score vectorthreat 100 → client 96
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | minimal | capability blast radius (minimal) — client exposure if the model is manipulated | −0 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
Tool surfaceread
Implementation sourcenot available
Package metadatanot available
Live transportnot available
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. minimal is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| list_my_portfolios | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_portfolio_holdings | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_portfolio_overview | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_portfolio_analysis | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_portfolio_performance | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_assets_data | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_assets_events | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_assets_news | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_latest_news | untrusted-input | untrusted-input: keyword "browse", declares openWorldHint: true (interacts with entities outside the server) |
| get_article | untrusted-input | untrusted-input: keyword "fetch", declares openWorldHint: true (interacts with entities outside the server) |
| get_assets_warnings | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_trending_stocks | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_company_kpis | untrusted-input | untrusted-input: keyword "fetch", declares openWorldHint: true (interacts with entities outside the server) |
| get_market_movers | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_top_rated_stocks | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_top_smart_score_stocks | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_economic_calendar | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_peers | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_politicians | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_politician_activity | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_earnings_calendar | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_ticker_earnings | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_ipo_calendar | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_clinical_trials | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_stock_splits | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_buybacks | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_bulls_bears_summary | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_investor_sentiment | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_blogger_sentiment | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_top_hedge_fund_managers | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_hedge_fund_activity | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_best_performing_experts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_technical_analysis | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_etf_analysis | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_etf_forecast | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_etf_top_stocks | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_etf_exposures | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_etf_screener | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_commodity_quote | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_all_commodities_quotes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_commodity_historical | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_forex_quote | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_all_forex_quotes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_forex_historical | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_index_quote | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_index_historical | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_crypto_quote | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_all_crypto_quotes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_crypto_historical | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_crypto_news | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_sector_analysis | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_market_performance | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_earnings_history | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_financials | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_earnings_call_summary | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_ai_stock_analysis | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_dividend_history | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_stock_quotes | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_stock_prices | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_stock_catalyst | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_market_commentary | untrusted-input | untrusted-input: keyword "web_search", declares openWorldHint: true (interacts with entities outside the server) |
| get_insider_transactions | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_hedge_fund_holdings | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_etf_holdings | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_analysts_by_firm | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_recent_analyst_ratings | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_options_expirations | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_options_chain | untrusted-input | untrusted-input: keyword "fetch", declares openWorldHint: true (interacts with entities outside the server) |
| get_options_contract | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_options_unusual_trades | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_my_usage | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
Integrityfirst-seen
Surface digestaabae7b8897c5aba
Scanned2026-10-20
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.2.0.
1.2.0
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish TipRanks can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.