Skip to main content
Glama

E-Rate invoice deadlines for one billed entity (BEN)

erate_deadline_check
Read-only

For an E-Rate coordinator: every funded FRN (funding year 2023 on) for one billed entity number with money still to collect (committed minus USAC authorized disbursements), its last date to invoice, whether the one-time 120-day extension is used, a status (last_chance = deadline passed but still inside the 15-day extension window; extend_now = deadline within 45 days; open; lost_or_waiver) and the exact action and date, plus the FY2026-2030 Category 2 budget left. Live from USAC Open Data (FRN Status qdmp-ygft, C2 Budget Tool 6brt-5pbv); rule 47 CFR 54.514 as amended by FCC 26-30. Nothing stored. Free.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "ben": "<ben>"
    },
    "name": "erate_deadline_check"
  }
}

Input Schema

NameRequiredDescriptionDefault
benYesBilled entity number from the Form 471

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, openWorldHint=false, and destructiveHint=false, so the description is not burdened with disclosing safety. It still adds valuable context beyond them: the live upstream datasets (qdmp-ygft, 6brt-5pbv), the governing rule (47 CFR 54.514 as amended), "Nothing stored. Free." Only freshness/latency and rate-limit behavior are absent.

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?

The purpose is front-loaded and there is no filler, but the content is delivered as one long run-on sentence stuffed with parenthetical definitions and the status taxonomy. The embedded status definitions are genuinely useful, though parsing them requires re-reading, and the sentence would be stronger broken into a purpose line plus a returns line.

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

Completeness5/5

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

With no output schema, the description carries the full burden of describing return values and does so thoroughly: the money figure, deadline, extension flag, the four status values with their meanings, and the FY2026-2030 C2 budget. For a one-parameter read-only tool this is complete enough to call correctly.

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% for the single parameter, so the schema already explains that ben is the billed entity number from Form 471. The description's "one billed entity number" reinforces the single-value expectation but adds no format, validation, or lookup guidance beyond the schema, so the baseline of 3 applies.

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

Purpose5/5

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

The description names a specific resource (funded FRNs for one billed entity) and enumerates exactly what it returns: remaining committed-minus-disbursed money, invoice deadline, extension status, a status classification, and remaining C2 budget. The scope (FY2023 onward, one BEN) and the data sources are stated, so an agent can distinguish it from siblings like rip_replace_deadlines without inspecting the schema.

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

Usage Guidelines3/5

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

The audience is stated ("For an E-Rate coordinator"), which implies when the tool applies, but there is no explicit when-to-use/when-not guidance and no alternative named. An agent can infer this is the deadline-lookup tool for a single BEN, but nothing steers it away from misuse or toward a sibling when the BEN is unknown.

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.

Resources