GovInbox

Show the GovInbox dashboard

show_govinbox

Read-onlyIdempotent

Not affiliated with the U.S. government, GSA, or SAM.gov. Not a U.S. government service. Open the free visual GovInbox preview before searching, including when a search allowance is exhausted. No account is required to see this preview. It runs no search, applies no filters, uses no search allowance and returns no matched notices. It reads only public stored notice facts for up to three unfiltered examples first recorded today or yesterday in America/Los_Angeles, with their actual recording dates and source links. Older or expired examples are omitted. These are recorded data, not a live verification of SAM.gov. Use search_opportunities for actual filtered results.

Input Schema

Name	Required	Description	Default
No arguments

Output Schema

Name	Required	Default
`count`	No
`preview_date`	No
`preview_only`	No
`opportunities`	No
`preview_as_of`	No
`preview_cached`	No
`preview_notice`	No	No stored examples first recorded today or yesterday are available. No search was run and no search allowance was used.
`preview_source`	No	GovInbox stored SAM.gov notices
`applied_filters`	No
`preview_examples`	No
`preview_timezone`	No	America/Los_Angeles
`preview_freshness`	No	unavailable

Schema Changelog

Changes observed during successful MCP inspections.

Changed13 schema fields changedOct 24, 2026

addedOutput schema / $defs / OpportunityCard / properties / match_explanation

Added value: +{
+  "additionalProperties": true,
+  "title": "Match Explanation",
+  "type": "object"
+}

addedOutput schema / $defs / OpportunityCard / properties / place_state

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Recorded structured place-of-performance state, never buyer location",
+  "title": "Place State"
+}

addedOutput schema / $defs / OpportunityCard / properties / provenance

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

addedOutput schema / $defs / PublicPreviewExample

Added value: +{
+  "description": "Public notice fields with their actual GovInbox recording timestamp.",
+  "properties": {
+    "buyer_office": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Buyer Office"
+    },
+    "expires_at": {
+      "description": "Parsed recorded deadline normalized to an offset-bearing UTC timestamp; raw_deadline is preserved separately",
+      "title": "Expires At",
+      "type": "string"
+    },
+    "match_explanation": {
+      "additionalProperties": true,
+      "title": "Match Explanation",
+      "type": "object"
+    },
+    "naics": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Naics",
+      "type": "array"
+    },
+    "notice_id": {
+      "title": "Notice Id",
+      "type": "string"
+    },
+    "notice_type": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Notice Type"
+    },
+    "place": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "additionalProperties": true,
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Place"
+    },
+    "place_state": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Recorded structured place-of-performance state, never buyer location",
+      "title": "Place State"
+    },
+    "posted_date": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Posted Date"
+    },
+    "provenance": {
+      "additionalProperties": true,
+      "title": "Provenance",
+      "type": "object"
+    },
+    "record_status": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Record Status"
+    },
+    "recorded_at": {
+      "title": "Recorded At",
+      "type": "string"
+    },
+    "recorded_deadline": {
+      "anyOf": [
+        {
+          "additionalProperties": true,
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Recorded Deadline"
+    },
+    "sam_gov_url": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Sam Gov Url"
+    },
+    "set_aside_code": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Set Aside Code"
+    },
+    "solicitation_number": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Solicitation Number"
+    },
+    "source_name": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Source Name"
+    },
+    "source_url": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Source Url"
+    },
+    "title": {
+      "title": "Title",
+      "type": "string"
+    },
+    "why_matched": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Why Matched"
+    }
+  },
+  "required": [
+    "notice_id",
+    "title",
+    "recorded_at",
+    "expires_at"
+  ],
+  "title": "PublicPreviewExample",
+  "type": "object"
+}

changedOutput schema / description

Previous value: -"Static widget entry; never claims a search, quota state or matches."New value: +"Dated public examples; never claims a search, quota state or matches."

addedOutput schema / properties / preview_as_of

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

addedOutput schema / properties / preview_cached

Added value: +{
+  "default": false,
+  "title": "Preview Cached",
+  "type": "boolean"
+}

addedOutput schema / properties / preview_date

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

addedOutput schema / properties / preview_examples

Added value: +{
+  "items": {
+    "$ref": "#/$defs/PublicPreviewExample"
+  },
+  "title": "Preview Examples",
+  "type": "array"
+}

addedOutput schema / properties / preview_freshness

Added value: +{
+  "default": "unavailable",
+  "enum": [
+    "today",
+    "yesterday",
+    "unavailable"
+  ],
+  "title": "Preview Freshness",
+  "type": "string"
+}

changedOutput schema / properties / preview_notice / default

Previous value: -"Unfiltered visual examples only. No search was run and no search allowance was used."New value: +"No stored examples first recorded today or yesterday are available. No search was run and no search allowance was used."

addedOutput schema / properties / preview_source

Added value: +{
+  "const": "GovInbox stored SAM.gov notices",
+  "default": "GovInbox stored SAM.gov notices",
+  "title": "Preview Source",
+  "type": "string"
+}

addedOutput schema / properties / preview_timezone

Added value: +{
+  "const": "America/Los_Angeles",
+  "default": "America/Los_Angeles",
+  "title": "Preview Timezone",
+  "type": "string"
+}

Changed2 schema fields changedOct 18, 2026

addedOutput schema / $defs / OpportunityCard / properties / record_status

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

addedOutput schema / $defs / OpportunityCard / properties / solicitation_number

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

AddedOct 16, 2026

TDQS

A4.3/5.0

Behavior5/5

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

Annotations already declare read-only and non-destructive, and the description goes well beyond them: it discloses that it consumes no search allowance, applies no filters, returns no matched notices, reads only stored public facts, caps at three examples from today/yesterday in America/Los_Angeles, omits older data, and is not a live SAM.gov verification. That is unusually detailed behavioral context for a zero-parameter call.

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 most important information is not front-loaded: two sentences of government-affiliation disclaimers precede the actual function. The remaining sentences are dense but also repeat the no-allowance/no-filter point twice, costing efficiency.

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, so return-value detail is not required, yet the description still specifies the shape of the preview (up to three examples, recording dates, source links). It is thorough for a simple preview tool, with only mild redundancy.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, so the baseline is 4; the description correctly reinforces that no filters or inputs are accepted, which matches the empty schema.

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 states a concrete action and resource: open the visual GovInbox preview, and it explicitly contrasts itself with search_opportunities. The purpose is clear, though the actual function is buried behind two full sentences of legal disclaimers.

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

Usage Guidelines5/5

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

It names the situation to use it ('before searching, including when a search allowance is exhausted') and the alternative ('Use search_opportunities for actual filtered results'). Both the trigger and the exclusion are explicit.

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?