Proofslip

@proofslip/mcp-server

适用于 ProofSlip 的 MCP 服务——为 AI Agent 工作流提供基于回执的验证。创建、验证和轮询临时回执，让 Agent 能在决定下一步操作前证明发生了什么。

工具

create_receipt

创建回执，记录某件事已经发生。回执默认在 24 小时后过期。

参数	类型	必填	描述
type	枚举	是	action、approval、handshake、resume、failure
status	字符串	是	自定义状态（例如“成功”“待处理”“失败”）
summary	字符串	是	发生了什么——最多 280 个字符
payload	对象	否	结构化 JSON 数据（最大 4KB）
ref	对象	否	工作流引用（run_id、agent_id、workflow_id 等）
expires_in	数字	否	TTL，以秒为单位（60–86400，默认 24 小时）
idempotency_key	字符串	否	防止重试时创建重复回执
audience	"human"	否	在验证页面中添加社交卡片

需要： PROOFSLIP_API_KEY 环境变量。

verify_receipt

验证回执并获取其完整数据，以便决定下一步操作。

参数	类型	必填	描述
receipt_id	字符串	是	回执 ID（以 rct_ 开头）

无需 API 密钥。

check_receipt_status

轻量级状态轮询——仅返回状态和轮询指南，不包含 payload。

参数	类型	必填	描述
receipt_id	字符串	是	回执 ID（以 rct_ 开头）

无需 API 密钥。 如果只需了解状态是否发生变化，请使用此工具，而非 verify_receipt。

signup

获取免费 API 密钥（每月 500 张回执）。

参数	类型	必填	描述
email	字符串	是	你的电子邮件地址

无需 API 密钥。

使用示例

You: "Create a receipt proving we sent the welcome email"

Agent calls create_receipt:
  type: "action"
  status: "success"
  summary: "Sent welcome email to [email protected]"
  ref: { workflow_id: "onboarding-123", agent_id: "email-agent" }

→ Returns receipt_id, verify_url, is_terminal: true

You: "Verify receipt rct_abc123 before sending the follow-up"

Agent calls verify_receipt:
  receipt_id: "rct_abc123"

→ Returns full receipt: type, status, summary, payload, ref
→ Agent confirms the action happened before proceeding

You: "Check if the approval is still pending"

Agent calls check_receipt_status:
  receipt_id: "rct_def456"

→ Returns: status: "pending", is_terminal: false, next_poll_after_seconds: 30
→ Agent waits 30s then checks again

设置

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "proofslip": {
      "command": "npx",
      "args": ["-y", "@proofslip/mcp-server"],
      "env": {
        "PROOFSLIP_API_KEY": "ak_your_key_here"
      }
    }
  }
}

Cursor / Windsurf

添加到 MCP 设置：

{
  "mcpServers": {
    "proofslip": {
      "command": "npx",
      "args": ["-y", "@proofslip/mcp-server"],
      "env": {
        "PROOFSLIP_API_KEY": "ak_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add proofslip -- npx -y @proofslip/mcp-server

然后在环境变量或 .env 文件中设置 API 密钥。

配置

变量	必需	描述
PROOFSLIP_API_KEY	创建回执时需要	你的 API 密钥（以 ak_ 开头）
PROOFSLIP_BASE_URL	否	API 基础 URL（默认值：https://proofslip.ai）

获取 API 密钥

使用任意 MCP 客户端中的 signup 工具，或：

curl -X POST https://proofslip.ai/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "source": "api"}'

链接

• 在线网站
• API 文档
• 回执示例
• Context Capsule（姊妹产品——用于交接的执行上下文）
• GitHub

许可证

MIT