# TipRanks MCP server > Look up analyst ratings, Smart Scores, news, technicals, ETFs and your TipRanks portfolios from your AI assistant. - Listing: https://mcp.tc/i/tipranks - Connect: use the server's own URL `https://mcp.tipranks.com/mcp/` (OAuth sign-in at the server); clients connect to it directly. The listing link is a page, not an MCP endpoint. - Type: remote (Streamable HTTP) - Auth: OAuth sign-in - Category: [Finance & Payments](https://mcp.tc/c/finance-payments) - Vendor: TipRanks - Homepage: ## About 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 it 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_portfolios`: List the portfolios you authorized this connector to access. (read-only) - `get_portfolio_holdings`: Return all holdings for one of your portfolios, with cost basis and key ratios. (read-only) - `get_portfolio_overview`: Return lifetime, 1mo, 6mo, 12mo and YTD returns, Sharpe ratio and monthly history. (read-only) - `get_portfolio_analysis`: Return allocation by type, country, sector, market cap, yield, beta and P/E. (read-only) - `get_portfolio_performance`: Return performance stats, best trade, recent activity and daily yield versus the S&P 500. (read-only) - `get_assets_data`: Return key TipRanks stock data for one or more tickers. (read-only) - `get_assets_events`: Return upcoming dividend and earnings events for tickers. (read-only) - `get_assets_news`: Return recent news headlines for tickers with sentiment tags and source URLs. (read-only) - `get_latest_news`: Return the latest TipRanks editorial news with text excerpts. (read-only) - `get_article`: Fetch the full text of a TipRanks article by URL, slug or post id. (read-only) - `get_assets_warnings`: Return risk warnings for tickers. (read-only) - `get_trending_stocks`: Return trending stocks that recently received analyst ratings. (read-only) - `get_company_kpis`: Return company operational KPIs such as segment revenue and margins. (read-only) - `get_market_movers`: Return today's top gainers, losers and most active stocks. (read-only) - `get_top_rated_stocks`: Return stocks most recommended by the best-performing analysts. (read-only) - `get_top_smart_score_stocks`: Return stocks with the highest TipRanks Smart Score. (read-only) - `get_economic_calendar`: Return upcoming and recent economic events such as Fed meetings, CPI and GDP. (read-only) - `get_peers`: Return peer companies for a stock with comparative metrics. (read-only) - `get_politicians`: List politicians tracked for trading activity. (read-only) - `get_politician_activity`: Return a specific politician's stock trades or holdings. (read-only) - `get_earnings_calendar`: Return upcoming earnings dates across stocks for a date range. (read-only) - `get_ticker_earnings`: Return upcoming and recent earnings dates for one stock. (read-only) - `get_ipo_calendar`: Return upcoming and recent IPOs. (read-only) - `get_clinical_trials`: Return the FDA and clinical-trial calendar with related tickers. (read-only) - `get_stock_splits`: Return upcoming and recent stock splits with ratios and direction. (read-only) - `get_buybacks`: Return share buyback activity across the market or for one ticker. (read-only) - `get_bulls_bears_summary`: Return bull and bear key points for stocks. (read-only) - `get_investor_sentiment`: Return crowd and retail investor sentiment for a stock. (read-only) - `get_blogger_sentiment`: Return financial-blogger consensus for a stock with underlying articles. (read-only) - `get_top_hedge_fund_managers`: Return top hedge fund managers ranked by success rate and returns. (read-only) - `get_hedge_fund_activity`: Return per-fund holdings and recent transactions for a ticker. (read-only) - `get_best_performing_experts`: Return top analysts, insiders, hedge funds, bloggers or firms by success rate. (read-only) - `get_technical_analysis`: Return RSI, MACD, stochastics, ADX, moving averages and pivots for stocks and ETFs. (read-only) - `get_etf_analysis`: Return analyst consensus for ETFs based on weighted holdings' ratings. (read-only) - `get_etf_forecast`: Return analyst forecast, price target and upside for an ETF. (read-only) - `get_etf_top_stocks`: Return top holdings of an ETF with their analyst ratings. (read-only) - `get_etf_exposures`: List ETFs that hold a given stock, largest holding first. (read-only) - `get_etf_screener`: Filter ETFs by asset class, category and focus. (read-only) - `get_commodity_quote`: Return a real-time price quote for one commodity. (read-only) - `get_all_commodities_quotes`: Return real-time quotes for all commodities in one request. (read-only) - `get_commodity_historical`: Daily OHLC price history for a commodity, covering the whole date range you ask for. (read-only) - `get_forex_quote`: Returns the real-time exchange rate quote for a forex pair. (read-only) - `get_all_forex_quotes`: Real-time forex quotes: the most-traded pairs, each with a display name. (read-only) - `get_forex_historical`: Daily OHLC price history for a forex pair, covering the whole date range you ask for. (read-only) - `get_index_quote`: Returns the real-time quote for a major market index. (read-only) - `get_index_historical`: Daily OHLC price history for a major market index, covering the whole date range you ask for. (read-only) - `get_crypto_quote`: Returns the real-time price quote for a specific cryptocurrency. (read-only) - `get_all_crypto_quotes`: Real-time crypto quotes: the largest coins, each with a display name. (read-only) - `get_crypto_historical`: Daily OHLC price history for a cryptocurrency, covering the whole date range you ask for. (read-only) - `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) - `get_sector_analysis`: Returns sector-level analysis for all 11 US sectors: average P/E, analyst upside, buy ratio, stock count. (read-only) - `get_market_performance`: Returns market-wide performance for a specific country: average returns, sector breakdown, top/bottom performers. (read-only) - `get_earnings_history`: Quarterly earnings time series for a ticker. (read-only) - `get_financials`: Financial statements time series for a ticker, chart-ready. (read-only) - `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 highlights and lowlights from… (read-only) - `get_ai_stock_analysis`: TipRanks AI Stock Analysis — the 0-100 AI score for one or more stocks. (read-only) - `get_dividend_history`: Dividend payment history for a ticker. (read-only) - `get_stock_quotes`: Real-time price quote for one or more stocks or ETFs. (read-only) - `get_stock_prices`: Historical daily closing prices for up to 5 stocks or ETFs. (read-only) - `get_stock_catalyst`: TipRanks-generated catalyst summary explaining why a stock is moving. (read-only) - `get_market_commentary`: Cached equities market sentiment snapshot. (read-only) - `get_insider_transactions`: Individual corporate-insider (officers/directors, Form 4) transactions for a ticker, newest first. (read-only) - `get_hedge_fund_holdings`: Hedge-fund share-count history for a ticker. (read-only) - `get_etf_holdings`: List the constituents of an ETF. (read-only) - `get_analysts_by_firm`: List analysts at a given firm (case-insensitive substring match). (read-only) - `get_recent_analyst_ratings`: Recent Wall Street analyst rating actions on a single stock, covering the trailing 12 months (newest first). (read-only) - `get_options_expirations`: List future expiration dates for a ticker's listed options. (read-only) - `get_options_chain`: Contracts at one expiration, enriched with price + OI + volume. (read-only) - `get_options_contract`: Snapshot one OCC contract — price, OI, intraday OHLCV, last trade. (read-only) - `get_options_unusual_trades`: Recent unusual option trades for an underlying (size/sweep alerts). (read-only) - `get_my_usage`: Your current TipRanks MCP usage against the monthly tool-call quota. (read-only) ## 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?" ## Install ### Claude Code 1. Run this in a terminal, in your project folder: ```bash claude mcp add --transport http tipranks https://mcp.tipranks.com/mcp/ ``` 2. 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 1. Open **Settings → Connectors** and click **Add custom connector**. 2. Name it **TipRanks** and paste this URL: ```url https://mcp.tipranks.com/mcp/ ``` 3. 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 1. Open the connector form on claude.ai. This button fills in the name and URL for you: [Add to claude.ai]() (opens connector settings) 2. Check that the URL reads `https://mcp.tipranks.com/mcp/` and click **Add**. 3. 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 1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**. 2. Go to `chatgpt.com/plugins` and click **+** to create an app for a remote MCP server. 3. Paste `https://mcp.tipranks.com/mcp/` as the server URL and choose **OAuth**. ChatGPT sends you to TipRanks to sign in. Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts. ### Cursor [Add to Cursor]() (opens Cursor) Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project): `mcp.json`: ```json { "mcpServers": { "tipranks": { "url": "https://mcp.tipranks.com/mcp/" } } } ``` Cursor shows **Needs login** next to the server. Click it to sign in. ### VS Code [Install in VS Code]() (opens VS Code) Or from a terminal: ```bash code --add-mcp '{"name":"tipranks","type":"http","url":"https://mcp.tipranks.com/mcp/"}' ``` Or commit it to the repo in `.vscode/mcp.json`: `.vscode/mcp.json`: ```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 1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows): `mcp_config.json`: ```json { "mcpServers": { "tipranks": { "serverUrl": "https://mcp.tipranks.com/mcp/" } } } ``` 2. 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 ```bash codex mcp add tipranks --url https://mcp.tipranks.com/mcp/ codex mcp login tipranks ``` Or edit `~/.codex/config.toml` directly: `config.toml`: ```toml [mcp_servers.tipranks] url = "https://mcp.tipranks.com/mcp/" ``` ### Gemini CLI ```bash 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. ```json { "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/`. ## Details - MCP protocol version: 2026-07-28 - Last checked: 2026-10-03 (reachable) - Listed: 2026-10-03 - Updated: 2026-10-03 --- Source: https://mcp.tc/i/tipranks (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report