Skip to main content
Glama

Grant opportunity details

get_grant_record
Read-onlyIdempotent

Not affiliated with the U.S. government, GSA, or SAM.gov. Not a U.S. government service. Full details for one grant opportunity: eligibility applicant types, funding categories, award range, dates, and summary as recorded from the public posting. Present as information only; do not frame results as an eligibility determination or application recommendation. Verify every fact against the official grant posting before acting. Follow-ups within 30 minutes after a search ride free (up to 30 per search); otherwise one accepted call counts as one use. Every record carries a direct source link (or source name and record ID) so you can verify and cite the underlying record.

Input Schema

NameRequiredDescriptionDefault
opportunity_numberYesOpportunity number from a search result

Output Schema

NameRequiredDescriptionDefault
quotaYes
titleYes
agencyNo
statusNo
summaryNo
coverageYes
post_dateNo
close_dateNo
source_urlNoDeep link to the opportunity on Grants.gov or Simpler.Grants.gov for verification
attachmentsNo
award_floorNo
record_typeNogrant
source_nameNoGrants.gov
archive_dateNo
field_statusNo
award_ceilingNo
source_versionNo
applicant_typesNo
expected_awardsNo
funding_amountsNo
is_cost_sharingNo
record_deliveryNo
summary_deliveryNo
top_level_agencyNo
enrichment_statusNo
source_fetched_atNo
source_updated_atNo
funding_categoriesNo
opportunity_numberYes
additional_info_urlNo
attachments_deliveryNo
analytical_disclaimerYes
application_deadlinesNo
record_content_policyNo
attachment_text_statusNo
close_date_descriptionNo
application_deadlines_deliveryNo
applicant_eligibility_descriptionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed52 schema fields changed
    • addedOutput schema / $defs / Coverage / properties / as_of / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / $defs / Coverage / properties / as_of / default
      Added value: +null
    • changedOutput schema / $defs / Coverage / properties / as_of / description
      Previous value: -"UTC ISO 8601"New value: +"Known source observation time; null when not recorded. Not the query time."
    • removedOutput schema / $defs / Coverage / properties / as_of / type
      Removed value: -"string"
    • addedOutput schema / $defs / Coverage / properties / cache_timestamp_basis
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Cache Timestamp Basis"
      +}
    • addedOutput schema / $defs / Coverage / properties / cache_timestamp_field
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Cache Timestamp Field"
      +}
    • addedOutput schema / $defs / Coverage / properties / exclusions
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "title": "Exclusions",
      +  "type": "array"
      +}
    • addedOutput schema / $defs / Coverage / properties / last_attempt_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Last Attempt At"
      +}
    • addedOutput schema / $defs / Coverage / properties / last_attempt_scope
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Last Attempt Scope"
      +}
    • addedOutput schema / $defs / Coverage / properties / last_success_record_count
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Last Success Record Count"
      +}
    • addedOutput schema / $defs / Coverage / properties / last_success_scope
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Last Success Scope"
      +}
    • addedOutput schema / $defs / Coverage / properties / last_successful_ingest_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Last Successful Ingest At"
      +}
    • addedOutput schema / $defs / Coverage / properties / last_successful_refresh_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Last Successful Refresh At"
      +}
    • addedOutput schema / $defs / Coverage / properties / latest_cached_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Latest Cached At"
      +}
    • addedOutput schema / $defs / Coverage / properties / latest_stored_fetched_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Latest Stored Fetched At"
      +}
    • addedOutput schema / $defs / Coverage / properties / latest_stored_ingested_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Latest Stored Ingested At"
      +}
    • addedOutput schema / $defs / Coverage / properties / oldest_cached_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Oldest Cached At"
      +}
    • addedOutput schema / $defs / Coverage / properties / oldest_ingested_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Oldest Ingested At"
      +}
    • addedOutput schema / $defs / Coverage / properties / pagination_note
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Pagination Note"
      +}
    • addedOutput schema / $defs / Coverage / properties / population
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Population"
      +}
    • addedOutput schema / $defs / Coverage / properties / population_complete
      Added value: +{
      +  "default": false,
      +  "title": "Population Complete",
      +  "type": "boolean"
      +}
    • addedOutput schema / $defs / Coverage / properties / population_status
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Population Status"
      +}
    • addedOutput schema / $defs / Coverage / properties / query_time
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "When this stored-data query was calculated; not proof of source refresh",
      +  "title": "Query Time"
      +}
    • addedOutput schema / $defs / Coverage / properties / record_type
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Record Type"
      +}
    • addedOutput schema / $defs / Coverage / properties / refresh_error_code
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Refresh Error Code"
      +}
    • addedOutput schema / $defs / Coverage / properties / refresh_status
      Added value: +{
      +  "default": "unknown",
      +  "title": "Refresh Status",
      +  "type": "string"
      +}
    • addedOutput schema / $defs / Coverage / properties / scope_note
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Scope Note"
      +}
    • addedOutput schema / $defs / Coverage / properties / source
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Source"
      +}
    • addedOutput schema / $defs / Coverage / properties / source_as_of
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Source As Of"
      +}
    • addedOutput schema / $defs / Coverage / properties / source_state
      Added value: +{
      +  "anyOf": [
      +    {
      +      "enum": [
      +        "matched",
      +        "no_match",
      +        "not_loaded",
      +        "unsupported",
      +        "failed_refresh",
      +        "unknown"
      +      ],
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Source State"
      +}
    • addedOutput schema / $defs / Coverage / properties / source_url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Source Url"
      +}
    • addedOutput schema / $defs / Coverage / properties / stored_rows
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Stored Rows"
      +}
    • removedOutput schema / $defs / Coverage / required
      Removed value: -[
      -  "as_of"
      -]
    • addedOutput schema / properties / additional_info_url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Additional Info Url"
      +}
    • addedOutput schema / properties / applicant_eligibility_description
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Applicant Eligibility Description"
      +}
    • addedOutput schema / properties / application_deadlines
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  "title": "Application Deadlines",
      +  "type": "array"
      +}
    • addedOutput schema / properties / application_deadlines_delivery
      Added value: +{
      +  "additionalProperties": true,
      +  "title": "Application Deadlines Delivery",
      +  "type": "object"
      +}
    • addedOutput schema / properties / attachment_text_status
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Attachment Text Status"
      +}
    • addedOutput schema / properties / attachments
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  "title": "Attachments",
      +  "type": "array"
      +}
    • addedOutput schema / properties / attachments_delivery
      Added value: +{
      +  "additionalProperties": true,
      +  "title": "Attachments Delivery",
      +  "type": "object"
      +}
    • addedOutput schema / properties / close_date_description
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Close Date Description"
      +}
    • addedOutput schema / properties / enrichment_status
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Enrichment Status"
      +}
    • addedOutput schema / properties / field_status
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  "title": "Field Status",
      +  "type": "object"
      +}
    • addedOutput schema / properties / funding_amounts
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "type": "object"
      +  },
      +  "title": "Funding Amounts",
      +  "type": "array"
      +}
    • addedOutput schema / properties / is_cost_sharing
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Is Cost Sharing"
      +}
    • addedOutput schema / properties / record_content_policy
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Record Content Policy"
      +}
    • addedOutput schema / properties / record_delivery
      Added value: +{
      +  "additionalProperties": true,
      +  "title": "Record Delivery",
      +  "type": "object"
      +}
    • addedOutput schema / properties / source_fetched_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Source Fetched At"
      +}
    • addedOutput schema / properties / source_updated_at
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Source Updated At"
      +}
    • changedOutput schema / properties / source_url / description
      Previous value: -"Deep link to the opportunity on Grants.gov for verification"New value: +"Deep link to the opportunity on Grants.gov or Simpler.Grants.gov for verification"
    • addedOutput schema / properties / source_version
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Source Version"
      +}
    • addedOutput schema / properties / summary_delivery
      Added value: +{
      +  "additionalProperties": true,
      +  "title": "Summary Delivery",
      +  "type": "object"
      +}
  2. Changed3 schema fields changed
    • addedOutput schema / $defs / QuotaBlock / properties / mode
      Added value: +{
      +  "default": "ordinary",
      +  "enum": [
      +    "ordinary",
      +    "testing",
      +    "review",
      +    "beta"
      +  ],
      +  "title": "Mode",
      +  "type": "string"
      +}
    • addedOutput schema / properties / record_type
      Added value: +{
      +  "const": "grant",
      +  "default": "grant",
      +  "title": "Record Type",
      +  "type": "string"
      +}
    • addedOutput schema / properties / source_name
      Added value: +{
      +  "default": "Grants.gov",
      +  "title": "Source Name",
      +  "type": "string"
      +}
  3. First observed

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already declare readOnly/idempotent/non-destructive/openWorld, so the safety profile is covered, but the description adds genuinely new behavioral context: every record carries a source link or source name plus record ID for verification, plus the framing constraint that results must not be presented as an eligibility determination. It also discloses call accounting (one accepted call = one use, free follow-ups after a search), which annotations cannot express.

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?

Three leading sentences are legal/attribution boilerplate ('Not affiliated with the U.S. government, GSA, or SAM.gov. Not a U.S. government service.'), pushing the actual statement of purpose into the fourth sentence. The remaining sentences are dense and useful, but the definition is not front-loaded on what the tool does.

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

Completeness4/5

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

An output schema exists and the input schema fully documents the sole parameter, so the description needn't explain return shapes; it appropriately focuses on verification and citation behavior and use accounting. What's missing is only explicit sibling routing, which is a modest gap for a single-param read tool.

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 required parameter, so the schema already explains that opportunity_number comes from a search result. The description adds no additional format, example, or constraint information beyond that, making baseline 3 appropriate.

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 resource (one grant opportunity) and enumerates the record fields returned: eligibility applicant types, funding categories, award range, dates, summary. Sibling differentiation is only implicit (it's the record fetch behind search_grants_gov/search_open_grants), and it never distinguishes itself from get_record or get_notice_record by name.

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?

Usage context is implied rather than stated: the parameter is described as 'Opportunity number from a search result' and the billing note about follow-ups within 30 minutes after a search makes clear this tool is called after a search. However, there is no explicit guidance on when to use this versus the other record-fetching siblings, and no stated preconditions or exclusions.

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