GovInbox

Get GAO protest history for a solicitation

get_protest_history

Read-onlyIdempotent

Not affiliated with the U.S. government, GSA, or SAM.gov. Not a U.S. government service. GAO bid protest history for a federal solicitation number. Returns every published GAO protest decision tied to the solicitation, each protest's outcome (sustained, denied, dismissed, withdrawn), and a risk level: HIGH means a sustained protest on record within the last 120 days; MEDIUM means protest activity within 120 days; LOW means older history only; UNKNOWN means protest data is not loaded; CLEAR means no protests found. This corpus holds GAO decisions only - it cannot tell you whether a procurement is currently frozen by a pending protest. GAO FY2025: 1,737 cases closed, only 53 sustained (most resolved via corrective action, not sustain). Agency-level protests and Court of Federal Claims cases are NOT in this corpus - they are separate dockets. GAO decisions are public-domain U.S. government works and are recommendations, not binding law. GAO does not publish most dismissals and protests filed but not yet decided are not included, so verify status against the GAO bid protest docket 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, 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
`solicitation_number`	Yes	Federal solicitation number, e.g. W519TC-23-R-0111 or 36C24123Q0765

Output Schema

Name	Required	Description	Default
`quota`	Yes
`agency`	No
`summary`	Yes
`coverage`	Yes
`protests`	Yes
`risk_level`	Yes
`protest_count`	Yes
`agency_sustain_rate`	No
`solicitation_number`	Yes
`agency_protest_count`	No
`analytical_disclaimer`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed33 schema fields changedOct 24, 2026

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"
-]
```

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

A4.3/5.0

Behavior5/5

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

Annotations declare read-only/idempotent, and the description adds substantial context beyond them: the full risk-level taxonomy (HIGH/MEDIUM/LOW/UNKNOWN/CLEAR) with its 120-day window, corpus boundaries, data gaps, and the 30-minute follow-up billing rule. This is exactly the kind of behavioral detail annotations cannot carry.

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 risk-level legend and corpus limitations earn their place and the purpose is front-loaded, but the opening disclaimer is redundant ('Not affiliated with the U.S. government, GSA, or SAM.gov. Not a U.S. government service.'), and the FY2025 statistics plus public-domain discussion are tangential to invoking the tool correctly.

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?

An output schema exists so return shape is covered, and the description still supplies the interpretive key for the risk classification that the schema alone would not convey. Combined with corpus scoping and verification advice, nothing needed to call and interpret it is missing.

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?

Only one parameter and schema coverage is 100%, with an example format already in the schema ('W519TC-23-R-0111'). The description adds no further guidance on solicitation-number formatting or normalization, so baseline 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?

States a specific verb and resource ('GAO bid protest history for a federal solicitation number') and immediately delimits it: 'This corpus holds GAO decisions only', excluding agency-level protests and Court of Federal Claims dockets. An agent can distinguish this from siblings like check_risk or get_far_clause without opening any schema.

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?

Explicitly frames when-not-to-rely: pending protests aren't covered, dismissals are mostly unpublished, and the agent is told to 'verify status against the GAO bid protest docket before acting.' It gives a clear context of use but never names a sibling alternative, so it stops short of full when/when-not/alternatives.

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?