SPR (Sealed Payment Record) — Claude Code MCP server
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.
Apache-2.0 updated 2026-11-16
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-mcpWhat SPR (Sealed Payment Record) 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.
What it helps with
- 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 for the agent
- 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.
How to install SPR (Sealed Payment Record)
Platform CLI
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-mcpReplace <…> with your own values
Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about SPR (Sealed Payment Record)
How do I install SPR (Sealed Payment Record) in Claude Code?
Run claude mcp add spr-mcp -e SPR_AGENT_ID=<SPR_AGENT_ID> -e SPR_ENTITY=<SPR_ENTITY> -- npx -y @luca-network/spr-mcp. Set SPR_AGENT_ID for the agent and SPR_ENTITY for the company it pays for.
What does SPR (Sealed Payment Record) do?
It stores an agent’s declared intent before payment and the reported settlement afterward, then checks the payment against the declaration. Records stay in a local folder and are sealed with the company’s key.
What does SPR (Sealed Payment Record) need to run?
It uses npx and requires SPR_AGENT_ID and SPR_ENTITY; SPR_DIR selects the records folder. Local records do not confirm payment details with the payment rail.