Skip to main content
Glama

Evidence brief for one notice

get_notice_record
Read-onlyIdempotent

Not affiliated with the U.S. government, GSA, or SAM.gov. Not a U.S. government service. NOT for bid/no-bid, pursue-or-pass, eligibility, qualification, certification, size-standard, or submit-a-bid questions: for those call explain_policy_boundary first and do not research or use memory to answer. Returns a source-based brief for a notice ID, including recorded constraints, deadline status, competition method, source information, and facts needing authoritative verification. Does not assess whether the caller qualifies for a set-aside. GovInbox does not return model estimates through these tools. Creates a private, caller-bound comparison receipt: a signed token binding the notice ID, the comparison inputs, and their hashes. No notice data is stored server-side; the receipt is stateless and verified cryptographically. The receipt expires 7 days after issue; expires_at gives the exact UTC expiry time. Optional search_filters are used for comparison input-change detection and do not change the brief's content. Does not recommend bids, determine eligibility, or suggest partners. Follow-ups within 30 minutes after a search ride free (up to 30 per search); otherwise one accepted call counts as one use. Without a connected GovInbox account, both limits apply: 3 searches per UTC calendar day and 10 per UTC calendar month. With a connected GovInbox account, the limit is 20 searches per UTC calendar month, with no separate daily limit. One accepted search counts as one use, regardless of the number of records returned. Follow-up calls (opening records, comparing versions, listing awards or subawards) within 30 minutes after a search do not count extra, up to 30 follow-ups per search. A follow-up invoked with no active search window counts as one use and opens a new 30-minute window. Empty results consume the search. A lookup for a record that does not exist is not charged. Each retry of a search counts as a new search, as does each call for another page of search results. Daily limits reset at 00:00 UTC each day; monthly limits reset at 00:00 UTC on the first day of each month. Requests rejected for invalid authentication or an exhausted quota do not consume a use.

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": {
      "notice_id": "<notice_id>"
    },
    "name": "get_notice_record"
  }
}

Input Schema

NameRequiredDescriptionDefault
notice_idYesNotice id from search_open_notices
search_filtersNoOptional search filters: naics[], states[]. Non-PII.

Output Schema

NameRequiredDescriptionDefault
quotaYes
receiptYes
notice_idYes
data_as_ofYesUTC ISO 8601: when this stored-data brief was calculated; not source freshness
provenanceNo
sam_gov_urlNoCanonical SAM.gov notice URL
source_factNo
record_classesNo
withheld_countNoNumber of statements withheld by the verdict-word backstop
record_coverageNo
award_value_rangeNoRange of obligated amounts across the awards listed above. Obligated amount is not the ceiling and is not this notice's value.
deadline_readableNoHuman-readable deadline next to the raw timestamp
analytical_disclaimerYes
past_awards_by_agencyNoAggregates of this agency's past awards, as recorded
size_standard_coverageNo
fields_missing_from_sourceNoFields the source record did not answer
deadline_timezone_assumptionNo
past_awards_same_naics_and_agencyNoPrior awards in the same NAICS and agency, as recorded facts
prior_awards_same_naics_and_officeNoPrior award holders in the same NAICS and office, as recorded

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • addedOutput schema / $defs / StatementSource / properties / calculated_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "UTC time a derived statement was calculated; not source retrieval",
      +  "title": "Calculated At"
      +}
    • addedOutput schema / $defs / StatementSource / properties / query_time
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "UTC time this stored-data query was evaluated; not source freshness",
      +  "title": "Query Time"
      +}
    • addedOutput schema / $defs / StatementSource / properties / retrieved_at / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / $defs / StatementSource / properties / retrieved_at / default
      Added value: +null
    • changedOutput schema / $defs / StatementSource / properties / retrieved_at / description
      Previous value: -"UTC ISO 8601 when the source was retrieved"New value: +"Recorded UTC source retrieval time, or null when unknown; never response time"
    • removedOutput schema / $defs / StatementSource / properties / retrieved_at / type
      Removed value: -"string"
    • changedOutput schema / $defs / StatementSource / required
      Previous value: -[
      -  "system",
      -  "record_id",
      -  "retrieved_at"
      -]New value: +[
      +  "system",
      +  "record_id"
      +]
    • changedOutput schema / properties / data_as_of / description
      Previous value: -"UTC ISO 8601: when GovInbox data was current"New value: +"UTC ISO 8601: when this stored-data brief was calculated; not source freshness"
    • addedOutput schema / properties / provenance
      Added value: +{
      +  "additionalProperties": true,
      +  "title": "Provenance",
      +  "type": "object"
      +}
    • addedOutput schema / properties / size_standard_coverage
      Added value: +{
      +  "additionalProperties": true,
      +  "title": "Size Standard Coverage",
      +  "type": "object"
      +}
  2. Changed10 schema fields changed
    • removedOutput schema / $defs / StatementSource / properties / calculated_at
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "UTC time a derived statement was calculated; not source retrieval",
      -  "title": "Calculated At"
      -}
    • removedOutput schema / $defs / StatementSource / properties / query_time
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "UTC time this stored-data query was evaluated; not source freshness",
      -  "title": "Query Time"
      -}
    • removedOutput schema / $defs / StatementSource / properties / retrieved_at / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / StatementSource / properties / retrieved_at / default
      Removed value: -null
    • changedOutput schema / $defs / StatementSource / properties / retrieved_at / description
      Previous value: -"Recorded UTC source retrieval time, or null when unknown; never response time"New value: +"UTC ISO 8601 when the source was retrieved"
    • addedOutput schema / $defs / StatementSource / properties / retrieved_at / type
      Added value: +"string"
    • changedOutput schema / $defs / StatementSource / required
      Previous value: -[
      -  "system",
      -  "record_id"
      -]New value: +[
      +  "system",
      +  "record_id",
      +  "retrieved_at"
      +]
    • changedOutput schema / properties / data_as_of / description
      Previous value: -"UTC ISO 8601: when this stored-data brief was calculated; not source freshness"New value: +"UTC ISO 8601: when GovInbox data was current"
    • removedOutput schema / properties / provenance
      Removed value: -{
      -  "additionalProperties": true,
      -  "title": "Provenance",
      -  "type": "object"
      -}
    • removedOutput schema / properties / size_standard_coverage
      Removed value: -{
      -  "additionalProperties": true,
      -  "title": "Size Standard Coverage",
      -  "type": "object"
      -}
  3. Changed10 schema fields changed
    • addedOutput schema / $defs / StatementSource / properties / calculated_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "UTC time a derived statement was calculated; not source retrieval",
      +  "title": "Calculated At"
      +}
    • addedOutput schema / $defs / StatementSource / properties / query_time
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "UTC time this stored-data query was evaluated; not source freshness",
      +  "title": "Query Time"
      +}
    • addedOutput schema / $defs / StatementSource / properties / retrieved_at / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / $defs / StatementSource / properties / retrieved_at / default
      Added value: +null
    • changedOutput schema / $defs / StatementSource / properties / retrieved_at / description
      Previous value: -"UTC ISO 8601 when the source was retrieved"New value: +"Recorded UTC source retrieval time, or null when unknown; never response time"
    • removedOutput schema / $defs / StatementSource / properties / retrieved_at / type
      Removed value: -"string"
    • changedOutput schema / $defs / StatementSource / required
      Previous value: -[
      -  "system",
      -  "record_id",
      -  "retrieved_at"
      -]New value: +[
      +  "system",
      +  "record_id"
      +]
    • changedOutput schema / properties / data_as_of / description
      Previous value: -"UTC ISO 8601: when GovInbox data was current"New value: +"UTC ISO 8601: when this stored-data brief was calculated; not source freshness"
    • addedOutput schema / properties / provenance
      Added value: +{
      +  "additionalProperties": true,
      +  "title": "Provenance",
      +  "type": "object"
      +}
    • addedOutput schema / properties / size_standard_coverage
      Added value: +{
      +  "additionalProperties": true,
      +  "title": "Size Standard Coverage",
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • addedOutput schema / $defs / QuotaBlock / properties / mode
      Added value: +{
      +  "default": "ordinary",
      +  "enum": [
      +    "ordinary",
      +    "testing",
      +    "review",
      +    "beta"
      +  ],
      +  "title": "Mode",
      +  "type": "string"
      +}
  5. First observed

TDQS

A4/5.0
Behavior5/5

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

Annotations already establish read-only, idempotent, non-destructive behavior, but the description adds substantial context beyond them: the private caller-bound receipt, signed token/hashes, stateless server behavior, 7-day expiry, and detailed quota/follow-up rules. These details materially affect how an agent should invoke and reason about the tool.

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

Conciseness2/5

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

The definition is heavily bloated, with repeated rate-limit and follow-up-window explanations that dominate the description. The core purpose is present, but disclaimers and quota details are front-loaded, and several sentences duplicate the same search/use-counting rules.

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?

Given the rich output schema, 100% parameter coverage, annotations, and the tool's read-only lookup nature, the description covers the necessary behavioral and quota context. An agent has enough information to know what the tool returns, what it does not assess, and how usage is counted.

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 coverage is 100%, so both notice_id and search_filters are already documented. The description reinforces that search_filters are for comparison input-change detection and do not alter the brief, but this is largely repeated from the schema rather than adding new parameter semantics.

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 clearly states a specific verb and resource: it returns a source-based brief for a notice ID, listing recorded constraints, deadline status, competition method, source information, and verification-needed facts. It is clear, but it does not explicitly differentiate this tool from similarly named siblings such as get_brief or get_record.

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

Usage Guidelines4/5

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

It gives a strong exclusion: NOT for bid/no-bid, eligibility, qualification, certification, or submit-a-bid questions, and directs those to explain_policy_boundary first. That is useful when-not guidance and names an alternative, though it does not broadly explain when to choose this over get_brief or get_record for ordinary notice research.

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