GovGazette
Find federal contracting opportunities, research awards and vendors, and review exclusion evidence.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~11,517Tokens (definiciones de herramientas)
~7.9 KBTamaño de respuesta típico
Impacto significativo en la atención (9.00% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"govgazette": {
"url": "https://govgazette.com/api/v1/mcp"
}
}
}Puntos de conexión remotos
https://govgazette.com/api/v1/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (17)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {}
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada17 herramientas