{"_id":"@proofslip/mcp-server","_rev":"5-b6f0b95e4e4423370767189b5df7a22d","name":"@proofslip/mcp-server","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"@proofslip/mcp-server","version":"0.1.0","keywords":["mcp","proofslip","receipts","ai-agents","model-context-protocol","verification"],"license":"ISC","_id":"@proofslip/mcp-server@0.1.0","maintainers":[{"name":"johnnyz13","email":"johnny@z13labs.com"}],"bin":{"proofslip-mcp":"dist/bin/cli.js"},"dist":{"shasum":"bd1e8d2b80bdd8e63e04ace3d4e23cf5feba54f7","tarball":"https://registry.npmjs.org/@proofslip/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":19,"integrity":"sha512-K2FctbId8fYzYl6Kp6+r8XHDJQQwuBTYmQxCYYAtt9ooTgFO8RGMMQPlvLTStThwxGWOMlw+YdeolaU9AIMUjw==","signatures":[{"sig":"MEUCIBREBn+Q9QGGVlh9uchf1IwD/Mj6sSIUiyxvkNzYu2OQAiEAzpaATYapoxcIeBm8mdXHf+t3C+loiErHsl8yNx5ZJ6c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15047},"main":"./dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"50fdd257e590a21c54145303d85d48bcad11bb78","scripts":{"dev":"tsx src/index.ts","build":"tsc"},"_npmUser":{"name":"johnnyz13","email":"johnny@z13labs.com"},"_npmVersion":"11.6.2","description":"MCP server for ProofSlip — receipt-based verification for AI agent workflows","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.9.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1775053960312_0.8439924889479724","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@proofslip/mcp-server","version":"0.1.1","keywords":["mcp","proofslip","receipts","ai-agents","model-context-protocol","verification"],"license":"ISC","_id":"@proofslip/mcp-server@0.1.1","maintainers":[{"name":"johnnyz13","email":"johnny@z13labs.com"}],"bin":{"proofslip-mcp":"dist/bin/cli.js"},"dist":{"shasum":"ac899243e5aa69e89c71b2b2d0012286ebf9cfac","tarball":"https://registry.npmjs.org/@proofslip/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":19,"integrity":"sha512-Rsz2OdBlq+HHypYfQ+yQGCQWJ62p4cfjyuxrHcEKPMVYLOMTnVU51zyorNPh1FUbU5Ti00X3ouB0l4uvbAs1IQ==","signatures":[{"sig":"MEUCIQCq/qYXFSkPG5CJu+u6JY6miA2HuxrMDqK+UHC7To0FEQIgNLzfBn/QmgadzP1xwGh7WtNtyBEUdR9Cqu8xqA6fVp8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15045},"main":"./dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"50fdd257e590a21c54145303d85d48bcad11bb78","scripts":{"dev":"tsx src/index.ts","build":"tsc"},"_npmUser":{"name":"johnnyz13","email":"johnny@z13labs.com"},"_npmVersion":"11.6.2","description":"MCP server for ProofSlip — receipt-based verification for AI agent workflows","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.9.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1775054110122_0.1028556375480425","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@proofslip/mcp-server","version":"0.2.1","keywords":["mcp","proofslip","receipts","ai-agents","model-context-protocol","verification"],"license":"MIT","_id":"@proofslip/mcp-server@0.2.1","maintainers":[{"name":"johnnyz13","email":"johnny@z13labs.com"}],"homepage":"https://proofslip.ai","bugs":{"url":"https://github.com/Johnny-Z13/proofslip/issues"},"bin":{"proofslip-mcp":"dist/bin/cli.js"},"dist":{"shasum":"eb15c53ae958b18a9d00a2347884a9d6050387a2","tarball":"https://registry.npmjs.org/@proofslip/mcp-server/-/mcp-server-0.2.1.tgz","fileCount":19,"integrity":"sha512-ux3I1HpxW5OQsEVSryAfxeoGV00uOMz7YZS/PDcDQYfj3al69Z2CPhftnMQQPdveCihqT+AUyws4VOgMqDLCug==","signatures":[{"sig":"MEYCIQDnRpUEOGcux44D6Wk84XaCz3Kxrjv/Cc27VixABFIg+QIhALNgXlZEYa+jSuM5Yw3SNzAzFoFSXxUGE49mH5esGzlm","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15654},"main":"./dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"4011bb8399e22cf59208ff8231c6cfe5cf60a11a","scripts":{"dev":"tsx src/index.ts","build":"tsc"},"_npmUser":{"name":"johnnyz13","email":"johnny@z13labs.com"},"repository":{"url":"git+https://github.com/Johnny-Z13/proofslip.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.6.2","description":"MCP server for ProofSlip — receipt-based verification for AI agent workflows","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.9.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.1_1775224532790_0.11689684293669655","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@proofslip/mcp-server","version":"0.2.2","keywords":["mcp","proofslip","receipts","ai-agents","model-context-protocol","verification"],"license":"MIT","_id":"@proofslip/mcp-server@0.2.2","maintainers":[{"name":"johnnyz13","email":"johnny@z13labs.com"}],"homepage":"https://proofslip.ai","bugs":{"url":"https://github.com/Johnny-Z13/proofslip/issues"},"bin":{"proofslip-mcp":"dist/bin/cli.js"},"dist":{"shasum":"ff12fb534e508c95a917c8e83034cbc7ffc7cb15","tarball":"https://registry.npmjs.org/@proofslip/mcp-server/-/mcp-server-0.2.2.tgz","fileCount":19,"integrity":"sha512-y2+J1MWYWJfHXYTq6QxYESGsZQAIAa23R3y/r7Fc9O241x2Z2Tqp6yupmaI+3iCQRQdxpZwecenM8OHK28x7sg==","signatures":[{"sig":"MEUCIDFtwPsocmpdNeB+zdQw3wGug9bmuSh/paf5/ikh5UWaAiEA3cSAptWRxOLDW3q4Qwlcoj1kWz9pzpNazGjJSjZnoeo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18160},"main":"./dist/src/index.js","type":"module","types":"./dist/src/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"fbcb2acc82b73c6aba151bfe6e17cc471a308ca0","scripts":{"dev":"tsx src/index.ts","build":"tsc"},"_npmUser":{"name":"johnnyz13","email":"johnny@z13labs.com"},"repository":{"url":"git+https://github.com/Johnny-Z13/proofslip.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.6.2","description":"MCP server for ProofSlip — receipt-based verification for AI agent workflows","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.9.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.2_1775230306028_0.4729133647012582","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@proofslip/mcp-server","version":"0.2.3","mcpName":"ai.proofslip/mcp-server","description":"MCP server for ProofSlip — receipt-based verification for AI agent workflows","type":"module","bin":{"proofslip-mcp":"dist/bin/cli.js"},"main":"./dist/src/index.js","types":"./dist/src/index.d.ts","exports":{".":{"import":"./dist/src/index.js","types":"./dist/src/index.d.ts"}},"scripts":{"build":"tsc","dev":"tsx src/index.ts"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^3.25.0"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.21.0","typescript":"^5.9.0"},"engines":{"node":">=18.0.0"},"keywords":["mcp","proofslip","receipts","ai-agents","model-context-protocol","verification"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Johnny-Z13/proofslip.git","directory":"packages/mcp-server"},"homepage":"https://proofslip.ai","bugs":{"url":"https://github.com/Johnny-Z13/proofslip/issues"},"gitHead":"c4acef5fa61571f551e44f09c4aad8f659a5e4b7","_id":"@proofslip/mcp-server@0.2.3","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-mdGCuHEXaDnBnoYtXukBjrIMrJfJA2fwqgo58bGwLyfxU8KKuQ7QvKAvjjvG7oikVmousf8E0ypso/QPiy/iiw==","shasum":"0a06756d0e2aac506b0c3b82e241454be6316418","tarball":"https://registry.npmjs.org/@proofslip/mcp-server/-/mcp-server-0.2.3.tgz","fileCount":20,"unpackedSize":19366,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICWfJ4xDsTLD6eliP2Uz4NJS2oGNj6TcM0/x8idLSf9IAiEApUZ5eQEYG1iBXVnUR+RTdXj4QzwL8HU1At6+ilXZbkI="}]},"_npmUser":{"name":"johnnyz13","email":"johnny@z13labs.com"},"directories":{},"maintainers":[{"name":"johnnyz13","email":"johnny@z13labs.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.2.3_1775375647343_0.45184179559952997"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T14:32:40.205Z","modified":"2026-04-05T07:54:07.645Z","0.1.0":"2026-04-01T14:32:40.456Z","0.1.1":"2026-04-01T14:35:10.262Z","0.2.1":"2026-04-03T13:55:32.936Z","0.2.2":"2026-04-03T15:31:46.178Z","0.2.3":"2026-04-05T07:54:07.498Z"},"bugs":{"url":"https://github.com/Johnny-Z13/proofslip/issues"},"license":"MIT","homepage":"https://proofslip.ai","keywords":["mcp","proofslip","receipts","ai-agents","model-context-protocol","verification"],"repository":{"type":"git","url":"git+https://github.com/Johnny-Z13/proofslip.git","directory":"packages/mcp-server"},"description":"MCP server for ProofSlip — receipt-based verification for AI agent workflows","maintainers":[{"name":"johnnyz13","email":"johnny@z13labs.com"}],"readme":"# @proofslip/mcp-server\n\n[![npm version](https://img.shields.io/npm/v/@proofslip/mcp-server)](https://www.npmjs.com/package/@proofslip/mcp-server)\n[![license](https://img.shields.io/npm/l/@proofslip/mcp-server)](https://github.com/Johnny-Z13/proofslip/blob/master/LICENSE)\n[![node](https://img.shields.io/node/v/@proofslip/mcp-server)](https://nodejs.org)\n\nMCP server for [ProofSlip](https://proofslip.ai) — receipt-based verification for AI agent workflows. Create, verify, and poll ephemeral receipts that let agents prove what happened before deciding what happens next.\n\n## Tools\n\n### `create_receipt`\nCreate a receipt to record that something happened. Receipts expire after 24 hours by default.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `type` | enum | Yes | `action`, `approval`, `handshake`, `resume`, `failure` |\n| `status` | string | Yes | Freeform status (e.g. \"success\", \"pending\", \"failed\") |\n| `summary` | string | Yes | What happened — max 280 chars |\n| `payload` | object | No | Structured JSON data (max 4KB) |\n| `ref` | object | No | Workflow references (run_id, agent_id, workflow_id, etc.) |\n| `expires_in` | number | No | TTL in seconds (60–86400, default 24h) |\n| `idempotency_key` | string | No | Prevents duplicate receipts on retry |\n| `audience` | \"human\" | No | Enrich verify page with social cards |\n\n**Requires:** `PROOFSLIP_API_KEY` environment variable.\n\n### `verify_receipt`\nVerify a receipt and retrieve its full data before deciding what to do next.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `receipt_id` | string | Yes | The receipt ID (starts with `rct_`) |\n\n**No API key required.**\n\n### `check_receipt_status`\nLightweight status poll — returns only status and polling guidance, no payload.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `receipt_id` | string | Yes | The receipt ID (starts with `rct_`) |\n\n**No API key required.** Use this instead of `verify_receipt` when you only need to know if state has changed.\n\n### `signup`\nGet a free API key (500 receipts/month).\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `email` | string | Yes | Your email address |\n\n**No API key required.**\n\n## Usage Example\n\n```\nYou: \"Create a receipt proving we sent the welcome email\"\n\nAgent calls create_receipt:\n  type: \"action\"\n  status: \"success\"\n  summary: \"Sent welcome email to user@example.com\"\n  ref: { workflow_id: \"onboarding-123\", agent_id: \"email-agent\" }\n\n→ Returns receipt_id, verify_url, is_terminal: true\n\nYou: \"Verify receipt rct_abc123 before sending the follow-up\"\n\nAgent calls verify_receipt:\n  receipt_id: \"rct_abc123\"\n\n→ Returns full receipt: type, status, summary, payload, ref\n→ Agent confirms the action happened before proceeding\n\nYou: \"Check if the approval is still pending\"\n\nAgent calls check_receipt_status:\n  receipt_id: \"rct_def456\"\n\n→ Returns: status: \"pending\", is_terminal: false, next_poll_after_seconds: 30\n→ Agent waits 30s then checks again\n```\n\n## Setup\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"proofslip\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@proofslip/mcp-server\"],\n      \"env\": {\n        \"PROOFSLIP_API_KEY\": \"ak_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / Windsurf\n\nAdd to MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"proofslip\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@proofslip/mcp-server\"],\n      \"env\": {\n        \"PROOFSLIP_API_KEY\": \"ak_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add proofslip -- npx -y @proofslip/mcp-server\n```\n\nThen set your API key in your environment or `.env` file.\n\n## Configuration\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `PROOFSLIP_API_KEY` | For creating receipts | Your API key (starts with `ak_`) |\n| `PROOFSLIP_BASE_URL` | No | API base URL (default: `https://proofslip.ai`) |\n\n## Get an API Key\n\nUse the `signup` tool from any MCP client, or:\n\n```bash\ncurl -X POST https://proofslip.ai/v1/auth/signup \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"you@example.com\", \"source\": \"api\"}'\n```\n\n## Links\n\n- [Live Site](https://proofslip.ai)\n- [API Docs](https://proofslip.ai/docs)\n- [Example Receipt](https://proofslip.ai/example)\n- [Context Capsule](https://www.contextcapsule.ai) (sister product — execution context for handoffs)\n- [GitHub](https://github.com/Johnny-Z13/proofslip)\n\n## License\n\n[MIT](https://github.com/Johnny-Z13/proofslip/blob/master/LICENSE)\n","readmeFilename":"README.md"}