Skip to main content
Glama

Estimate Next SEC Filing Dates

estimate_filing_dates
Read-onlyIdempotent

Estimates each company's next 10-Q/10-K filing date from its past SEC filing cadence. Dates are estimates, not announced filing dates.

Input Schema

NameRequiredDescriptionDefault
form_typeNoFilter estimated filings to 10-Q or 10-K; omit to include both.
within_daysNoInclude estimated 10-Q/10-K filing dates from today through this many calendar days; default 30, max 120.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / form_type / description
      Added value: +"Filter estimated filings to 10-Q or 10-K; omit to include both."
    • addedInput schema / properties / within_days / description
      Added value: +"Include estimated 10-Q/10-K filing dates from today through this many calendar days; default 30, max 120."
  2. First observed

TDQS

B3.3/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and closed-world behavior, so the safety profile is covered. The description adds one genuinely useful behavioral caveat — that outputs are projections from cadence, not announced dates — but says nothing about projection horizon, confidence, or behavior for companies with thin filing history.

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

Conciseness5/5

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

Two sentences, zero filler, with the core behavior first and the reliability caveat immediately after. Nothing is padded.

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

Completeness3/5

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

A read-only, closed-world, no-required-param tool is simple enough that the short description is largely adequate. However, with no output schema, the description should at least hint at the return shape (per-company date list vs. single date) and clarify entity scope — neither is present.

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

Parameters3/5

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

Schema description coverage is 100%: both parameters are fully documented in the schema, including the enum filter and the default/max on within_days. The description adds no syntax or interpretation beyond that, so the baseline 3 applies.

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?

States a specific verb (estimates) plus resource (next 10-Q/10-K filing dates) and even the method (past filing cadence), which no sibling tool duplicates. The one ambiguity is scope: 'each company's' is unexplained, and with zero required parameters it's unclear whether this is entity-scoped, universe-wide, or context-bound.

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 when-to-use guidance, no when-not-to-use, and no named alternative among the many sibling estimate/screening tools. The agent must infer the use case entirely 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.