Crush The Market for agents

Your agent can read the scores, the screens and the filings behind them directly — over MCP for chat clients, over a plain REST API for everything else. An account and a key are all it takes, and the free tier needs no card.

Three steps to a working agent

  1. 1.Decide which way in you want. Chat clients that speak MCP — Claude Code, the Claude desktop and web apps — use the MCP server. Everything else uses the REST API.
  2. 2.Register free — an email address, no card — then open API Keys on your account page and create one. The key is shown once, so save it there and then.
  3. 3.Paste the setup command, with your key in it.
Claude Code
> claude mcp add --transport http crushthemarket \  https://crushthemarket.com/api/mcp \  --header "Authorization: Bearer ctm_live_YOUR_KEY"

! --transport http is not optional. Without it claude mcp add treats the URL as a command to run, the server never connects, and the failure shows up on the first tool call rather than at setup.

For a client that cannot set headers, and for the rest of the setup, see the MCP guide. For curl, language SDKs and anything that is not a chat client, see the REST guide.

The tools

11 tools, 10 on the free tier and 1 on Pro. Both surfaces expose the same set from the same registry, so a tool that exists here exists over MCP and over REST with the same arguments.

search_companies

Find covered companies by name or ticker.

Free
get_company

Profile, the six scores, and the plain-English readings for one symbol.

Free
explain_metric

What one screening criterion means, and how to filter on it.

Free
screen_stocks

Filter the scored universe on one or more criteria.

Free
backtest_screen

Run a screen back through every year we hold and compare it to the market. Pro only.

Pro
help

How to use these tools well, and what this data can and cannot answer.

Free
list_filings

Which SEC filings exist for a company, with accession numbers.

Free
get_filing_outline

Every readable part of one filing, both lanes, with sizes.

Free
read_filing_section

The text of one section of one filing, whole by default.

Free
search_filing

Find a phrase across one filing, with the section each hit came from.

Free
score_evidence

One score's legs, each paired with the notes in the company's own annual report that bear on it.

Free

Every argument, every response field and a worked call for each one are on the REST guide. An agent already connected over MCP can read the same thing from tools/list.

What it costs

  • —Free — 12 agent calls per 16 hours. This is its own allowance: it is not shared with the 12 screening and search actions the website gives you.
  • —Pro — no call limit.
  • —Every response carries a quota block saying how many calls are used, what the limit is and when the window resets, so an agent never has to guess how much room is left.
  • —Separately from the allowance there is a pace limit of 60 calls a minute and 5,000 a day per key. It refills continuously; it is not an allowance and upgrading does not lift it.

There is no anonymous tier. tools/list and /openapi.json answer without a key because they describe the interface rather than return data; every tool call needs one.

For crawling agents

  • —/openapi.json — the OpenAPI document for the REST surface, one operation per tool. Public, no key.
  • —/.well-known/mcp.json — the MCP server descriptor. Public, no key.
  • —POST https://crushthemarket.com/api/mcp with {"jsonrpc":"2.0","id":1,"method":"tools/list"} — the live tool list, also without a key.

All three are generated from the same registry as this page, so none of them can describe a tool that does not exist.

More for agents

Agents — you are hereWhat exists, and the three-step quickstart.
MCPConnect Claude Code or claude.ai.
REST APIBearer auth, endpoints, errors and limits.
ToolsOne page per tool: arguments, a worked call, what it can fail with.

Data, not advice. Do your own diligence.

Noticed an error with something on our site?

Data, not advice. Do your own diligence.

We Use Cookies