TipRanks MCP Server

Live financial data and analyst research for AI agents — over the Model Context Protocol.

Plug Claude, ChatGPT, Cursor, or any MCP-compatible client into live TipRanks data: analyst ratings, Smart Score, price targets, technicals, options, insider and hedge-fund activity, congressional trading, ETFs, commodities, forex, crypto, earnings, news — plus read access to your own TipRanks portfolios.

• Endpoint: https://mcp.tipranks.com/mcp/
• Transport: Streamable HTTP
• Auth: OAuth 2.1 (PKCE + Dynamic Client Registration) or API key
• Official MCP Registry: com.tipranks/tipranks
• Docs: https://mcp.tipranks.com/ · Privacy: https://mcp.tipranks.com/privacy · Terms: https://mcp.tipranks.com/terms

Informational only. TipRanks provides market data and analyst research for informational purposes — not investment, financial, legal, or tax advice. Quotes and other data may be delayed. All tools are read-only; the connector never places trades or modifies your account.

---

Connect

Claude.ai / Claude Desktop / Claude Code

Add a custom connector pointing at https://mcp.tipranks.com/mcp/ and complete the OAuth sign-in with your TipRanks account.

ChatGPT

Available as a ChatGPT app — search the app directory for TipRanks.

Cursor / VS Code / other MCP clients

Add a remote (streamable-HTTP) MCP server with URL https://mcp.tipranks.com/mcp/. Clients that support OAuth will discover the flow automatically via the server's /.well-known/oauth-protected-resource metadata.

Full per-client setup instructions: https://mcp.tipranks.com/

---

Authentication & scopes

Authenticated services use OAuth 2.1 (PKCE S256, Dynamic Client Registration). Two scopes:

Scope	Default	Grants
tipranks:read	✔	Market data: analyst ratings, Smart Score, technicals, news, screening, ETFs, commodities, forex, crypto
tipranks:portfolio	—	Read your TipRanks portfolios (holdings, performance, allocation) — limited to portfolios you own at authorization time

Developers can alternatively use an API key — see the developer portal.

Rate limits

Plan	Tool calls / month
Free	10
Premium	100
Ultimate	200

Resets on the 1st of each month (UTC). API-key tiers (free / smart / advanced / professional) carry their own per-minute and monthly limits.

---

Tools

70+ read-only tools, grouped by domain:

• Stocks & research — quotes, prices, analyst ratings & consensus, price targets, Smart Score, bull/bear summary, peers, catalysts
• Fundamentals — financials, earnings history & estimates, earnings-call summaries, dividends, KPIs, buybacks, stock splits
• Ownership & sentiment — insider transactions, hedge-fund holdings & activity, congressional (politician) trading, blogger & investor sentiment, top experts
• Discovery & screening — trending stocks, top-rated & top Smart-Score stocks, market movers, sector & market performance, ETF screener
• ETFs — analysis, forecast, holdings, exposures, top stocks
• Options — expirations, chains, contracts, unusual trades
• Calendars & events — earnings, IPO, economic, clinical-trial/FDA calendars, market commentary, news & articles
• Cross-asset — commodities, forex, crypto, indices (quotes + historical)
• Your portfolios — list, holdings, overview, performance, analysis (requires tipranks:portfolio)

The connector is read-only end to end — every tool is annotated readOnlyHint: true, destructiveHint: false.

---

Examples

Runnable sample agents that build on the connector live in examples/:

• due-diligence-agent — turns a ticker into a structured research memo (analyst consensus, Smart Score, financials, technicals, bull/bear case, smart-money signals).
• earnings-companion — turns a ticker into an earnings brief (next report & expectations, beat/miss track record, last-call recap, analyst posture into the print).
• smart-money-screener — surfaces a ranked shortlist of ideas the smart money is favoring (top Smart-Score names, trending stocks, hedge-fund/insider buying).

Each is compact Python; the model calls the TipRanks tools autonomously through the MCP connector. Get an API key at mcp.tipranks.com/dev/signup to run them.

---

Privacy Policy

See https://mcp.tipranks.com/privacy. In brief: OAuth tokens and API keys are stored only as SHA-256 hashes (no plaintext credentials at rest); the connector reads TipRanks and market data on your behalf and does not sell personal data. Contact: support@tipranks.com.

Support

• Docs: https://mcp.tipranks.com/
• Developer portal: https://mcp.tipranks.com/dev
• Email: support@tipranks.com

---

© TipRanks. This repository contains the public connector descriptor, documentation, and example code for the hosted TipRanks MCP service. It does not contain the server implementation.