GovCon API

GovCon API MCP

大多数 SAM.gov MCP 服务会将一个数据集封装在六到十个工具后面。这六个工具可调用五个联邦数据源中的 53 项操作，并且已按各数据源共有的标识符完成关联。

供 Agent 使用的美国联邦采购数据：668K 条 SAM.gov 商机、10.6M 条 FPDS 主合同交易记录、880K 个在 SAM 注册的实体、226K 条 FFATA 分包合同记录、164K 条排除记录、14K 项已裁决 GAO 抗议案件，以及 ~262K 条 GSA CALC 劳动力费率。通过 UEI、CAGE、PIID 和 NAICS 交叉关联，因此一个问题不必变成五项集成工作。

数据截至 2026-08-31，数字为约数。数据集每天都在增长，因此本文档只是一个快照：各数据源的当前总量和最新更新时间始终可在 /api/v1/status 实时查看，无需密钥。

免费试用 14 天，无需信用卡。 获取密钥，然后运行 pipx install govconapi-mcp。

---

为什么选择它，而不是又一个 SAM.gov 封装服务

大多数联邦合同 MCP 服务都是官方 SAM.gov API 的轻量代理。以下是三个具体差异。

• 五个数据源，已完成关联。 SAM.gov 商机和实体、FPDS 合同交易记录、USAspending/FFATA 分包合同记录、SAM 排除记录、SBA DSBS 认证和 GSA CALC 费率，都已按共有标识符完成关联。封装服务只会向 Agent 提供一个数据集，关联工作则留给它处理。
• 无需注册 SAM.gov 实体，也无需公司 UEI。 GSA 说明，非联邦用户在没有 SAM 角色时每天可发起 10 次请求，有 SAM 角色时则为 1,000 次。使用本服务只需一个邮箱和一个密钥。
• 六个工具，每个都以具体任务命名。 resolve、search、get、market、price、contact 可调用所有数据集和记录：模型从六个工具中比从五十个工具中更容易可靠地选出合适工具，而且这些工具定义占用的上下文约为六分之一。它们背后的 53 个单一用途工具只需调整一个设置即可启用（GOVCONAPI_TOOLS=all）。

---

连接

Claude，无需安装。 在 Claude（网页、桌面或移动端）中，添加自定义连接器，地址为 https://mcp.govconapi.com/mcp，然后使用邮箱登录。操作步骤：govconapi.com/mcp/tools#claude-connector。

ChatGPT，无需安装。 在网页版 ChatGPT 中，添加自定义 MCP 服务，使用相同地址，将身份验证方式设为 OAuth，然后使用邮箱登录。操作步骤：govconapi.com/mcp/tools#chatgpt。

**本地安装，**适用于 Claude Code、Cursor、VS Code、Zed、Claude Desktop 配置文件和自定义 Agent：

pipx install govconapi-mcp

pipx 会将二进制文件放在 Claude Desktop 沙盒可启动的位置。在 macOS 上，请先运行 brew install pipx。使用 uv 时，请运行 uvx --from govconapi-mcp govconapi-mcp。需要 Python 3.10+。

Claude Desktop（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上的 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "govconapi": {
      "command": "govconapi-mcp",
      "env": { "GOVCONAPI_KEY": "gca_your_key_here" }
    }
  }
}

重启 Claude。Claude Code、Cursor、VS Code、Zed 和自定义 Python Agent 的相关说明，请参阅安装参考。如需使用 53 个单一用途工具，而不是六个工具，请在同一个 env 块中添加 "GOVCONAPI_TOOLS": "all"。

---

可以这样提问

查找本月发布、金额超过 $1M 的 DoD 网络安全招标。

NAICS 541512 中有哪些根基稳固的现任承包商？该市场的竞争有多激烈？

这份合同是否即将重新竞标？现任承包商的保留资格认证是否会先到期？

将此 UEI 转换为承包商档案：注册信息、授予合同、分包活动、排除记录。

该供应商是否曾被禁止承接联邦合同？

---

六种工具

工具	你可以询问的内容
resolve	名称转 ID：将机构名称转换为其筛选值、将标题词语转换为 NAICS 代码、将公司名称转换为 UEI、将 DUNS 转换为 UEI
search	17 种数据集之一：机会、预测、合同、采购载体、分包、重新竞标、公司、实体、合作伙伴、抗议、排除名单、工资标准等
get	按 ID 查询一条记录：机会、合同、采购载体及其持有人、重新竞标、公司简介、供应商风险报告、某项招标的抗议、工资标准
market	某个 NAICS 市场：规模、竞争、招标语言、小额采购、排行榜
price	合同价值基准、投标排名、GSA 劳动力费率、SCA 和 Davis-Bacon 工资标准
contact	公司的决策者，或合同官员

它们调用下面这 53 个单一用途工具，因此每项功能都有自己的计划。

53 个单一用途工具（GOVCONAPI_TOOLS=all）

参数完整参考：TOOLS.md。

阶段	工具数	可回答的问题
市场调研	12	某个 NAICS 的采购方、采购方式以及竞争激烈程度
机会发现	3	目前有哪些符合我的能力的活跃机会
商机捕获与组队	12	谁在中标、可以与谁组队、应该联系谁
投标、定价与谈判	9	应该花费多少、劳动力费率、我的团队是否合规
授标与合规	13	谁中标、条款是什么、是否有人提出抗议
机构、授标、排除名单与标识符	4	名称解析、授标通知、筛查、DUNS 转 UEI

15 个工具需要 Pro 计划，在 Developer 计划下会返回 HTTP 402。还有 3 个工具在 Developer 计划下可用，但特定字段会受到限制；劳动力费率基准需要任意一种付费计划。其余 34 个工具没有计划区别。每个工具都在 TOOLS.md 中标明。

---

它不是什么

• 不能替代作为权威记录系统的 SAM.gov。 我们对联邦公开数据进行标准化，并保留来源信息。要查询权威记录或提交信息，请访问 SAM.gov。
• 不是实时数据。 机会每天刷新。如果你的使用场景需要分钟级的数据时效性，那么这不是合适的工具，我们宁愿现在就让你知道。
• 不涵盖州或地方数据。 仅限美国联邦采购。
• 不是提案撰写工具、CRM 或业务拓展平台。 它是一个数据层。如果你需要端到端的商机捕获套件，请另行购买并将其连接到此处。
• FPDS 覆盖范围从 2024-10-01 开始（FY2025 及之后）。多年历史市场调研的覆盖深度有限，这是一个真实限制，并非疏忽。
• 来源数据缺陷会直接保留。 SAM 和 FPDS 中存在不可能的日期、$0 金额和空值 UEI。我们会照实呈现并记录这些注意事项，而不会悄悄清理，因为这些错误属于权威记录系统。

---

计划

计划	价格	限制
免费试用	$0，14 天	每天 50 次请求
Developer	$19/mo	每小时 1,000 次请求
Pro	$39/mo	增加 15 个 Pro 工具，并为另外 3 个工具提供更丰富的字段

所有计划均包含 MCP 访问权限，包括试用计划。没有单独的层级。

---

故障排除

未设置 GOVCONAPI_KEY environment variable，请将其添加到上方的 MCP 配置中，然后重启客户端。

Invalid API key，密钥以 gca_ 开头。请在 govconapi.com 获取密钥。

触发速率限制（429），免费试用每天可调用 50 次，Developer 每小时可调用 1,000 次。

返回 402，该工具需要 Pro 计划。TOOLS.md 中标明了哪些工具需要 Pro。

---

隐私政策

完整政策：https://govconapi.com/privacy

简而言之，本服务对您的数据所做的处理如下：

• 您的 API 密钥会从您自己的客户端配置中的 GOVCONAPI_KEY 读取，并在 Authorization 标头中发送至 https://govconapi.com。本服务进程不会将其写入磁盘，也不会将其传输到其他任何地方。
• 您的工具调用会转换为普通的 GovCon API 请求。与向 API 发送的任何请求一样，我们会记录时间戳、端点、查询参数、响应状态、响应时间以及发起调用的密钥，用于计费、执行速率限制和检测滥用。使用日志会保留 90 天。
• **对话内容不会离开您的设备。**只会发送客户端填入的工具参数，不会发送周围的聊天内容；我们记录的是请求返回的状态，而不是响应内容。
• 我们不会出售您的数据。
• 返回的数据是来自 SAM.gov、FPDS、USAspending、SBA DSBS 和 GSA CALC 的美国联邦采购公开数据。

---

链接

• API 参考：https://govconapi.com/api-guide
• 工具参考：https://govconapi.com/mcp/tools
• 实时覆盖范围和新鲜度：https://govconapi.com/api/v1/status
• 机器可读文档：https://govconapi.com/llms.txt 和 https://govconapi.com/openapi.json
• 隐私：https://govconapi.com/privacy · 条款：https://govconapi.com/terms
• 支持：[email protected]

采用 MIT 许可证。数据来源于 SAM.gov、FPDS、USAspending、SBA DSBS 和 GSA CALC，均为联邦公开数据。