Developers
Every figure on this site is a JSON file, and AI assistants can read them through MCP. The JSON files are free and need no key; the MCP server is a Pro feature and needs an API key.
The JSON files
Every figure on the site is published as a JSON file under /api/v1/, rebuilt with each day's build. No key, no sign-in, no rate limit on the files themselves. The files carry the same figures, notice and limits as the pages.
| File | What it holds |
|---|---|
| api/v1/meta.json | When the figures were built, the method, the required return, the sources and the counts. |
| api/v1/index.json | One compact row per company, plus each view's symbols in the site's own order. |
api/v1/c/TICKER.json | One company: fair value, likely range, margin-of-safety and stress prices, the 25 checks, flags, the short case, the last close. For example, api/v1/c/CMCSA.json. |
| api/v1/etfs.json | The funds, valued through their holdings. |
api/v1/e/TICKER.json | One fund: the value of its holdings against its close, and how much of the fund is valued. |
The files are plain static files: any tool that can fetch a URL can read them, and nothing is tracked about who fetches what.
An example
One company's file, trimmed:
curl https://www.slatefinch.app/api/v1/c/CMCSA.json
{
"symbol": "CMCSA",
"name": "Comcast Corp",
"fair_value": 49.72,
"likely_range": {"low": 31.43, "high": 65.95},
"margin_of_safety_price": 37.29,
"stress_case": 32.43,
"checks": {"passed": 16, "of": 25},
...
}Figures are from one day's build and change with each refresh. The full file also carries the model inputs, the short case, the ten-year history, and the notice to show with the figures.
Use it from an AI assistant Pro
A Model Context Protocol server at https://www.slatefinch.app/mcp: Streamable HTTP, JSON responses, no sessions, read-only. It answers only from the same build's /api/v1 files, so an assistant sees exactly what the pages show.
The MCP server is a Pro feature. It needs an API key, sent as an X-Api-Key header. Keys are issued manually for now, while self-serve billing is in preparation.
Add it to your assistant:
- Claude (Desktop or web)
- Settings → Connectors → Add custom connector, paste the address and add your API key.
- Claude Code
claude mcp add --transport http slate-finch https://www.slatefinch.app/mcp --header "X-Api-Key: sf_live_your_key_here"- Claude Desktop config file
- Add it to ~/Library/Application Support/Claude/claude_desktop_config.json on a Mac, or %APPDATA%\Claude\claude_desktop_config.json on Windows:
{ "mcpServers": { "slate-finch": { "type": "http", "url": "https://www.slatefinch.app/mcp", "headers": {"X-Api-Key": "sf_live_your_key_here"} } } }Then restart Claude Desktop. If your client cannot add a remote server this way, the mcp-remote bridge (npx -y mcp-remote followed by the address) is the fallback. - ChatGPT (web, Plus plan or above)
- Settings → Plugins → Add custom MCP server, paste the address and add your API key. OpenAI renames this menu from time to time; look for Plugins, Apps, or Connectors.
- Any other client
- One that speaks Streamable HTTP needs the address and an X-Api-Key header.
The tools:
| Tool | What it does |
|---|---|
search_companies | Find companies by ticker or part of a name. |
get_company | One company's fair value, range, checks, flags, short case and close. Argument: symbol. |
list_companies | The site's own lists, in the site's order, with an optional sector filter. |
list_etfs | The funds valued through their holdings. |
get_etf | One fund's value of holdings against its close. |
get_site_info | When the figures were built, the method, the sources, the counts. |
search | Search companies and ETFs; pass a result's id to fetch. ChatGPT's shape. |
fetch | The full figures for one search result, as text. ChatGPT's shape. |
search and fetch are the shapes ChatGPT's deep research and connectors use; the other tools are the same data in structured form.
Limits
Each API key has its own limits: Pro allows 100 requests per 10 seconds and 50,000 requests per day; Commercial allows 1,000 requests per 10 seconds and 1,000,000 requests per day. Over the burst limit, requests are refused for 10 seconds; over the daily limit, until midnight UTC.
For bulk use, read the JSON files instead of calling /mcp repeatedly.
The files and the endpoint are provided as is, with no promise of availability. They may change, be rate-limited or stop at any time; a breaking change gets a new version path.
Terms
The JSON files are free and need no key; the MCP server needs an API key. You may use and republish the figures with credit to Slate Finch and a link.
Keep the not-investment-advice notice with them, and do not present them as Slate Finch's recommendation or as advice suited to anyone.
Closing prices are IEX's data, and IEX's Historical Data Terms of Use apply to you. If you show or pass on a close, include IEX's citation: Data provided for free by IEX. By accessing or using IEX Historical Data, you agree to the IEX Historical Data Terms of Use. IEX says the data reflects trading on IEX only, not other markets, and is a reference point only, rather than as a basis for making trading decisions. Neither IEX nor I guarantee the closes. Do not use them to build an index or a financial product.
Do not use the API for anything unlawful, to suggest endorsement by the SEC, the Treasury, IEX or any company, or in a way that overloads the service.
The full terms are on the Disclosures page.