GovGazette
Find federal contracting opportunities, research awards and vendors, and review exclusion evidence.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~11,517Tokens (tool definitions)
~7.9 KBTypical response size
Significant attention impact (9.00% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"govgazette": {
"url": "https://govgazette.com/api/v1/mcp"
}
}
}Remote endpoints
https://govgazette.com/api/v1/mcpstreamable-httpWhat it can do
Tool inventory
Tools (17)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢check_exclusions(generation, identities)
Check 1 to 20 identities against a dated active SAM snapshot. Pass identities as an array of objects, not a record ID or page URL. Each identity needs a name, UEI, CAGE, or NPI. Exact identifier matches and name-only possible matches remain distinct. Read coverage.freshness; stale or unknown-source empty lookups report unavailable with snapshot_status no_match_in_snapshot. No match is not clearance.
Input Schema
{
"type": "object",
"properties": {
"generation": {
"description": "Retained snapshot UUID; omit for the current snapshot.",
"type": [
"string",
"null"
]
},
"identities": {
"description": "One to twenty identities to compare with the dated SAM snapshot.",
"items": {
"$ref": "#/$defs/Identity"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"required": [
"identities"
],
"$defs": {
"Identity": {
"additionalProperties": false,
"properties": {
"cage": {
"description": "Exact five-character CAGE code, when known.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Person or organization name, within 256 UTF-8 bytes; name-only matches are possible matches.",
"type": [
"string",
"null"
]
},
"npi": {
"description": "Exact ten-digit National Provider Identifier, when known.",
"type": [
"string",
"null"
]
},
"uei": {
"description": "Exact 12-character Unique Entity ID, when known.",
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"coverage": {
"$ref": "#/$defs/ExclusionCoverage"
},
"generation": {
"type": "string"
},
"results": {
"items": {
"$ref": "#/$defs/ExclusionMatch"
},
"type": "array"
}
},
"required": [
"generation",
"results",
"coverage"
],
"$defs": {
"ExclusionCoverage": {
"properties": {
"freshness": {
"$ref": "#/$defs/SourceFreshness",
"description": "Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."
},
"observed_at": {
"description": "Observation time does not replace the official source timestamp.",
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"source_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"status": {
"description": "Present as unavailable when no SAM coverage exists in this generation.",
"type": [
"string",
"null"
]
}
},
"required": [
"freshness"
],
"type": "object"
},
"ExclusionMatch": {
"properties": {
"identity": {
"$ref": "#/$defs/Identity"
},
"records": {
"description": "Candidate exclusion records with match basis; not a clearance decision.",
"items": {
"$ref": "#/$defs/JsonObject"
},
"type": "array"
},
"snapshot_status": {
"description": "Observed lookup outcome in the dated snapshot, even when status is unavailable.",
"type": "string"
},
"status": {
"description": "Exact or possible match, fresh-snapshot no-match, or unavailable. Stale,\nunknown and missing sources never produce a clean no-match status.",
"type": "string"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"identity",
"status",
"snapshot_status",
"records",
"truncated"
],
"type": "object"
},
"FreshnessState": {
"enum": [
"fresh",
"stale",
"unknown",
"unavailable"
],
"type": "string"
},
"Identity": {
"additionalProperties": false,
"properties": {
"cage": {
"description": "Exact five-character CAGE code, when known.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Person or organization name, within 256 UTF-8 bytes; name-only matches are possible matches.",
"type": [
"string",
"null"
]
},
"npi": {
"description": "Exact ten-digit National Provider Identifier, when known.",
"type": [
"string",
"null"
]
},
"uei": {
"description": "Exact 12-character Unique Entity ID, when known.",
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
},
"SourceFreshness": {
"properties": {
"attention_required": {
"type": "boolean"
},
"evaluated_at": {
"description": "UTC time when age was evaluated; source and observation dates are unchanged.",
"type": "string"
},
"max_age_seconds": {
"description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
"format": "int64",
"type": "integer"
},
"source_age_seconds": {
"description": "Age of the official source timestamp, never the import or enrichment timestamp.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"state": {
"$ref": "#/$defs/FreshnessState"
},
"warn_age_seconds": {
"description": "Early-warning boundary, separate from the stale-source boundary.",
"format": "int64",
"type": "integer"
},
"warning": {
"description": "User-facing warning, or null when within the warning threshold.",
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"evaluated_at",
"max_age_seconds",
"warn_age_seconds",
"attention_required"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡create_saved_search(criteria, name)
Create one private saved opportunity search with the supplied name and criteria. Requires authenticated workspace access and explicit user intent. Creates an account workspace if needed and adds a search without replacing existing searches. Returns a private feed link. The first successful check establishes a baseline; no email or external notification is sent.
Input Schema
{
"type": "object",
"properties": {
"criteria": {
"$ref": "#/$defs/OpportunityQuery",
"description": "Opportunity filters to save; generation, after and limit are reset by the server."
},
"name": {
"description": "Human-readable name for the new saved search; 1 to 100 UTF-8 bytes after trimming.",
"type": "string"
}
},
"required": [
"name",
"criteria"
],
"$defs": {
"OpportunityQuery": {
"additionalProperties": false,
"properties": {
"active": {
"description": "Filter by source active status; this does not mean the response deadline is open.",
"type": [
"boolean",
"null"
]
},
"after": {
"description": "Last notice ID from next_after in the preceding page.",
"type": [
"string",
"null"
]
},
"agency": {
"description": "Agency code on the source notice.",
"type": [
"string",
"null"
]
},
"generation": {
"description": "Retained generation UUID from a prior result for a consistent snapshot.",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum notices to return, from 1 to 50; defaults to 25.",
"format": "uint",
"maximum": 50,
"minimum": 1,
"type": [
"integer",
"null"
]
},
"naics": {
"description": "Two- to six-digit NAICS industry code from a notice or the NAICS reference collection.",
"type": [
"string",
"null"
]
},
"q": {
"default": "",
"description": "Plain-language keywords; empty returns notices matching the other filters.",
"type": "string"
},
"set_aside": {
"description": "Official set-aside code from a notice or the set-asides reference collection.",
"type": [
"string",
"null"
]
},
"state": {
"description": "State or territory code for the place of performance.",
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"feed_path": {
"description": "Private capability path; do not share it publicly.",
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"description": "First successful check establishes a baseline, not delivered changes.",
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"id",
"status",
"feed_path",
"message"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴delete_saved_search(id)
Permanently delete one saved search owned by the authenticated private workspace, including its baseline, retained change events and feed link. Requires explicit user intent; does not delete other searches or public records.
Input Schema
{
"type": "object",
"properties": {
"id": {
"description": "Saved search UUID returned by create_saved_search or list_saved_searches, owned by this workspace.",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"deleted": {
"type": "boolean"
}
},
"required": [
"deleted"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴delete_saved_search_workspace
Permanently delete the authenticated private saved-search workspace and all its searches, baselines, change events and feed links. Requires explicit user intent to delete the entire workspace. Does not delete the GovGazette login account, public records or another workspace.
Input Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"deleted": {
"type": "boolean"
}
},
"required": [
"deleted"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢detail(collection, generation, id)
Retrieve a public record using the exact collection and id returned by search, never a page URL, title or slug. Supply the returned generation for a consistent result.
Input Schema
{
"type": "object",
"properties": {
"collection": {
"description": "Public collection name returned by search.",
"type": "string"
},
"generation": {
"description": "Retained generation UUID from search for a consistent record snapshot.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Exact stable record ID returned by search, not a page URL or slug.",
"type": "string"
}
},
"required": [
"collection",
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"award_coverage": {
"description": "Award snapshot age and latest official release evidence.",
"items": {
"$ref": "#/$defs/AwardCoverage"
},
"type": [
"array",
"null"
]
},
"collection": {
"description": "Absent for curated reference records.",
"type": [
"string",
"null"
]
},
"coverage": {
"anyOf": [
{
"$ref": "#/$defs/ExclusionCoverage"
},
{
"type": "null"
}
],
"description": "Present for exclusions, including explicit source-age warnings."
},
"data": {
"$ref": "#/$defs/JsonObject"
},
"generation": {
"type": "string"
},
"id": {
"type": "string"
},
"text": {
"type": "string"
},
"text_has_more": {
"description": "Whether another text chunk is available.",
"type": [
"boolean",
"null"
]
},
"text_length": {
"description": "Total text characters; absent from internal brief notices.",
"format": "uint",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"title": {
"type": "string"
}
},
"required": [
"generation",
"id",
"title",
"text",
"data"
],
"$defs": {
"AwardAvailability": {
"properties": {
"artifact_http_status": {
"format": "uint16",
"maximum": 65535,
"minimum": 0,
"type": [
"integer",
"null"
]
},
"check_interval_seconds": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"checked_at": {
"type": [
"string",
"null"
]
},
"failure_kind": {
"type": [
"string",
"null"
]
},
"failure_retry_seconds": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"failure_stage": {
"type": [
"string",
"null"
]
},
"inventory_http_status": {
"format": "uint16",
"maximum": 65535,
"minimum": 0,
"type": [
"integer",
"null"
]
},
"latest_release_date": {
"type": [
"string",
"null"
]
},
"latest_release_url": {
"type": [
"string",
"null"
]
},
"max_check_age_seconds": {
"format": "int64",
"type": "integer"
},
"state": {
"type": "string"
}
},
"required": [
"state",
"check_interval_seconds",
"failure_retry_seconds",
"max_check_age_seconds"
],
"type": "object"
},
"AwardCoverage": {
"properties": {
"dataset": {
"type": "string"
},
"freshness": {
"$ref": "#/$defs/AwardFreshness"
},
"source_date": {
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"dataset",
"source_date",
"source_url",
"freshness"
],
"type": "object"
},
"AwardFreshness": {
"properties": {
"age_state": {
"type": "string"
},
"age_warning_after_days": {
"format": "int64",
"type": "integer"
},
"effective_source_date": {
"type": [
"string",
"null"
]
},
"source_age_days": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"upstream": {
"$ref": "#/$defs/AwardAvailability"
},
"warning": {
"type": [
"string",
"null"
]
}
},
"required": [
"age_state",
"age_warning_after_days",
"upstream"
],
"type": "object"
},
"ExclusionCoverage": {
"properties": {
"freshness": {
"$ref": "#/$defs/SourceFreshness",
"description": "Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."
},
"observed_at": {
"description": "Observation time does not replace the official source timestamp.",
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"source_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"status": {
"description": "Present as unavailable when no SAM coverage exists in this generation.",
"type": [
"string",
"null"
]
}
},
"required": [
"freshness"
],
"type": "object"
},
"FreshnessState": {
"enum": [
"fresh",
"stale",
"unknown",
"unavailable"
],
"type": "string"
},
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
},
"SourceFreshness": {
"properties": {
"attention_required": {
"type": "boolean"
},
"evaluated_at": {
"description": "UTC time when age was evaluated; source and observation dates are unchanged.",
"type": "string"
},
"max_age_seconds": {
"description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
"format": "int64",
"type": "integer"
},
"source_age_seconds": {
"description": "Age of the official source timestamp, never the import or enrichment timestamp.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"state": {
"$ref": "#/$defs/FreshnessState"
},
"warn_age_seconds": {
"description": "Early-warning boundary, separate from the stale-source boundary.",
"format": "int64",
"type": "integer"
},
"warning": {
"description": "User-facing warning, or null when within the warning threshold.",
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"evaluated_at",
"max_age_seconds",
"warn_age_seconds",
"attention_required"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢document(collection, generation, id, length, offset)
Read official record text using the exact collection, id and generation returned by search. Start at offset 0 with length 1 to 16,000 characters, then use next_offset unchanged for the next chunk. Does not fetch arbitrary URLs or paths.
Input Schema
{
"type": "object",
"properties": {
"collection": {
"description": "Public record collection returned by search.",
"type": "string"
},
"generation": {
"description": "Retained snapshot UUID; omit for the current snapshot.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Stable ID of a known public record.",
"type": "string"
},
"length": {
"description": "Characters to return, from 1 to 16,000. Smaller chunks may be needed to fit the response byte budget.",
"format": "uint64",
"maximum": 16000,
"minimum": 1,
"type": [
"integer",
"null"
]
},
"offset": {
"description": "Character offset for the next bounded text chunk.",
"format": "uint64",
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"required": [
"collection",
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"coverage": {
"anyOf": [
{
"$ref": "#/$defs/ExclusionCoverage"
},
{
"type": "null"
}
],
"description": "Present for exclusion text chunks, with the same source-age policy as detail."
},
"document_kind": {
"type": "string"
},
"generation": {
"type": "string"
},
"id": {
"type": "string"
},
"next_offset": {
"format": "uint",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"offset": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"provenance": {
"anyOf": [
{
"$ref": "#/$defs/JsonObject"
},
{
"type": "null"
}
],
"description": "Source metadata attached to the retained record."
},
"text": {
"type": "string"
}
},
"required": [
"generation",
"id",
"text",
"offset",
"document_kind"
],
"$defs": {
"ExclusionCoverage": {
"properties": {
"freshness": {
"$ref": "#/$defs/SourceFreshness",
"description": "Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."
},
"observed_at": {
"description": "Observation time does not replace the official source timestamp.",
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"source_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"status": {
"description": "Present as unavailable when no SAM coverage exists in this generation.",
"type": [
"string",
"null"
]
}
},
"required": [
"freshness"
],
"type": "object"
},
"FreshnessState": {
"enum": [
"fresh",
"stale",
"unknown",
"unavailable"
],
"type": "string"
},
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
},
"SourceFreshness": {
"properties": {
"attention_required": {
"type": "boolean"
},
"evaluated_at": {
"description": "UTC time when age was evaluated; source and observation dates are unchanged.",
"type": "string"
},
"max_age_seconds": {
"description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
"format": "int64",
"type": "integer"
},
"source_age_seconds": {
"description": "Age of the official source timestamp, never the import or enrichment timestamp.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"state": {
"$ref": "#/$defs/FreshnessState"
},
"warn_age_seconds": {
"description": "Early-warning boundary, separate from the stale-source boundary.",
"format": "int64",
"type": "integer"
},
"warning": {
"description": "User-facing warning, or null when within the warning threshold.",
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"evaluated_at",
"max_age_seconds",
"warn_age_seconds",
"attention_required"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢exclusion_changes(cursor, from_generation, limit, to_generation)
Compare two retained snapshots. No longer observed does not mean reinstated; enrichment-only changes are excluded.
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Opaque next_cursor from an earlier change page.",
"type": [
"string",
"null"
]
},
"from_generation": {
"description": "Older retained snapshot UUID to compare.",
"type": "string"
},
"limit": {
"description": "Maximum changes to return, up to the service page limit.",
"format": "uint",
"maximum": 50,
"minimum": 1,
"type": [
"integer",
"null"
]
},
"to_generation": {
"description": "Newer retained snapshot UUID; omit for the current snapshot.",
"type": [
"string",
"null"
]
}
},
"required": [
"from_generation"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"from_coverage": {
"$ref": "#/$defs/ExclusionCoverage"
},
"from_generation": {
"type": "string"
},
"items": {
"items": {
"$ref": "#/$defs/ExclusionChange"
},
"type": "array"
},
"meaning": {
"type": "string"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"to_coverage": {
"$ref": "#/$defs/ExclusionCoverage"
},
"to_generation": {
"type": "string"
}
},
"required": [
"from_generation",
"to_generation",
"from_coverage",
"to_coverage",
"items",
"meaning"
],
"$defs": {
"ExclusionChange": {
"properties": {
"change": {
"type": "string"
},
"id": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"title",
"change"
],
"type": "object"
},
"ExclusionCoverage": {
"properties": {
"freshness": {
"$ref": "#/$defs/SourceFreshness",
"description": "Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."
},
"observed_at": {
"description": "Observation time does not replace the official source timestamp.",
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"source_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"status": {
"description": "Present as unavailable when no SAM coverage exists in this generation.",
"type": [
"string",
"null"
]
}
},
"required": [
"freshness"
],
"type": "object"
},
"FreshnessState": {
"enum": [
"fresh",
"stale",
"unknown",
"unavailable"
],
"type": "string"
},
"SourceFreshness": {
"properties": {
"attention_required": {
"type": "boolean"
},
"evaluated_at": {
"description": "UTC time when age was evaluated; source and observation dates are unchanged.",
"type": "string"
},
"max_age_seconds": {
"description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
"format": "int64",
"type": "integer"
},
"source_age_seconds": {
"description": "Age of the official source timestamp, never the import or enrichment timestamp.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"state": {
"$ref": "#/$defs/FreshnessState"
},
"warn_age_seconds": {
"description": "Early-warning boundary, separate from the stale-source boundary.",
"format": "int64",
"type": "integer"
},
"warning": {
"description": "User-facing warning, or null when within the warning threshold.",
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"evaluated_at",
"max_age_seconds",
"warn_age_seconds",
"attention_required"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢exclusion_context(generation, id)
Retrieve an exclusion with agency explanation, named restriction references, source evidence, explicit source-age warnings and supported business links.
Input Schema
{
"type": "object",
"properties": {
"generation": {
"description": "Retained snapshot UUID; omit for the current snapshot.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Stable exclusion record ID returned by search_exclusions or check_exclusions.",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"business_context": {
"$ref": "#/$defs/JsonObject",
"description": "Supported vendor and award links, with match basis."
},
"collection": {
"type": "string"
},
"coverage": {
"$ref": "#/$defs/ExclusionCoverage",
"description": "Dated SAM source coverage."
},
"data": {
"$ref": "#/$defs/JsonObject"
},
"generation": {
"type": "string"
},
"id": {
"type": "string"
},
"text": {
"type": "string"
},
"text_has_more": {
"type": "boolean"
},
"text_length": {
"format": "uint",
"minimum": 0,
"type": "integer"
},
"title": {
"type": "string"
}
},
"required": [
"generation",
"collection",
"id",
"title",
"text",
"data",
"text_length",
"text_has_more",
"coverage",
"business_context"
],
"$defs": {
"ExclusionCoverage": {
"properties": {
"freshness": {
"$ref": "#/$defs/SourceFreshness",
"description": "Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."
},
"observed_at": {
"description": "Observation time does not replace the official source timestamp.",
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"source_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"status": {
"description": "Present as unavailable when no SAM coverage exists in this generation.",
"type": [
"string",
"null"
]
}
},
"required": [
"freshness"
],
"type": "object"
},
"FreshnessState": {
"enum": [
"fresh",
"stale",
"unknown",
"unavailable"
],
"type": "string"
},
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
},
"SourceFreshness": {
"properties": {
"attention_required": {
"type": "boolean"
},
"evaluated_at": {
"description": "UTC time when age was evaluated; source and observation dates are unchanged.",
"type": "string"
},
"max_age_seconds": {
"description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
"format": "int64",
"type": "integer"
},
"source_age_seconds": {
"description": "Age of the official source timestamp, never the import or enrichment timestamp.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"state": {
"$ref": "#/$defs/FreshnessState"
},
"warn_age_seconds": {
"description": "Early-warning boundary, separate from the stale-source boundary.",
"format": "int64",
"type": "integer"
},
"warning": {
"description": "User-facing warning, or null when within the warning threshold.",
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"evaluated_at",
"max_age_seconds",
"warn_age_seconds",
"attention_required"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢explain_match(opportunity_id, vendor_id)
Explain deterministic primary NAICS overlap between a registered vendor and opportunity. Not an eligibility determination.
Input Schema
{
"type": "object",
"properties": {
"opportunity_id": {
"description": "Stable opportunity ID returned by search.",
"type": "string"
},
"vendor_id": {
"description": "Stable vendor ID returned by search.",
"type": "string"
}
},
"required": [
"vendor_id",
"opportunity_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"generation": {
"type": "string"
},
"interpretation": {
"type": "string"
},
"opportunity_id": {
"type": "string"
},
"rules": {
"items": {
"$ref": "#/$defs/MatchRule"
},
"type": "array"
},
"vendor_id": {
"type": "string"
}
},
"required": [
"generation",
"vendor_id",
"opportunity_id",
"rules",
"interpretation"
],
"$defs": {
"MatchRule": {
"properties": {
"matched": {
"type": "boolean"
},
"opportunity_value": {
"type": [
"string",
"null"
]
},
"rule": {
"type": "string"
},
"vendor_value": {
"type": [
"string",
"null"
]
}
},
"required": [
"rule",
"matched"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢freshness
Report actual source dates, coverage, record counts and SHA256 provenance.
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"generation": {
"type": "string"
},
"history": {
"type": "string"
},
"history_coverage": {
"$ref": "#/$defs/NoticeHistoryCoverage",
"description": "Notice snapshot coverage, retired fiscal-year archives and the dated retention policy."
},
"sources": {
"items": {
"$ref": "#/$defs/SourceCoverage"
},
"type": "array"
}
},
"required": [
"generation",
"sources",
"history",
"history_coverage"
],
"$defs": {
"AwardAvailability": {
"properties": {
"artifact_http_status": {
"format": "uint16",
"maximum": 65535,
"minimum": 0,
"type": [
"integer",
"null"
]
},
"check_interval_seconds": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"checked_at": {
"type": [
"string",
"null"
]
},
"failure_kind": {
"type": [
"string",
"null"
]
},
"failure_retry_seconds": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"failure_stage": {
"type": [
"string",
"null"
]
},
"inventory_http_status": {
"format": "uint16",
"maximum": 65535,
"minimum": 0,
"type": [
"integer",
"null"
]
},
"latest_release_date": {
"type": [
"string",
"null"
]
},
"latest_release_url": {
"type": [
"string",
"null"
]
},
"max_check_age_seconds": {
"format": "int64",
"type": "integer"
},
"state": {
"type": "string"
}
},
"required": [
"state",
"check_interval_seconds",
"failure_retry_seconds",
"max_check_age_seconds"
],
"type": "object"
},
"AwardFreshness": {
"properties": {
"age_state": {
"type": "string"
},
"age_warning_after_days": {
"format": "int64",
"type": "integer"
},
"effective_source_date": {
"type": [
"string",
"null"
]
},
"source_age_days": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"upstream": {
"$ref": "#/$defs/AwardAvailability"
},
"warning": {
"type": [
"string",
"null"
]
}
},
"required": [
"age_state",
"age_warning_after_days",
"upstream"
],
"type": "object"
},
"FreshnessState": {
"enum": [
"fresh",
"stale",
"unknown",
"unavailable"
],
"type": "string"
},
"NoticeArchiveCoverage": {
"properties": {
"dataset": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"retired_on": {
"type": [
"string",
"null"
]
},
"state": {
"type": "string"
}
},
"required": [
"dataset",
"state"
],
"type": "object"
},
"NoticeHistoryCoverage": {
"properties": {
"archives": {
"items": {
"$ref": "#/$defs/NoticeArchiveCoverage"
},
"type": "array"
},
"complete_historical_archive": {
"type": "boolean"
},
"current_dataset": {
"type": "string"
},
"current_source_date": {
"type": [
"string",
"null"
]
},
"remaining_coverage": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"scope",
"current_dataset",
"complete_historical_archive",
"remaining_coverage",
"archives"
],
"type": "object"
},
"SourceCoverage": {
"properties": {
"award_freshness": {
"anyOf": [
{
"$ref": "#/$defs/AwardFreshness"
},
{
"type": "null"
}
],
"description": "Award age and latest official release evidence, independent of publication or scheduler state."
},
"dataset": {
"type": "string"
},
"exclusion_freshness": {
"anyOf": [
{
"$ref": "#/$defs/SourceFreshness"
},
{
"type": "null"
}
]
},
"input_rows": {
"format": "int64",
"type": "integer"
},
"public_rows": {
"format": "int64",
"type": "integer"
},
"reference_edition": {
"type": [
"string",
"null"
]
},
"reference_scope": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": "string"
},
"source_date": {
"type": "string"
},
"source_date_kind": {
"description": "Meaning of the supplied date; not an importer or scheduler timestamp.",
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"dataset",
"source_url",
"source_date",
"sha256",
"input_rows",
"public_rows",
"source_date_kind"
],
"type": "object"
},
"SourceFreshness": {
"properties": {
"attention_required": {
"type": "boolean"
},
"evaluated_at": {
"description": "UTC time when age was evaluated; source and observation dates are unchanged.",
"type": "string"
},
"max_age_seconds": {
"description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
"format": "int64",
"type": "integer"
},
"source_age_seconds": {
"description": "Age of the official source timestamp, never the import or enrichment timestamp.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"state": {
"$ref": "#/$defs/FreshnessState"
},
"warn_age_seconds": {
"description": "Early-warning boundary, separate from the stale-source boundary.",
"format": "int64",
"type": "integer"
},
"warning": {
"description": "User-facing warning, or null when within the warning threshold.",
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"evaluated_at",
"max_age_seconds",
"warn_age_seconds",
"attention_required"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_saved_search_events(id)
Read the latest 100 retained change observations for one saved search owned by the authenticated private workspace. Does not change the search. Retention and missing intermediate observations are explicit; observations are not proof of delivered notifications.
Input Schema
{
"type": "object",
"properties": {
"id": {
"description": "Saved search UUID returned by create_saved_search or list_saved_searches, owned by this workspace.",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"events": {
"description": "Up to the latest 100 observed changes, newest first.",
"items": {
"$ref": "#/$defs/JsonObject"
},
"type": "array"
},
"retention": {
"$ref": "#/$defs/SavedSearchRetention"
}
},
"required": [
"events",
"retention"
],
"$defs": {
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
},
"SavedSearchRetention": {
"properties": {
"definition": {
"type": "string"
},
"discarded_observations": {
"format": "int64",
"type": "integer"
},
"limit": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"truncated": {
"type": "boolean"
}
},
"required": [
"limit",
"discarded_observations",
"truncated",
"definition"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢list_saved_searches
List the saved opportunity searches in the authenticated private workspace, including criteria, status and change counts. Does not change searches. Requires workspace Authorization headers on /mcp or account OAuth on /account/mcp; never accept keys in tool arguments.
Input Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"watches": {
"description": "Each saved search includes its ID, status, criteria and event count.",
"items": {
"$ref": "#/$defs/JsonObject"
},
"type": "array"
}
},
"required": [
"watches"
],
"$defs": {
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢research_opportunity(generation, id)
Build a cited research brief with retained notice requirements, exact award-number candidates and same-industry comparisons. Does not infer an incumbent or eligibility.
Input Schema
{
"type": "object",
"properties": {
"generation": {
"description": "Retained generation UUID from search_opportunities.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Stable opportunity ID returned by search_opportunities.",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"comparison_awards": {
"items": {
"$ref": "#/$defs/AwardSummary"
},
"type": "array"
},
"generation": {
"type": "string"
},
"linked_awards": {
"items": {
"$ref": "#/$defs/AwardSummary"
},
"type": "array"
},
"next_steps": {
"items": {
"type": "string"
},
"type": "array"
},
"notice": {
"$ref": "#/$defs/RecordDetail"
},
"relationship_basis": {
"type": "string"
},
"requirements": {
"$ref": "#/$defs/BriefRequirements"
}
},
"required": [
"generation",
"notice",
"linked_awards",
"comparison_awards",
"relationship_basis",
"requirements",
"next_steps"
],
"$defs": {
"AwardAvailability": {
"properties": {
"artifact_http_status": {
"format": "uint16",
"maximum": 65535,
"minimum": 0,
"type": [
"integer",
"null"
]
},
"check_interval_seconds": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"checked_at": {
"type": [
"string",
"null"
]
},
"failure_kind": {
"type": [
"string",
"null"
]
},
"failure_retry_seconds": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"failure_stage": {
"type": [
"string",
"null"
]
},
"inventory_http_status": {
"format": "uint16",
"maximum": 65535,
"minimum": 0,
"type": [
"integer",
"null"
]
},
"latest_release_date": {
"type": [
"string",
"null"
]
},
"latest_release_url": {
"type": [
"string",
"null"
]
},
"max_check_age_seconds": {
"format": "int64",
"type": "integer"
},
"state": {
"type": "string"
}
},
"required": [
"state",
"check_interval_seconds",
"failure_retry_seconds",
"max_check_age_seconds"
],
"type": "object"
},
"AwardCoverage": {
"properties": {
"dataset": {
"type": "string"
},
"freshness": {
"$ref": "#/$defs/AwardFreshness"
},
"source_date": {
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"dataset",
"source_date",
"source_url",
"freshness"
],
"type": "object"
},
"AwardFreshness": {
"properties": {
"age_state": {
"type": "string"
},
"age_warning_after_days": {
"format": "int64",
"type": "integer"
},
"effective_source_date": {
"type": [
"string",
"null"
]
},
"source_age_days": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"upstream": {
"$ref": "#/$defs/AwardAvailability"
},
"warning": {
"type": [
"string",
"null"
]
}
},
"required": [
"age_state",
"age_warning_after_days",
"upstream"
],
"type": "object"
},
"AwardSummary": {
"properties": {
"data": {
"$ref": "#/$defs/JsonObject"
},
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"vendor_url": {
"description": "Vendor path when an exact recipient UEI is available.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title",
"data",
"url"
],
"type": "object"
},
"BriefRequirements": {
"properties": {
"scope": {
"type": "string"
},
"source": {
"anyOf": [
{
"$ref": "#/$defs/JsonObject"
},
{
"type": "null"
}
],
"description": "Notice provenance for the retained text."
},
"text": {
"type": "string"
}
},
"required": [
"text",
"scope"
],
"type": "object"
},
"ExclusionCoverage": {
"properties": {
"freshness": {
"$ref": "#/$defs/SourceFreshness",
"description": "Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."
},
"observed_at": {
"description": "Observation time does not replace the official source timestamp.",
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"source_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"status": {
"description": "Present as unavailable when no SAM coverage exists in this generation.",
"type": [
"string",
"null"
]
}
},
"required": [
"freshness"
],
"type": "object"
},
"FreshnessState": {
"enum": [
"fresh",
"stale",
"unknown",
"unavailable"
],
"type": "string"
},
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
},
"RecordDetail": {
"properties": {
"award_coverage": {
"description": "Award snapshot age and latest official release evidence.",
"items": {
"$ref": "#/$defs/AwardCoverage"
},
"type": [
"array",
"null"
]
},
"collection": {
"description": "Absent for curated reference records.",
"type": [
"string",
"null"
]
},
"coverage": {
"anyOf": [
{
"$ref": "#/$defs/ExclusionCoverage"
},
{
"type": "null"
}
],
"description": "Present for exclusions, including explicit source-age warnings."
},
"data": {
"$ref": "#/$defs/JsonObject"
},
"generation": {
"type": "string"
},
"id": {
"type": "string"
},
"text": {
"type": "string"
},
"text_has_more": {
"description": "Whether another text chunk is available.",
"type": [
"boolean",
"null"
]
},
"text_length": {
"description": "Total text characters; absent from internal brief notices.",
"format": "uint",
"minimum": 0,
"type": [
"integer",
"null"
]
},
"title": {
"type": "string"
}
},
"required": [
"generation",
"id",
"title",
"text",
"data"
],
"type": "object"
},
"SourceFreshness": {
"properties": {
"attention_required": {
"type": "boolean"
},
"evaluated_at": {
"description": "UTC time when age was evaluated; source and observation dates are unchanged.",
"type": "string"
},
"max_age_seconds": {
"description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
"format": "int64",
"type": "integer"
},
"source_age_seconds": {
"description": "Age of the official source timestamp, never the import or enrichment timestamp.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"state": {
"$ref": "#/$defs/FreshnessState"
},
"warn_age_seconds": {
"description": "Early-warning boundary, separate from the stale-source boundary.",
"format": "int64",
"type": "integer"
},
"warning": {
"description": "User-facing warning, or null when within the warning threshold.",
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"evaluated_at",
"max_age_seconds",
"warn_age_seconds",
"attention_required"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴rotate_saved_search_feed(id)
Replace the private feed link for one saved search owned by the authenticated workspace, immediately revoking its previous link. Requires explicit user intent. Does not delete the search or its events. Keep the replacement link private; a lost response may mean the link changed and cannot be recovered by listing searches.
Input Schema
{
"type": "object",
"properties": {
"id": {
"description": "Saved search UUID returned by create_saved_search or list_saved_searches, owned by this workspace.",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"feed_path": {
"description": "Replacement private capability path; the previous link is revoked.",
"type": "string"
}
},
"required": [
"feed_path"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢search(collection, cursor, limit, q)
Search public opportunities, vendors, awards, exclusions, or reference collections. Results include provenance and a generation-pinned cursor.
Input Schema
{
"type": "object",
"properties": {
"collection": {
"description": "Public collection name, such as opportunities, vendors, awards, exclusions, or naics.",
"type": "string"
},
"cursor": {
"description": "Opaque next_cursor from the preceding search page.",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum records to return, from 1 to 50.",
"format": "uint",
"maximum": 50,
"minimum": 1,
"type": [
"integer",
"null"
]
},
"q": {
"default": "",
"description": "Plain-language search terms; empty lists the selected collection.",
"type": "string"
}
},
"required": [
"collection"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"award_coverage": {
"description": "Dated award coverage and official release availability, when applicable.",
"items": {
"$ref": "#/$defs/AwardCoverage"
},
"type": [
"array",
"null"
]
},
"collection": {
"description": "Collection searched, such as opportunities or awards.",
"type": "string"
},
"coverage": {
"anyOf": [
{
"$ref": "#/$defs/ExclusionCoverage"
},
{
"type": "null"
}
],
"description": "Exclusion-specific source age and freshness warnings, when applicable."
},
"coverage_url": {
"description": "Public source-date endpoint, when this collection supplies it.",
"type": [
"string",
"null"
]
},
"generation": {
"description": "UUID of the snapshot used for every result on this page.",
"type": "string"
},
"items": {
"description": "Matching public records.",
"items": {
"$ref": "#/$defs/RecordSummary"
},
"type": "array"
},
"next_cursor": {
"description": "Opaque cursor for the next page, or null at the end.",
"type": [
"string",
"null"
]
}
},
"required": [
"generation",
"collection",
"items"
],
"$defs": {
"AwardAvailability": {
"properties": {
"artifact_http_status": {
"format": "uint16",
"maximum": 65535,
"minimum": 0,
"type": [
"integer",
"null"
]
},
"check_interval_seconds": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"checked_at": {
"type": [
"string",
"null"
]
},
"failure_kind": {
"type": [
"string",
"null"
]
},
"failure_retry_seconds": {
"format": "uint64",
"minimum": 0,
"type": "integer"
},
"failure_stage": {
"type": [
"string",
"null"
]
},
"inventory_http_status": {
"format": "uint16",
"maximum": 65535,
"minimum": 0,
"type": [
"integer",
"null"
]
},
"latest_release_date": {
"type": [
"string",
"null"
]
},
"latest_release_url": {
"type": [
"string",
"null"
]
},
"max_check_age_seconds": {
"format": "int64",
"type": "integer"
},
"state": {
"type": "string"
}
},
"required": [
"state",
"check_interval_seconds",
"failure_retry_seconds",
"max_check_age_seconds"
],
"type": "object"
},
"AwardCoverage": {
"properties": {
"dataset": {
"type": "string"
},
"freshness": {
"$ref": "#/$defs/AwardFreshness"
},
"source_date": {
"type": "string"
},
"source_url": {
"type": "string"
}
},
"required": [
"dataset",
"source_date",
"source_url",
"freshness"
],
"type": "object"
},
"AwardFreshness": {
"properties": {
"age_state": {
"type": "string"
},
"age_warning_after_days": {
"format": "int64",
"type": "integer"
},
"effective_source_date": {
"type": [
"string",
"null"
]
},
"source_age_days": {
"format": "int64",
"type": [
"integer",
"null"
]
},
"upstream": {
"$ref": "#/$defs/AwardAvailability"
},
"warning": {
"type": [
"string",
"null"
]
}
},
"required": [
"age_state",
"age_warning_after_days",
"upstream"
],
"type": "object"
},
"ExclusionCoverage": {
"properties": {
"freshness": {
"$ref": "#/$defs/SourceFreshness",
"description": "Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."
},
"observed_at": {
"description": "Observation time does not replace the official source timestamp.",
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"source_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"status": {
"description": "Present as unavailable when no SAM coverage exists in this generation.",
"type": [
"string",
"null"
]
}
},
"required": [
"freshness"
],
"type": "object"
},
"FreshnessState": {
"enum": [
"fresh",
"stale",
"unknown",
"unavailable"
],
"type": "string"
},
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
},
"RecordSummary": {
"properties": {
"data": {
"$ref": "#/$defs/JsonObject",
"description": "Source-specific fields, including provenance and official identifiers."
},
"id": {
"description": "Stable identifier for a record in this generation.",
"type": "string"
},
"summary": {
"description": "Short searchable text, when returned by this operation.",
"type": [
"string",
"null"
]
},
"title": {
"description": "Human-readable record title.",
"type": "string"
},
"url": {
"description": "Public canonical path for the record.",
"type": "string"
}
},
"required": [
"id",
"title",
"url",
"data"
],
"type": "object"
},
"SourceFreshness": {
"properties": {
"attention_required": {
"type": "boolean"
},
"evaluated_at": {
"description": "UTC time when age was evaluated; source and observation dates are unchanged.",
"type": "string"
},
"max_age_seconds": {
"description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
"format": "int64",
"type": "integer"
},
"source_age_seconds": {
"description": "Age of the official source timestamp, never the import or enrichment timestamp.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"state": {
"$ref": "#/$defs/FreshnessState"
},
"warn_age_seconds": {
"description": "Early-warning boundary, separate from the stale-source boundary.",
"format": "int64",
"type": "integer"
},
"warning": {
"description": "User-facing warning, or null when within the warning threshold.",
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"evaluated_at",
"max_age_seconds",
"warn_age_seconds",
"attention_required"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢search_exclusions(agency, classification, country, cursor, effective_from, ...)
Filter active exclusion records by agency, program, classification, geography and dates. Limit is a maximum; large records can produce a smaller page with page_size_limited true. Continue with next_cursor and unchanged filters and limit. Preserve generation and read coverage.freshness for source age and warnings; results are dated evidence, not clearance.
Input Schema
{
"type": "object",
"properties": {
"agency": {
"description": "Excluding agency name or code.",
"type": [
"string",
"null"
]
},
"classification": {
"description": "Official SAM exclusion classification code or label.",
"type": [
"string",
"null"
]
},
"country": {
"description": "Country name or code in the exclusion record.",
"type": [
"string",
"null"
]
},
"cursor": {
"description": "Opaque next_cursor from a previous search response.",
"type": [
"string",
"null"
]
},
"effective_from": {
"description": "Include records effective on or after this ISO date.",
"type": [
"string",
"null"
]
},
"effective_to": {
"description": "Include records effective on or before this ISO date.",
"type": [
"string",
"null"
]
},
"generation": {
"description": "Retained snapshot UUID; omit for the current snapshot.",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum records to return, from 1 to 50. Large records may produce a smaller page; continue with next_cursor and unchanged filters and limit.",
"format": "uint",
"maximum": 50,
"minimum": 1,
"type": [
"integer",
"null"
]
},
"program": {
"description": "Exclusion program name or code.",
"type": [
"string",
"null"
]
},
"q": {
"description": "Name, identifier, or other text to find in active exclusion records.",
"type": [
"string",
"null"
]
},
"state": {
"description": "US state name or postal code in the exclusion record.",
"type": [
"string",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"coverage": {
"$ref": "#/$defs/ExclusionCoverage",
"description": "Dated source coverage, or an unavailable status."
},
"generation": {
"type": "string"
},
"items": {
"items": {
"$ref": "#/$defs/RecordSummary"
},
"type": "array"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"page_size_limited": {
"description": "Whole records were deferred to next_cursor to fit the response budget. Continue with the same filters and requested limit.",
"type": "boolean"
}
},
"required": [
"generation",
"items",
"page_size_limited",
"coverage"
],
"$defs": {
"ExclusionCoverage": {
"properties": {
"freshness": {
"$ref": "#/$defs/SourceFreshness",
"description": "Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."
},
"observed_at": {
"description": "Observation time does not replace the official source timestamp.",
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"source_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"status": {
"description": "Present as unavailable when no SAM coverage exists in this generation.",
"type": [
"string",
"null"
]
}
},
"required": [
"freshness"
],
"type": "object"
},
"FreshnessState": {
"enum": [
"fresh",
"stale",
"unknown",
"unavailable"
],
"type": "string"
},
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
},
"RecordSummary": {
"properties": {
"data": {
"$ref": "#/$defs/JsonObject",
"description": "Source-specific fields, including provenance and official identifiers."
},
"id": {
"description": "Stable identifier for a record in this generation.",
"type": "string"
},
"summary": {
"description": "Short searchable text, when returned by this operation.",
"type": [
"string",
"null"
]
},
"title": {
"description": "Human-readable record title.",
"type": "string"
},
"url": {
"description": "Public canonical path for the record.",
"type": "string"
}
},
"required": [
"id",
"title",
"url",
"data"
],
"type": "object"
},
"SourceFreshness": {
"properties": {
"attention_required": {
"type": "boolean"
},
"evaluated_at": {
"description": "UTC time when age was evaluated; source and observation dates are unchanged.",
"type": "string"
},
"max_age_seconds": {
"description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
"format": "int64",
"type": "integer"
},
"source_age_seconds": {
"description": "Age of the official source timestamp, never the import or enrichment timestamp.",
"format": "int64",
"type": [
"integer",
"null"
]
},
"state": {
"$ref": "#/$defs/FreshnessState"
},
"warn_age_seconds": {
"description": "Early-warning boundary, separate from the stale-source boundary.",
"format": "int64",
"type": "integer"
},
"warning": {
"description": "User-facing warning, or null when within the warning threshold.",
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"evaluated_at",
"max_age_seconds",
"warn_age_seconds",
"attention_required"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢search_opportunities(active, after, agency, generation, limit, ...)
Find official opportunity records by keywords, industry, set-aside, state, agency and source status. Active does not imply the deadline is open.
Input Schema
{
"type": "object",
"properties": {
"active": {
"description": "Filter by source active status; this does not mean the response deadline is open.",
"type": [
"boolean",
"null"
]
},
"after": {
"description": "Last notice ID from next_after in the preceding page.",
"type": [
"string",
"null"
]
},
"agency": {
"description": "Agency code on the source notice.",
"type": [
"string",
"null"
]
},
"generation": {
"description": "Retained generation UUID from a prior result for a consistent snapshot.",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum notices to return, from 1 to 50; defaults to 25.",
"format": "uint",
"maximum": 50,
"minimum": 1,
"type": [
"integer",
"null"
]
},
"naics": {
"description": "Two- to six-digit NAICS industry code from a notice or the NAICS reference collection.",
"type": [
"string",
"null"
]
},
"q": {
"default": "",
"description": "Plain-language keywords; empty returns notices matching the other filters.",
"type": "string"
},
"set_aside": {
"description": "Official set-aside code from a notice or the set-asides reference collection.",
"type": [
"string",
"null"
]
},
"state": {
"description": "State or territory code for the place of performance.",
"type": [
"string",
"null"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"filters": {
"$ref": "#/$defs/OpportunityQuery",
"description": "Applied search filters."
},
"generation": {
"type": "string"
},
"items": {
"items": {
"$ref": "#/$defs/OpportunitySummary"
},
"type": "array"
},
"next_after": {
"description": "Last record ID for the next page, or null at the end.",
"type": [
"string",
"null"
]
},
"scope": {
"description": "Limits of this retained official-notice search.",
"type": "string"
}
},
"required": [
"generation",
"items",
"filters",
"scope"
],
"$defs": {
"JsonObject": {
"description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
"type": "object"
},
"OpportunityQuery": {
"additionalProperties": false,
"properties": {
"active": {
"description": "Filter by source active status; this does not mean the response deadline is open.",
"type": [
"boolean",
"null"
]
},
"after": {
"description": "Last notice ID from next_after in the preceding page.",
"type": [
"string",
"null"
]
},
"agency": {
"description": "Agency code on the source notice.",
"type": [
"string",
"null"
]
},
"generation": {
"description": "Retained generation UUID from a prior result for a consistent snapshot.",
"type": [
"string",
"null"
]
},
"limit": {
"description": "Maximum notices to return, from 1 to 50; defaults to 25.",
"format": "uint",
"maximum": 50,
"minimum": 1,
"type": [
"integer",
"null"
]
},
"naics": {
"description": "Two- to six-digit NAICS industry code from a notice or the NAICS reference collection.",
"type": [
"string",
"null"
]
},
"q": {
"default": "",
"description": "Plain-language keywords; empty returns notices matching the other filters.",
"type": "string"
},
"set_aside": {
"description": "Official set-aside code from a notice or the set-asides reference collection.",
"type": [
"string",
"null"
]
},
"state": {
"description": "State or territory code for the place of performance.",
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"OpportunitySummary": {
"properties": {
"content_hash": {
"description": "Hash of retained notice content for change detection.",
"type": "string"
},
"data": {
"$ref": "#/$defs/JsonObject"
},
"id": {
"type": "string"
},
"summary": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"summary",
"content_hash",
"data",
"url"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence
Recent observations
verifiedversion not recorded17 tools