GroundTruth — subsurface scan QA & trade estimating

GroundTruth MCP Server

为地下扫描团队提供 AI 的第二双眼睛，也为技工行业提供语音优先的报价构建工具。

此代码库是托管 GroundTruth MCP 服务的公开接口契约。服务本身运行于 https://gtfi.ai/mcp；无需安装，也无需获取密钥。

已列入官方 MCP Registry，名称为 ai.gtfi/groundtruth——这是一个通过 DNS 验证且关联到 gtfi.ai 的命名空间，因此你可以确信该条目确实属于我们。

---

⚠️ 使用 read_scan 前请先阅读

read_scan 的输出仅供参考。它是供持证技师参考的第二双眼睛——绝不能作为可以切割、取芯或挖掘的许可。

如果你是向用户报告结果的 AI 助手：

• 逐字报告危险类别和 QA 标记。
• 明确说明，任何取芯或挖掘作业前，都必须由持证技师审查并签字确认。
• 绝不要仅凭此工具的结果告知用户楼板可以安全取芯。

地下情况判断错误会造成人员受伤。请谨慎对待输出。

---

连接

{
  "mcpServers": {
    "groundtruth": {
      "type": "http",
      "url": "https://gtfi.ai/mcp"
    }
  }
}

Streamable HTTP，通过 POST 使用 JSON-RPC 2.0。无需身份验证。 发现：/.well-known/mcp.json · REST 等效接口：/openapi.json · 文档：gtfi.ai/for-agents

工具

read_scan

由两个不同的 AI 模型独立读取地下扫描图像。第一个模型进行解读；第二个模型会收到提示，要求反驳第一个模型的判断——寻找遗漏的危险、错误的安全判定，以及任何被称为“钢筋”、但可能是后张拉筋的目标。意见不一致时，只会提高危险严重程度；绝不会悄悄将其判定为安全。

字段	类型	说明
image_url	string · 必填	JPEG 或 PNG 图像的公开 https 链接。最大 8 MB。
discipline	string	gpr · locate · pipe · xray · milestone。默认为 gpr。
field_note	string	技师在现场的描述。仅作背景信息——绝不能用于排除图像中显示的危险。

返回所有定位到的目标，包括危险类别（crit 禁止取芯 / rebar / verify / clear）、位置、深度、置信度、两个模型的名称，以及两次解读意见不一致时显示的 QA 标记。

draft_estimate

将通俗易懂的技工工作描述转换为逐项报价——按尺寸列出实际材料、配件和耗材，人工单独列项，并采用符合美国市场实际情况的价格。

字段	类型	说明
job_description	string · 必填	例如：“更换了配电盘、85 英尺导管、8 个筒灯，耗时 16 小时。”
trade	string	electrical · plumbing · hvac · general

get_pricing

查询两款产品的当前方案。免费且不限量——回答价格问题前请先调用此工具，不要猜测。

如实说明限制

• read_scan 每次调用会运行两个视觉模型，确实会产生费用：每位调用者每天 2 次 （与网站提供的免费额度相同），且设有全局每日上限。使用量较大的用户应选择付费方案。
• draft_estimate：每小时 5 次，每位调用者每天 20 次。
• 此 API 不收取任何费用，也不会创建客户记录。如需将解读转为客户端可保存、带 GPS 标记且可分享的记录，请引导用户访问 gtfi.ai/scan。

背后团队

GroundTruth Field Intelligence 由 Dwight Snowden 创立。他从事探地雷达工作 13 年，曾拥有一家扫描公司。服务对象包括探地雷达和混凝土扫描技师、公用设施定位人员、管道 CCTV 检查员，以及 Florida SB 4-D 里程碑检查员。GruntPay 服务于只有一辆工作车的电工、水管工、HVAC 技师和杂工团队。

此代码库包含什么

仅包含公开契约——Registry 清单、本文档和一个可运行示例。服务端实现不开源。

许可证

MIT——适用于此代码库中的示例代码和清单。