get_company
Profile, the six scores, and the plain-English readings for one symbol.
What it does
Returns the stored profile, the six composite scores (value, growth, financial health, dividend, management, total, each 0-100), the ranked strengths and risks, the one-line verdict per section, and a coverage block naming where the data came from and whether the filing tools will return anything for this symbol. A score of null means too few of its legs could be computed -- it is NOT a bad score.
get_company is on the free tier. A free account gets 12 agent calls per 16 hours and this is one of them; Pro is uncounted. The website's own screening allowance is counted separately.
Arguments, returns and a worked call
Everything below is generated from the same registry entry the MCP server and /openapi.json are generated from, so this page cannot name an argument that does not exist. The two examples are the same call, once over each transport.
get_company
FreeReturns the stored profile, the six composite scores (value, growth, financial health, dividend, management, total, each 0-100), the ranked strengths and risks, the one-line verdict per section, and a coverage block naming where the data came from and whether the filing tools will return anything for this symbol. A score of null means too few of its legs could be computed -- it is NOT a bad score.
Arguments
symbol string, required — The ticker as Crush The Market spells it. London listings carry a `.L` suffix.
Returns
symbol, profile, scores, readings, coverage, error, as_of, source, disclaimer
> curl -s https://crushthemarket.com/api/v1/get_company \ -H "Authorization: Bearer $CTM_KEY" \ -H 'Content-Type: application/json' \ -d '{"symbol":"AAPL"}'{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_company", "arguments": { "symbol": "AAPL" } }}Can answer
bad_request — `symbol` is missing or empty.
unknown_symbol — No profile is held for the symbol at all.
not_covered — The symbol is an ETF. No feed supplies fund holdings, so ETFs are never scored.
no_analysis — The company is covered but has no scored row yet.
Calling get_company
- 1.Register free — an email address, no card — then create a key under API Keys on your account page. Your email address has to be verified first, and the key is shown once.
- 2.Using a chat client that speaks MCP? The MCP guide is one paste. Anything else takes bearer auth, the error codes and the limits from the REST guide.
- 3.Make the call above with your own key in it.
Every successful response carries as_of, source, a quota block saying how much of the allowance is left, and the same disclaimer this page ends on.
More for agents
Data, not advice. Do your own diligence.