GovInbox

Search reported subawards

search_subawards

Read-onlyIdempotent

Not affiliated with the U.S. government, GSA, or SAM.gov. Not a U.S. government service. Individual reported first-tier subaward records: which subcontractor worked under which prime, for how much. Filter by prime contractor name. Amounts are prime-reported subaward amounts, often incomplete or duplicated; they are not cash paid and not obligations. Not a partnership suggestion. Present as information only; do not frame results as a bid/no-bid recommendation, eligibility determination, or partnership recommendation. One search counts as one use, regardless of how many records are returned. Every record carries a direct source link (or source name and record ID) so you can verify and cite the underlying record.

Input Schema

Name	Required	Description	Default
`piid`	No
`sort`	No		amount_desc
`limit`	No	Maximum 50 records; minimum 1; default 20.
`naics`	No	NAICS prefixes, 2-6 digits
`prime`	No
`cursor`	No
`date_to`	No
`keyword`	No
`date_from`	No	Recorded subaward action date
`subaward_number`	No

Output Schema

Name	Required	Description	Default
`count`	Yes
`quota`	Yes
`coverage`	Yes
`subawards`	Yes
`data_caveat`	No	Data quality caveat	Amounts are prime-reported subaward amounts, often incomplete or duplicated; they are not cash paid and not obligations. Not a partnership suggestion.
`next_cursor`	No
`total_count`	No
`applied_filters`	No
`analytical_disclaimer`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed57 schema fields changedOct 24, 2026

addedInput schema / properties / cursor

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 2048,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Cursor"
+}

addedInput schema / properties / date_from

Added value: +{
+  "anyOf": [
+    {
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Recorded subaward action date",
+  "title": "Date From"
+}

addedInput schema / properties / date_to

Added value: +{
+  "anyOf": [
+    {
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Date To"
+}

addedInput schema / properties / keyword

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 200,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Keyword"
+}

addedInput schema / properties / limit / description

Added value: +"Maximum 50 records; minimum 1; default 20."

changedInput schema / properties / naics / description

Previous value: -"NAICS codes, 2-6 digits each; omit for all lanes"New value: +"NAICS prefixes, 2-6 digits"

addedInput schema / properties / piid

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 120,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Piid"
+}

removedInput schema / properties / prime / description

Removed value: -"Prime contractor name substring filter"

addedInput schema / properties / sort

Added value: +{
+  "default": "amount_desc",
+  "enum": [
+    "amount_desc",
+    "date_desc",
+    "date_asc"
+  ],
+  "title": "Sort",
+  "type": "string"
+}

addedInput schema / properties / subaward_number

Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 120,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Subaward Number"
+}

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 / $defs / SubawardDetailRow / properties / action_date

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Action Date"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / amount_null_reason

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Amount Null Reason"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / amount_type

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Amount Type"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / description

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Description"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / prime_award_key

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Prime Award Key"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / source_name

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Source Name"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / source_record_id

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Source Record Id"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / source_url_scope

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Source Url Scope"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / source_url_unavailable_reason

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Source Url Unavailable Reason"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / subaward_date

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Subaward Date"
+}

addedOutput schema / $defs / SubawardDetailRow / properties / subaward_number

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Subaward Number"
+}

addedOutput schema / properties / applied_filters

Added value: +{
+  "additionalProperties": true,
+  "title": "Applied Filters",
+  "type": "object"
+}

addedOutput schema / properties / next_cursor

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Next Cursor"
+}

addedOutput schema / properties / total_count

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Total Count"
+}

Changed1 schema field changedOct 18, 2026

addedOutput schema / $defs / QuotaBlock / properties / mode

Added value: +{
+  "default": "ordinary",
+  "enum": [
+    "ordinary",
+    "testing",
+    "review",
+    "beta"
+  ],
+  "title": "Mode",
+  "type": "string"
+}

First observedOct 14, 2026

TDQS

B3.3/5.0

Behavior5/5

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

Beyond the annotations, the description adds substantial behavioral context: it warns that amounts are prime-reported, often incomplete or duplicated, and not cash paid or obligations. It also states that one search counts as one use regardless of record count and that every record carries a source link for verification, which is valuable operational detail not present in annotations.

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 description contains useful content but is a single long paragraph that front-loads legal disclaimers before the tool's purpose. It also repeats the partnership caveat ('Not a partnership suggestion' and later 'do not frame results as ... partnership recommendation'), which reduces efficiency.

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?

The description is adequate for understanding the core data and its caveats, and an output schema exists to cover return values. However, with 10 parameters and only 30% schema description coverage, the description leaves several invocation details unexplained and does not help agents choose among similar siblings.

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 low at 30%, so the description should compensate for undocumented parameters. It only mentions filtering by prime contractor name, leaving parameters such as piid, sort, cursor, date_to, keyword, and subaward_number unexplained in the description; the schema titles alone provide limited semantic help.

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 the resource: individual reported first-tier subaward records showing which subcontractor worked under which prime and for how much. It is specific about scope and filtering by prime contractor, but it does not explicitly distinguish itself from similar siblings such as list_reported_subawards or find_teaming_partners.

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?

The description gives output-use constraints such as 'Present as information only' and 'do not frame results as a bid/no-bid recommendation', but it does not explain when to use this tool instead of similar siblings. There is no explicit when-to-use or when-not-to-use guidance, only implied usage from the record description.

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

All GovInbox tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?