# SPR (Sealed Payment Record)

SPR (Sealed Payment Record) is an MCP server for Claude Code that records an AI agent's payment intent before payment and the reported payment details afterward.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: luca-network
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/luca-network/spr
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/spr-sealed-payment-record

## What it does

SPR stores an agent’s payment records in a local folder and seals them with the company’s key. Before paying, the agent calls `record_intent`; `check_payment` compares the payment with the declared cap and payee and checks whether it was already paid. Afterward, the agent calls `record_settlement`.

Run it with `npx`; set `SPR_AGENT_ID` and `SPR_ENTITY`, and use `SPR_DIR` to choose where records are stored. The install command is `npx -y @luca-network/spr-mcp`. Local records reflect information supplied by the agent, not confirmation from the payment rail. Seals can be checked separately with `spr-verify` or `python -m spr`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SPR_AGENT_ID`, `SPR_ENTITY`, `SPR_DIR`, `SPR_TIME_ZONE`, `SPR_BINDING` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SPR_AGENT_ID=<SPR_AGENT_ID> --env SPR_ENTITY=<SPR_ENTITY> --env SPR_DIR=<SPR_DIR> --env SPR_TIME_ZONE=<SPR_TIME_ZONE> --env SPR_BINDING=<SPR_BINDING> --transport stdio spr-sealed-payment-record -- npx -y @luca-network/spr-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add spr-sealed-payment-record --env SPR_AGENT_ID=<SPR_AGENT_ID> --env SPR_ENTITY=<SPR_ENTITY> --env SPR_DIR=<SPR_DIR> --env SPR_TIME_ZONE=<SPR_TIME_ZONE> --env SPR_BINDING=<SPR_BINDING> -- npx -y @luca-network/spr-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spr-sealed-payment-record": {
            "command": "npx",
            "args": [
                "-y",
                "@luca-network/spr-mcp"
            ],
            "env": {
                "SPR_AGENT_ID": "<SPR_AGENT_ID>",
                "SPR_ENTITY": "<SPR_ENTITY>",
                "SPR_DIR": "<SPR_DIR>",
                "SPR_TIME_ZONE": "<SPR_TIME_ZONE>",
                "SPR_BINDING": "<SPR_BINDING>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "spr-sealed-payment-record": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@luca-network/spr-mcp"
            ],
            "env": {
                "SPR_AGENT_ID": "<SPR_AGENT_ID>",
                "SPR_ENTITY": "<SPR_ENTITY>",
                "SPR_DIR": "<SPR_DIR>",
                "SPR_TIME_ZONE": "<SPR_TIME_ZONE>",
                "SPR_BINDING": "<SPR_BINDING>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SPR_AGENT_ID=<SPR_AGENT_ID> -e SPR_ENTITY=<SPR_ENTITY> -e SPR_DIR=<SPR_DIR> -e SPR_TIME_ZONE=<SPR_TIME_ZONE> -e SPR_BINDING=<SPR_BINDING> spr-sealed-payment-record npx -y @luca-network/spr-mcp
```
Replace <…> with your own values

## When to use it
- record an agent’s intent before it spends funds
- compare a payment with its stated cap and payee
- check whether the same transaction was paid already
- save the details reported after a payment

## Example prompts
- Record the agent’s purpose, spending cap, and payee before it pays.
- Compare this payment with the saved intent and check for an earlier payment.
- Save a settlement record after the payment goes through.

## Similar
- [KeyHalve - verify sealed documents](https://affpapa.org/en/nevibecode/mcp/keyhalve-verify-sealed-documents.md) — MCP server
- [create-payment-credential](https://affpapa.org/en/nevibecode/skills/create-payment-credential.md) — skill · 27200 installs
- [payment-assistant](https://affpapa.org/en/nevibecode/skills/payment-assistant.md) — skill · 4800 installs
- [qianwen-payment](https://affpapa.org/en/nevibecode/skills/qianwen-payment.md) — skill · 3200 installs
- [payment-testing](https://affpapa.org/en/nevibecode/skills/payment-testing.md) — skill · 1300 installs
- [payment-provider-protocol](https://affpapa.org/en/nevibecode/skills/payment-provider-protocol.md) — skill · 1100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
