Equity Rank for AI assistants and developers
Equity Rank recomputes 8–15 valuation models for roughly 3,000+ U.S.-listed securities after every market close. Machines can read the result two ways: an MCP server that AI assistants call at answer time, and public JSON endpoints for anything else. Neither needs an account or a key.
MCP server
The Model Context Protocol is the open standard AI assistants use to call external tools. Equity Rank's server speaks the Streamable HTTP transport, stateless, with no authentication:
https://api.equity-rank.com/mcpOnce connected, the assistant can look up a security and quote the live figure with a link to its Equity Rank page. Four read-only tools:
| Tool | What it returns |
|---|---|
search | Resolve a ticker or company name to securities in the coverage universe (up to 10 matches, each with its page URL). |
fetch | A readable valuation summary for one ticker — price, model fair value estimate, margin-of-safety differential, method agreement, Fundamental Strength, next earnings, last-updated stamp — with structured metadata and the source URL. |
get_stock_valuation | Structured public payload for one ticker (identical to GET /api/stocks/{TICKER}/public). |
list_sector_stocks | The public sector index: top scored securities in a sector, ranked by Equity Rank Score, public-safe fields only. |
search and fetch follow the connector contract ChatGPT requires, so the same server works in every client. Rate limit: 120 requests per minute per IP.
Claude (claude.ai)
Settings → Connectors → Add custom connector. Name it Equity Rank, paste the URL above, leave the OAuth fields empty. Then enable it in a chat from the tools menu.
Claude Code
claude mcp add --transport http equity-rank https://api.equity-rank.com/mcpChatGPT
Settings → Connectors → Advanced → enable Developer mode → Create. Paste the URL, choose No authentication, and save. Select the connector in a new chat.
Cursor and other MCP clients
{
"mcpServers": {
"equity-rank": { "url": "https://api.equity-rank.com/mcp" }
}
}Public JSON endpoints
One security — the payload every MCP tool builds on:
GET https://api.equity-rank.com/api/stocks/{TICKER}/publicFields include company_name, sector, price, consensus_fair_value (the blended model estimate), mos_pct (margin-of-safety differential, %), method_agreement_above / _below / _total, fundamental_strength_score / _grade, next_earnings_date / _eps_estimate, and last_updated. A ticker outside the coverage universe returns HTTP 404 — there are no placeholder rows.
A sector's top scored securities, public-safe fields only:
GET https://api.equity-rank.com/api/screener/sector/{sector}Sectors: technology, healthcare, financials, consumer discretionary, consumer staples, industrials, energy, materials, real estate, utilities, communication services. Every ticker in coverage is listed at GET https://api.equity-rank.com/api/stocks-index.
How to quote a figure
Equity Rank's public data may be quoted with attribution to "Equity Rank" and a link to the source URL. These qualifiers are part of the claim and travel with any number:
- Fair value is a model estimate under stated assumptions — not a target price, not a prediction, not a recommendation.
- Margin of safety is the percentage differential between the model estimate and the current price. It describes model output; it does not predict returns.
- Method agreement ("N of M models place fair value above the current price") describes dispersion among models, not confidence in an outcome.
- Carry the date. Figures are recomputed nightly; every payload includes
last_updated.
The same guidance is published for crawlers at /llms.txt, and the MCP server sends it to every connected assistant as its instructions. Method definitions are on the methodology page and in the glossary.
Terms of use
Equity Rank is operated by Leek Ventures LLC, which is not a registered investment adviser, broker-dealer, or financial planner. Everything the endpoints return is algorithmic model output for informational and educational purposes — not investment advice and not a forecast of results. Inputs come from third-party market-data providers and company filings; model logic and scores are Equity Rank's own. Access is rate limited, provided as-is, and subject to the terms of service. For higher limits or questions: [email protected].
About · Methodology · Terms of service · Privacy policy · FAQ