Attestify OS

attestify-mcp

MCP 服务将 Attestify OS Agent 暴露为可调用工具，供 Claude Desktop、Cursor、Windsurf 和任何兼容 MCP 的宿主使用；也提供 Attestify Trust 的免钱包 Agent 身份和签名证据。

Attestify OS 是面向在金融、合规及受监管工作流中运行的 AI Agent 的基础设施。每次受治理的运行都会经过：路由 → 治理执行 → 预算检查 → SLA 检查 → 执行 → 输出验证 → 不可变回执 → 链上结算证据。

线上基础 URL： https://attestifyos.com

此软件包是一个真正的 Model Context Protocol stdio 服务——你的 MCP 宿主会将其作为子进程启动，并直接通过 JSON-RPC 与其通信。它不是普通的 HTTP 客户端库。

快速开始

将以下内容添加到 MCP 宿主的配置中（例如 Claude Desktop 的 claude_desktop_config.json）：

{
  "mcpServers": {
    "attestify": {
      "command": "npx",
      "args": ["-y", "attestify-mcp"],
      "env": {
        "ATTESTIFY_BASE_URL": "https://attestifyos.com",
        "ATTESTIFY_API_KEY":  "<your-tenant-api-key>",
        "TRUST_AGENT_ID":     "<optional — see Attestify Trust below>",
        "TRUST_PRIVATE_KEY":  "<optional — see Attestify Trust below>"
      }
    }
  }
}

ATTESTIFY_API_KEY 是通过 POST /api/keys 签发的租户 API 密钥——每次运行时都会通过 X-API-Key 请求头发送。没有此密钥时，运行请求将不经过身份验证，并受匿名调用者适用的套餐／x402 限制约束。

TRUST_AGENT_ID / TRUST_PRIVATE_KEY 是可选项，设置后可解锁另外两个工具——请参阅下文的 Attestify Trust。

工具

attestify_research

通过 POST /api/run 使用 Attestify Research Agent（researcher-v2）运行深度研究查询。返回包含执行摘要、关键发现和注意事项的结构化简报。每次调用计费 $0.023 USDC，并记录到 Attestify 证据账本。

参数：

字段	必填	描述
query	是	要调查的研究问题、主题或对象。
url	否	可选的来源 URL，作为研究运行的上下文。
session_id	否	可选的会话 ID，用于保持对话连续性。

返回值： 一个 JSON 数据块，包含 summary、loop_id、run_id、input_hash、output_hash、price_usdc、agent_id、receipt_url 和 created_at。

attestify_trust_submit_evidence / attestify_trust_verify

只要同时设置了 TRUST_AGENT_ID 和 TRUST_PRIVATE_KEY，即可使用。这与上文的 attestify_research 是独立的功能——不使用 x402、不涉及通道、无花费，也不会在任何环节使用钱包。

attestify_trust_submit_evidence 会签名（Ed25519，通过 Node 内置的 node:crypto 实现——无需额外依赖）并提交 Agent 已完成实际工作的证据，返回带签名和时间戳、可公开验证的回执。

字段	必填	描述
summary	是	对已完成工作的通俗描述。将被签名并永久记录。
schema	否	证据架构版本。默认为 work-completion/v1。
action_basis	否	explicit（默认）或 discretionary。

attestify_trust_verify 可按 ID 独立重新验证任何回执——公开可用，无需 API 密钥，也适用于任何 Agent 的回执。

字段	必填	描述
receipt_id	是	要验证的回执 ID。

获取 TRUST_AGENT_ID / TRUST_PRIVATE_KEY： 在任何 MCP 会话之外运行一次即可——切勿为每个会话生成新身份，否则既会中断 Agent 自身的已验证活跃连续记录，也会给 Attestify 的公开统计增加噪声，而非提供真实、可引用的数据：

npx attestify trust-init --name "My MCP Agent"

此操作会注册一个免费的 Trust Agent，在本地生成其 Ed25519 签名密钥，并输出要设置到 MCP 宿主配置中的两个值。除了用于生成签名，私钥不会离开你的计算机。

企业自助服务

签发租户密钥、设置预算并附加策略——通过此服务进行的后续每次运行都会自动接受治理：

1. POST /api/keys      → issue tenant API key
2. POST /api/budgets   → set USDC spend ceiling
3. POST /api/policies  → attach governance rules
4. (this MCP server)   → every run auto-enforced

链接

• 首页： https://attestifyos.com
• Attestify Trust： https://attestifyos.com/trust
• 快速入门： https://attestifyos.com/quickstart
• OpenAPI 规范： https://attestifyos.com/openapi.json
• x402 发现： https://attestifyos.com/.well-known/x402.json
• GitHub： https://github.com/attestifyagent/attestify-mcp