Sugerir

TipRanks MCP Server

MCP

TipRanks' official read-only MCP: analyst ratings and price targets, Smart Score, insider and hedge fund activity, congressional trades, ETF and earnings data, plus your own portfolio. Needs a TipRanks account (OAuth); free tier: 10 calls a month. Results need expert review.

TipRanks/mcp16
Ver en GitHub
README

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.

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:

ScopeDefaultGrants
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

PlanTool calls / month
Free10
Premium100
Ultimate200

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

© 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.

Recursos relacionados