GovGazette
Find federal contracting opportunities, research awards and vendors, and review exclusion evidence.
我该使用它吗
质量与安全性
A
基于对工具定义和协议合规性的自动分析。
上下文开销
~11,517token 数（工具定义）
~7.9 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 9.00%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"govgazette": {
"url": "https://govgazette.com/api/v1/mcp"
}
}
}远程端点
https://govgazette.com/api/v1/mcpstreamable-http它能做什么
工具清单
工具（17）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {}
}输出模式
{
"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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"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"
}输出模式
{
"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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"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
}输出模式
{
"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"
}社区
证据
最近观测
已验证未记录版本17 个工具