Gsa Calc

gsa-calc

GSA CALC+ 劳动力时薪上限——供应商根据 GSA 计划合同中的某个劳动力类别，向美国政府收取的最高小时费率。用于在谈判前对费率进行基准比较。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未获其认可，也非其发布。

工具

工具	可回答的问题
gsa_labor_rates	“MAS 下高级软件工程师的计费费率是多少？”——提供包含供应商、合同编号和 SIN 的个人费率，以及价格摘要
gsa_rate_stats	“项目经理的 GSA 费率中位数是多少？”——仅提供摘要
gsa_vendor_rates	“这家承包商的计划费率是多少？”

这三种工具均支持以下筛选条件：min_experience / max_experience、education、worksite、business_size、security_clearance、min_rate / max_rate、sort_by / sort_dir。

身份验证

无。api.gsa.gov/acquisition/calc/v3 无需密钥——不需要 api.data.gov 密钥，与需要使用 PLATFORM_DATAGOV_KEY 的 gsa-auctions 和 gsa_perdiem 不同。

数据源

• CALC+ Quick Rate API — https://open.gsa.gov/api/dx-calc-api/
• 端点：https://api.gsa.gov/acquisition/calc/v3/api/ceilingrates/
• 费率来自 GSA MAS 合同；该数值是当前合同年度的上限费率，不是协商或实际支付的价格。

2026 年之前的文章中提到的旧路径 calc.gsa.gov/api/rates/ 已失效（404）。calc.gsa.gov 现在会重定向到 buy.gsa.gov 上的落地页。

值得了解的上游行为

以下行为均于 2026-08-28 通过实时测试测得。正在运行的 API 与文档描述有所不同，且会影响结果，因此在此逐一列出，而非想当然地假设其行为。

无法识别的筛选值会被静默忽略。 filter=worksite:Contractor（大写 C）和 filter=nonsense_field:zzz 都会返回未经筛选的完整结果集，HTTP 状态码为 200——总数与完全不发送筛选条件时相同。请求承包商工作地点费率的调用方，如果收到看似确定的答复，实际读到的可能是整个计划中的所有费率。此工具包会校验每个枚举值，并拒绝未知值，不会将其直接转发；错误信息会列出可接受的值。拒绝调用后可以恢复，但静默返回未筛选的基准数据则无法补救。

大小写敏感规则方向相反，而且有三套不同的词汇。 worksite 只匹配小写值（contractor）；Contractor 会被忽略。business_size 只匹配大写值（S）；s 返回零行。同一个字段在不同位置的拼写也不同——筛选值 BA、JSON 响应中的 Bachelors，以及筛选值 S 对应的 CSV 导出值 small business。此工具包接受人类常用的写法（"bachelors"、"small business"、"contractor facility"），并将其映射到相应值。

min_years_experience 是等值筛选条件，而不是最低年限。 上游的 min_years_experience:5 只返回要求恰好 5 年经验的行（“software engineer” 共 4,396 行，其中 667 行符合条件）。我们的 min_experience 表示调用方通常理解的含义——5 年或以上，并映射为 experience_range:5,99（共 2,561 行，要求年限从 5 年到 15 年以上）。

page 和 page_size 都会被忽略。 JSON 端点对每个查询都恰好返回 20 行；page=1、page=2 和 page=3 返回的行逐字节完全相同，而 page_size=300 仍只返回 20 行。export=y 则会以 CSV 格式返回完整的匹配结果集，因此此工具包会根据导出结果计算百分位数——每个 rate_summary 中的 based_on 都会注明这些数值所依据的行数。JSON 端点自身的总数最多显示为 10,000，并带有 relation: "gte"；导出结果的数量则是准确的。

Accept: text/csv 会返回 406。 导出接口的响应 Content-Type 为 text/csv，但请求该类型是它唯一会拒绝的请求。请发送 */*。

阅读结果

rate_summary 是基于所有匹配的费率计算的，而非返回的行数—— based_on 是其背后的行数；只有在非常宽泛的查询触及数据包的字节上限时， complete 才为 false。matched_labor_categories 显示关键词实际命中了哪些 合同职位名称，因为合同中的劳动力类别名称是自由文本（例如“S. Software Engineer”和“Software Engineer III”）， 而其分布情况可以告诉你基准比较的对象是否正确。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "gsa-calc": {
      "url": "https://gateway.pipeworx.io/gsa-calc/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/gsa-calc/mcp 上的 tools/list 会返回上表中的工具， 以及共享的 Pipeworx 元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及 网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前单数据包端点除了数据包自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威信息。

这是有意为之，并非意外进行了多路复用。元工具让限定范围的连接也能回答本数据包未涵盖的问题——通过 ask_pipeworx，它会在整个目录中进行路由——而无需你添加第二个 MCP 服务。目前无法在不包含这些工具的情况下挂载数据包端点；如果额外的架构定义占用的上下文超过了路由带来的价值，请连接完整网关，而不是连接多个数据包端点。

或者连接完整的 Pipeworx 网关，直接列出每个数据包的工具，而不仅是此数据包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1879+ 个数据源。唯一的区别是哪些数据包的工具会被直接列出；无论连接哪个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/gsa_labor_rates \
  -H 'Content-Type: application/json' \
  -d '{"labor_category":"software engineer","min_experience":5}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/gsa_labor_rates。查找工具：POST https://gateway.pipeworx.io/v1/tools/search_packs，参数为 {"query":"..."}。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "gsa-calc": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-gsa-calc"]
    }
  }
}

或者直接运行以确认服务能够启动：

npx -y @pipeworx/mcp-gsa-calc

它通过 stdin/stdout 使用 MCP 协议，并为仅限此数据包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——数据包端点和完整网关都支持此方式：

ask_pipeworx({ question: "your question about Gsa Calc data" })

网关会选取合适的工具，并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT