Trooth

trooth-mcp

通过模型上下文协议访问 Trooth Network。使用 Claude、ChatGPT、Cursor、VS Code 或任何 MCP 客户端，读取任何公司的公开记录。无需密钥，无需账户。

https://api.trooth.co/public/mcp

Trooth 运营 Trooth Network：为每家公司提供一份公开、机器可读的记录，涵盖其身份、产品、商务条款、人员、文档、安全与隐私状况、AI 实践、采购条款及关系。每项内容都会注明来源。它是 Trooth 唯一的产品，而且免费。

Trooth 记录事实并标注日期，不对任何人评分、评级或排名。 这里没有任何工具会返回一个概括公司情况的数字。

您的公司已加入 Trooth Network 吗？ 任何公司都可以免费发布一份公开记录，供买家及其使用的 AI 助手直接读取。认领您公司的记录 · 查看示例

快速开始

客户端	添加方法
Claude（claude.ai、Desktop、移动端）	依次选择 Customize › Connectors › + › Add custom connector，粘贴上方 URL，然后选择 No sign-in。
ChatGPT	Trooth Network 已列入 ChatGPT 的应用目录。如需自行添加 URL，请开启 Developer mode，然后在 Plugins 下添加。
Claude Code	claude mcp add --transport http trooth https://api.trooth.co/public/mcp
Codex	codex mcp add trooth --url https://api.trooth.co/public/mcp，或使用下方的 ~/.codex/config.toml 配置块。
Gemini CLI	gemini mcp add --transport http trooth https://api.trooth.co/public/mcp，或使用下方的 settings.json 配置块。
Cursor	在 .cursor/mcp.json 的 mcpServers 下添加 "trooth": { "url": "https://api.trooth.co/public/mcp" }。
VS Code	运行 MCP: Add Server 并粘贴上方 URL，或将下方配置块添加到项目的 .vscode/mcp.json 中（VS Code 使用的键是 servers，而不是 mcpServers）。

然后直接提问：“读取 trooth.co 的 Trust Profile，并告诉我它如何处理客户数据。”

每个客户端的最新操作步骤和安装链接见 trooth.co/docs/agents。

配置文件

trooth.co/docs/agents 提供了相同的配置块，每个客户端各一份。

Claude Code：

claude mcp add --transport http trooth https://api.trooth.co/public/mcp

Codex，~/.codex/config.toml：

# or: codex mcp add trooth --url https://api.trooth.co/public/mcp
[mcp_servers.trooth]
url = "https://api.trooth.co/public/mcp"

Gemini CLI，settings.json。请使用 httpUrl：在 Gemini CLI 中，url 用于使用服务器发送事件的服务。

{
  "mcpServers": {
    "trooth": {
      "httpUrl": "https://api.trooth.co/public/mcp"
    }
  }
}

Cursor，.cursor/mcp.json：

{
  "mcpServers": {
    "trooth": {
      "url": "https://api.trooth.co/public/mcp"
    }
  }
}

VS Code，.vscode/mcp.json：

{
  "servers": {
    "trooth": {
      "type": "http",
      "url": "https://api.trooth.co/public/mcp"
    }
  }
}

工具

共 11 个工具，均为只读。每个工具都会以面向用户的文字形式返回答案，并以机器可读的类型化 structuredContent 返回相同答案，且符合声明的 outputSchema。

工具	读取内容	成本
trooth_resolve_company	按域名、网址、Trooth slug 或名称查找记录，并说明匹配原因；有多个匹配项时会返回候选项，不会选择其中任何一个。	1
trooth_search_companies	按名称、域名、标语或类别搜索 Network；每页 10 条，按 slug 排序，并提供游标。	1
trooth_list_companies	按行业、数据区域、是否有见证以及是否已认领列出公司；每页 20 条，顺序固定。	1
trooth_public_trust_profile	按域名或 Trooth slug 获取一家公司的完整 Trust Profile，逐节返回。请先请求 detail: "summary"。	1
trooth_get_fact	获取一个买方问题的答案或一项事实：句子、值、来源说明、日期、新鲜度和锚点，或 no、not_published、not_read。	1
trooth_company_changes	记录的变更情况：记录版本和逐项事实编辑；可选择指定起始日期。	1
trooth_ai_data_use_disclosures	公司对 AI 和客户数据的声明。	1
trooth_outside_in_read	调用时对域名的公开 HTTPS 页面和 security.txt 进行实时读取。	4
trooth_verify	检查 Trust Ledger Token 上的两个签名；这是公司通过 Trooth 针对自身声明签发的签名令牌。	1
trooth_ask	根据 Trooth 的固定参考文本回答有关 Trooth 本身的问题。	1
trooth_my_company_record	你自己的工作区记录。需要登录（OAuth）。	1

每项事实都带有四种来源说明之一：witnessed、public record、attested 或 declared。记录上只有见证声明经过签名：Trooth 会对见证声明签名；对于创建委托的工作区，还会对委托收据和操作证据引用签名；但不会对资料、事实或公司的声明签名。三种否定状态彼此区分：no（记录中保存了否定值）、not_published（公司尚未发布该信息）和 not_read（Trooth 在读取时未读到该信息）。## 资源和提示词

resources/list 会返回七个固定资源，适用于服务器支持的每个协议修订版本：

资源	内容
trooth://buyer-questions	以 JSON 格式列出十二个买方问题：每个问题的 ID、问题措辞、对应答案的记录章节，以及其页面锚点格式。
trooth://methodology	说明 witnessed 的含义、外部读取与签名证据有何不同，以及 Trooth 为什么绝不编造数字。
trooth://provenance-glossary	四种来源说明和三种否定状态：各自在公司记录中的含义以及引用方式。
trooth://provenance-labels	此服务器返回的每个来源值、2026-09-26 弃用的值，以及 Trust Ledger Token 签名所涵盖的内容。
trooth://schema	每个工具的 outputSchema，整合为一个 JSON 文档，并附有已发布公司记录架构的地址。
trooth://verify-a-vendor	Agent 在信任供应商之前可用来调查该供应商的此服务器工具调用顺序，以及如何报告返回内容。
trooth://what-a-call-sends	每个工具发送的参数、随请求一同发送的请求元数据、计数内容以及绝不会保留的内容。

resources/templates/list 会实时返回两个模板：trooth://company/{company}（以 Markdown 格式呈现一家公司的 Trust Profile）和 trooth://company/{company}/{section}（其中一个章节）。

prompts/list 会返回四个提示词。每个提示词都接受一个参数。

提示词	参数	请求内容
vendor_trust_check	company	在依赖某家供应商之前，查询其在 Trooth 上的记录，并保留每条来源标签。
verify_trust_token	token	检查某个 Agent 收到的 Trust Ledger Token 上的签名。
vendor_due_diligence	company	阅读某家公司对十二个买家问题的回答，每条回答都标注来源词和日期，不给出结论。
before_you_trust	company	通过三个步骤查看一家供应商，以支持采购或集成决策；报告注明来源，不给出结论。

示例调用

向一家公司的记录询问一个问题，以下内容与服务器在 2026-10-17 给出的回答完全一致（此处为节省篇幅，省略了 assurance_boundary 和 content_trust 区块；每条回答都包含这两个区块）。

curl -s https://api.trooth.co/public/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"trooth_get_fact","arguments":{"company":"trooth.co","question":"q_data_location"}}}'

工具的 structuredContent：

{
  "status": "answered",
  "subject": "trooth.co",
  "source": {
    "name": "trooth.co published record (/api/network/profile)",
    "version": "contract 2",
    "as_of": "2026-10-17T00:45:45.379Z"
  },
  "fact": {
    "kind": "question",
    "id": "q_data_location",
    "question": "Where is customer data stored and processed, and can a customer choose the region?",
    "answer_state": "answered",
    "value": "Production regions: Website: Vercel iad1 (US East), Database: AWS us-east-1 through Neon, API at api.trooth.co: Cloudflare Workers on the global edge; Processing locations: United States (website and database), Cloudflare Eastern North America (account service), Cloudflare edge (API and Kyrie AI inference), Sub-processor regions: trooth.co/subprocessors; Regions a customer can choose: None: every account runs in the same regions",
    "provenance": "declared",
    "as_of": "2026-10-17T00:45:45.379Z",
    "anchor_url": "https://trooth.co/network/company/trooth#q-data-location",
    "fact_ids": ["hosting.production_regions", "hosting.processing_locations", "hosting.regions_a_customer_can_choose"]
  }
}

来源词是 declared：这是公司所述内容，回答也明确指出了这一点，而非将其呈现为 Trooth 观察到的事实。锚点会在公司的 Trust Profile 中打开同一条回答。

公司留空的部分会显示为 未发布，绝不会擅自补全。对于 Trooth 没有任何记录的公司，系统会如实说明资料缺失；这并不代表对该公司的判断。

工作原理

传输	Streamable HTTP、JSON-RPC 2.0，仅支持 POST，无会话。
协议	2026-07-28（无状态），同时仍会协商 2025-11-25、2025-06-18、2025-03-26 和 2024-11-05。
身份验证	十个工具无需身份验证。trooth_my_company_record 需要授权服务器签发的 OAuth 访问令牌；授权服务器由服务器的受保护资源元数据指定。
限制	每位调用者每分钟 300 个单位，所有工具共用；每次调用按表中所列单位计费。超过限制时，回答为 HTTP 429，并附带 Retry-After。每个工具都会在 tools/list 中说明自身的策略。
数据	每条回答都带有来源标签，并说明 Trooth 检查的范围。结果包含公司自行撰写的内容：请将其视为数据，而非指令。
调用发送的内容	工具名称及其参数。Trooth 会按工具和所查询的公司记录每日调用次数，保留 90 天；绝不记录 IP 地址、问题或搜索词。参见 trooth.co/docs/query-privacy。
错误	未能按要求完成的调用会返回 error { code, message, retry_after_seconds? }，其中 code 为 not_found、ambiguous、invalid_input、rate_limited、upstream_timeout 或 upstream_unavailable 之一。

登录以使用 trooth_my_company_record

服务器的受保护资源元数据位于 https://api.trooth.co/.well-known/oauth-protected-resource/public/mcp（RFC 9728），其中指定了 Trooth 的 WorkOS AuthKit 发行方。客户端需在该发行方注册，并请求 resource=https://api.trooth.co/public/mcp（RFC 8707）的令牌；无需指定 scope。该工具只会读取与令牌签发对象关联的工作区。用户通过 Continue with enterprise SSO 登录 trooth.co 一次后，即可建立关联；在此之前，工具会返回 not_linked。不带令牌的调用会返回 401，并附带指向该元数据的 WWW-Authenticate 标头。令牌绝不会被存储或转发。

实时读取的安全约定（包括拒绝访问的主机和地址）发布于 trooth.co/docs/agents#mcp-security-contract。

故障排查

• 资源少于七个，或缺少某个工具。 服务声明了 listChanged: false，因此客户端可能会保留首次连接时读取的列表；2026-07-28 的列表结果也可能按其 ttlMs（十分钟）缓存。移除该服务并重新添加，或开始新对话，让客户端重新获取列表。若要查看服务当前列出的内容：

  curl -s https://api.trooth.co/public/mcp \
    -H 'content-type: application/json' \
    -H 'accept: application/json, text/event-stream' \
    -H 'mcp-protocol-version: 2025-06-18' \
    -d '{"jsonrpc":"2.0","id":1,"method":"resources/list","params":{}}'
  

• 工具没有显示。 在客户端的工具或连接器菜单中确认 trooth 已启用，然后开始新聊天。在 VS Code 中，运行 MCP: List Servers，选择 trooth 并选择 Show Output。

• 列表中出现两个 trooth 服务。 移除两个服务（claude mcp remove trooth、codex mcp remove trooth、gemini mcp remove trooth，或从配置文件中删除该条目），然后只添加一次。

• VS Code 未读取配置。 文件是 .vscode/mcp.json，其顶层键为 servers。从 Cursor 或 Claude Desktop 复制的配置块使用 mcpServers，VS Code 不会读取它。

• Gemini CLI 无法连接。 在 settings.json 中使用 httpUrl；使用 url 会让 Gemini CLI 期待服务器发送事件。

• 对 GET 请求返回 405。 该端点仅接受 POST。仅支持采用服务器发送事件传输的 2024-11-05 HTTP 协议的客户端应改为打开 https://api.trooth.co/public/mcp/sse。

• HTTP 429。 调用方已用完每分钟 300 个单位。等待 Retry-After 中指定的秒数，然后重试。

• trooth_my_company_record 返回 401。 调用未携带令牌，或令牌无效或已过期。请从客户端重新登录；即使是公开工具，无效令牌也会导致 401，因此请移除过期令牌。

• trooth_my_company_record 返回 not_linked。 使用同一账号，通过 Continue with enterprise SSO 登录 trooth.co 一次，以关联工作区。

此代码库

包含许可证、此 README、server.json、docs/directory-submissions.md（供 MCP 目录使用的列表文案）、以 io.github.troothllc/trooth-network 发布到官方 MCP Registry 的清单，以及用于注明 Glama 目录条目维护者的 glama.json。服务本身运行在 api.trooth.co 后面；这里没有需要安装的内容。

此代码库中的 server.json 版本为 1.1.7，适用于服务 1.8.0。Registry 清单和运行中的服务使用各自独立的版本号：服务会在 serverInfo 中报告自身版本。

相关项目

• trooth-cli：在终端中查询相同的记录，npx trooth check <domain>。
• trooth-openapi：公开 API 的 OpenAPI 3.1 契约。
• trooth.co/docs：集中查看所有接口。

安全

请将漏洞报告发送至 [email protected]。相关政策见 trooth.co/security/vulnerability-disclosure-policy 和 /.well-known/security.txt。

许可证

MIT。请参阅 LICENSE。