Skip to main content
Glama

Statistics of the World

get_company_facts

Read the reviewed SEC company catalog, or exact issuer/concept facts with exact decimal strings, fiscal contexts, filing dates, units and immutable acquisition evidence. Publication pins guard current registry coherence; they do not reconstruct a full historical filing snapshot. No inferred quarters or currency conversions.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
toNo
cikNo
tagNo
fromNo
limitNo
evidenceNo
filed_toNo
filed_fromNo
publicationNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

C2.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the full behavioral burden, and it does disclose real constraints: no inferred quarters, no currency conversions, publication pins only guard current registry coherence and do not reconstruct a historical filing snapshot. However, it says nothing about permissions, pagination, limits, or the shape/immutability of returned data, leaving notable gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, reasonably compact, but dense with opaque jargon like 'immutable acquisition evidence' that does not clearly earn its place. The core purpose is front-loaded, which helps.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 9-parameter tool with 0% schema coverage, no required params, no output schema, and no annotations, the description omits critical operating detail such as how cik/tag/date range combine, default paging via limit, and what nonsense values do. It is not adequate to call the tool confidently.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the description names none of the 9 parameters (cik, tag, from, to, limit, filed_from, filed_to, evidence, publication). 'Issuer/concept', 'filing dates', and 'publication pins' are faint thematic hints at best and do not compensate for the total lack of parameter documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb ('Read') and resource ('reviewed SEC company catalog' / 'issuer/concept facts'), which lets an agent distinguish this SEC-facts tool from the economic-data siblings. It is slightly muddled by offering two modes (catalog vs. facts) in one breath, but the subject matter is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no explicit when-to-use or when-not-to-use guidance and no named alternative among the 16 sibling tools. The only implicit condition is that it returns SEC issuer/concept facts, leaving the agent to infer routing from the name.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.