Proofslip

@proofslip/mcp-server

ProofSlip の MCP サーバーです。AI エージェントのワークフロー向けに、レシートを使って検証できます。エージェントが次に何をするか決める前に、何が起きたかを証明できる、一時的なレシートの作成、検証、ポーリングができます。

ツール

create_receipt

何かが起きたことを記録するレシートを作成します。デフォルトでは、レシートは24時間後に期限切れになります。

Parameter	Type	Required	Description
type	enum	はい	action、approval、handshake、resume、failure
status	string	はい	自由形式のステータス（例：「success」、「pending」、「failed」）
summary	string	はい	起きたこと — 最大280文字
payload	object	いいえ	構造化された JSON データ（最大4KB）
ref	object	いいえ	ワークフローの参照情報（run_id、agent_id、workflow_id など）
expires_in	number	いいえ	TTL（秒）（60～86400、デフォルトは24時間）
idempotency_key	string	いいえ	再試行時の重複レシートを防止します
audience	"human"	いいえ	検証ページにソーシャルカードを追加します

必須： PROOFSLIP_API_KEY 環境変数。

verify_receipt

次に何をするか決める前に、レシートを検証して完全なデータを取得します。

Parameter	Type	Required	Description
receipt_id	string	はい	レシート ID（rct_ で始まります）

API キーは不要です。

check_receipt_status

軽量なステータスのポーリングです。ステータスとポーリングに関する案内のみを返し、ペイロードは返しません。

Parameter	Type	Required	Description
receipt_id	string	はい	レシート ID（rct_ で始まります）

API キーは不要です。 状態が変わったかどうかだけを確認する場合は、verify_receipt の代わりにこちらを使用してください。

signup

無料の API キーを取得します（月500件のレシート）。

Parameter	Type	Required	Description
email	string	はい	メールアドレス

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 キーを設定します。

設定

Variable	Required	Description
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