Protokolliert und versiegelt Zahlungen von AI Agents als signierte Datensätze auf deinem lokalen Rechner, um Auditierbarkeit und die Verifizierung der Absicht (Intent) zu gewährleisten.
Auch bekannt als luca-network/spr, spr, @luca-network/spr-mcp, @luca-network/spr-sdk
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- 5.210
- Neueste Version
- 0.2.0
- Letzter Commit
- 16. Nov. 2026
- Lizenz
- Apache-2.0
Was ist SPR MCP?
Protokolliert und versiegelt Zahlungen von AI Agents als signierte Datensätze auf deinem lokalen Rechner, um Auditierbarkeit und die Verifizierung der Absicht (Intent) zu gewährleisten.
Zusammenfassung generiert aus dem README des Projekts
Über SPR MCP server
SPR bietet eine Möglichkeit, Zahlungen von AI Agents als signierte Datensätze auf einem lokalen Rechner zu protokollieren und zu versiegeln. Dieses Tool wurde für Entwickler und Finanzteams entwickelt, die Auditierbarkeit sicherstellen und die Absicht hinter jeder Transaktion eines Agents verifizieren müssen. Durch den lokalen Betrieb des MCP server können Nutzer eine nachvollziehbare Historie darüber erstellen, was ein Agent als Zahlung angekündigt hat im Vergleich zu dem, was tatsächlich abgewickelt wurde.
Um den Server zu nutzen, musst du Umgebungsvariablen wie SPR_AGENT_ID, SPR_ENTITY und einen Verzeichnispfad für die Datensätze konfigurieren. Er lässt sich via npx in Clients wie Claude Desktop, Cursor und Claude Code integrieren. Entwickler, die das OpenAI Agents SDK oder LangChain nutzen, können sich ebenfalls über das bereitgestellte JavaScript SDK verbinden. Das System nutzt spezifische Tools wie record_intent, um vor der Zahlung einen Zweck zu deklarieren, check_payment, um zu prüfen, ob die Transaktion innerhalb der deklarierten Limits bleibt, und record_settlement, um den Eintrag nach erfolgter Zahlung abzuschließen.
Was du damit machen kannst
- 1Zahlungsabsicht verifizierenEin AI Agent kann seinen Zweck und seine Ausgabenlimits deklarieren, bevor er eine Transaktion ausführt, um die Auditierbarkeit sicherzustellen.
- 2Lokale Zahlungsdatensätze prüfenEin Entwickler kann die Verifizierungstools nutzen, um zu prüfen, ob die versiegelten Datensätze in einem Ordner mit dem Public Key des Unternehmens übereinstimmen.
- 3Händler-Dispute verwaltenEin Händler kann ein Paket mit Beweisen exportieren, um auf einen Chargeback zu reagieren, indem er die versiegelte Absicht und Authentifizierung des Käufers nachweist.
- 4Integration mit Agent FrameworksEntwickler können den Server mit verschiedenen Python-basierten Agent Frameworks wie CrewAI oder dem Microsoft Agent Framework verbinden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du SPR MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenSPR MCP in Claude Code installieren
$ claude mcp add --env 'SPR_AGENT_ID=<SPR_AGENT_ID>' --env 'SPR_ENTITY=<SPR_ENTITY>' spr -- npx -y @luca-network/spr-mcpSPR MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"spr": {
"command": "npx",
"args": [
"-y",
"@luca-network/spr-mcp"
],
"env": {
"SPR_AGENT_ID": "<SPR_AGENT_ID>",
"SPR_ENTITY": "<SPR_ENTITY>"
}
}
}
}SPR MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"spr": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@luca-network/spr-mcp"
],
"env": {
"SPR_AGENT_ID": "<SPR_AGENT_ID>",
"SPR_ENTITY": "<SPR_ENTITY>"
}
}
}
}SPR MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"spr","type":"stdio","command":"npx","args":["-y","@luca-network/spr-mcp"],"env":{"SPR_AGENT_ID":"<SPR_AGENT_ID>","SPR_ENTITY":"<SPR_ENTITY>"}}'SPR MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"spr": {
"command": "npx",
"args": [
"-y",
"@luca-network/spr-mcp"
],
"env": {
"SPR_AGENT_ID": "<SPR_AGENT_ID>",
"SPR_ENTITY": "<SPR_ENTITY>"
}
}
}
}SPR MCP in Codex installieren
$ codex mcp add spr --env 'SPR_AGENT_ID=<SPR_AGENT_ID>' --env 'SPR_ENTITY=<SPR_ENTITY>' -- npx -y @luca-network/spr-mcpSPR MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.spr] command = "npx" args = ["-y", "@luca-network/spr-mcp"] [mcp_servers.spr.env] SPR_AGENT_ID = "<SPR_AGENT_ID>" SPR_ENTITY = "<SPR_ENTITY>"
SPR MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'SPR_AGENT_ID=<SPR_AGENT_ID>' -e 'SPR_ENTITY=<SPR_ENTITY>' spr npx -- -y @luca-network/spr-mcpSPR MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"spr": {
"command": "npx",
"args": [
"-y",
"@luca-network/spr-mcp"
],
"env": {
"SPR_AGENT_ID": "<SPR_AGENT_ID>",
"SPR_ENTITY": "<SPR_ENTITY>"
}
}
}
}Konfiguration
SPR_AGENT_IDErforderlichThe agent's ID, such as agt_research
SPR_ENTITYErforderlichThe company the agent pays for
SPR_BINDINGon, to return the nonce to sign with each x402 intent
SPR_DIRThe book's folder (default ./spr-books); it holds the company's private key
SPR_TIME_ZONEThe company's time zone for accounting dates (default UTC)
| Name | Beschreibung | Typ |
|---|---|---|
| SPR_AGENT_ID | The agent's ID, such as agt_research | Erforderlich |
| SPR_ENTITY | The company the agent pays for | Erforderlich |
| SPR_BINDING | on, to return the nonce to sign with each x402 intent | |
| SPR_DIR | The book's folder (default ./spr-books); it holds the company's private key | |
| SPR_TIME_ZONE | The company's time zone for accounting dates (default UTC) |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarluca-network/spr is public and reachablegithub.com/luca-network/spr ↗Bestanden
- Paket nennt dieses Repository als Quelle@luca-network/spr-mcp, @luca-network/spr-sdk name luca-network/spr as sourcenpmjs.com/package/@luca-network/spr-mcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for @luca-network/spr-mcp, @luca-network/spr-sdknpmjs.com/package/@luca-network/spr-mcp/v/0.2.0#provenance ↗Bestanden
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-12github.com/luca-network/spr ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @luca-network/spr-mcp, @luca-network/spr-sdkBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten101 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenSPR: the Sealed Payment Record
Your AI agent pays for data, compute and services, and your finance team and auditor can't see what each payment was for. SPR records every payment your agent makes, before and after it pays, sealed with your company's own key on your own machine. Anyone can check the seals. No service has to be trusted, Luca's included.
npx -y @luca-network/spr-mcp
Free and open: Apache-2.0, with a royalty-free patent commitment (PATENTS.md).
Use it from your AI tool
Every setup below runs the same MCP server on your machine. Set SPR_AGENT_ID (your agent) and SPR_ENTITY (the company it pays for); records go to SPR_DIR.
Claude Desktop: add to claude_desktop_config.json:
{ "mcpServers": { "spr": { "command": "npx", "args": ["-y", "@luca-network/spr-mcp"],
"env": { "SPR_AGENT_ID": "agt_research", "SPR_ENTITY": "Example Co", "SPR_DIR": "/Users/you/spr-books" } } } }
Cursor: the same block in .cursor/mcp.json.
Claude Code:
claude mcp add spr -e SPR_AGENT_ID=agt_research -e SPR_ENTITY="Example Co" -- npx -y @luca-network/spr-mcp
OpenAI Agents SDK and LangChain (JavaScript):
import { SprBook, toOpenAIAgentsTools, toLangChainTools } from "@luca-network/spr-sdk";
const book = new SprBook({ dir: "./books", agentId: "agt_research", entity: "Example Co" });
const tools = toOpenAIAgentsTools(book, tool); // tool from "@openai/agents"; or toLangChainTools(book, tool)
CrewAI, Microsoft Agent Framework, Google ADK and the Claude Agent SDK (Python): each connects to the MCP server in a few lines. See examples/.
Any other MCP client: run npx -y @luca-network/spr-mcp over stdio with the two settings above.
The agent then calls record_intent before it pays, check_payment to see whether the payment is inside what it declared, goes to the payee it named and wasn't paid already, and record_settlement after it pays. Each record is sealed in the book's folder.
A merchant's book works the same way for payments received: it can keep the buyer's own sealed intent, how the buyer authenticated, and the order and processor references, and export one payment's evidence for a chargeback response (export_dispute_pack).
A record shows:
- what the agent declared before it paid: the purpose, the most it could spend, and when the permission expired;
- what was actually paid, on which rail, to whom and when;
- whether the payment stayed inside what was declared;
- for x402 payments, whether the chain itself recorded which declaration the payment was made under. The payer signs a fingerprint of the sealed intent as the payment's nonce.
This repository holds:
| Path | What it is |
|---|---|
SPEC.md |
The format, draft 1 |
packages/spr |
@luca-network/spr, the reference library for JavaScript and TypeScript, with no dependencies, plus the test vectors and spr-verify |
packages/spr-sdk |
@luca-network/spr-sdk: seal your agents' payments locally, with withLuca(fetch) for x402 and tools for the OpenAI Agents SDK and LangChain |
packages/spr-mcp |
@luca-network/spr-mcp: the same calls as an MCP server, for Claude Desktop, Cursor or your own agent (npx @luca-network/spr-mcp) |
python |
spr-sdk for Python: the same format and the same books |
Seal an x402 payment in one line
import { SprBook } from "@luca-network/spr-sdk";
import { withLuca } from "@luca-network/spr-sdk/x402";
const book = new SprBook({ dir: "./books", agentId: "agt_research", entity: "Example Co" });
const pay = withLuca(book, { signer: account });
const res = await pay("https://data.example/prices", {
luca: { purpose: "Market data for the pricing model", max_amount_minor: 20000, currency: "USDC" },
});
res.luca.record; // sealed, matched to its intent, bound on chain
Check anything without Luca
npx spr-verify ./books-export --key company.pem # a package, and whose it is
python -m spr ./books-export --key company.pem
npx spr-verify --vectors # the library against the test vectors
python -m spr --vectors # the Python SDK against the same vectors
company.pem is the company's public key, obtained from the company and never from the package (book.publicKey() gives it). Without --key the checkers show only that a package is consistent with the keys it carries, and say so.
Security problems: see SECURITY.md.
An implementation in any language conforms when it gives the same answers as packages/spr/vectors/vectors.json.
Local SPR and hosted Luca
The packages here run on your own machine and make no call to Luca. Luca's hosted service is a separate product that a book can be sent to.
| Local SPR (these packages) | Hosted Luca | |
|---|---|---|
| Where it runs | Your machine, your folder, your key | Luca's service |
| What it records | The intent before paying and the payment after, as the agent reports them | The same, plus the payment as the rail itself reports it |
| Limits it checks | The declared intent: its cap, its expiry, whether it was withdrawn and the payee it named; the same invoice paid twice. Optionally the book's own mandate.json (limits, payees, a window for repeats), which whoever keeps the folder writes, so it is reported as authority: "self-declared" |
Mandates your finance team approves in Luca |
| Confirmation from the rail | None: the record is what the agent reported | The payment read from the rail, and any difference flagged |
| Accounting | None | Classification to your accounts (US GAAP, IFRS, tax), journal entries posted to your ERP, the month's close |
| Evidence | Seals anyone can check with spr-verify or python -m spr |
Evidence your auditor can check, and the month's audit package |
| Cost | Free, Apache-2.0 | A Luca account |
A book moves across with one call once finance has registered its key: book.sendToLuca(). Luca checks every seal before it stores anything.
Send the book to Luca (optional)
Finance registers the book's key with Luca once (book.registerWithLuca), and then book.sendToLuca() sends the book. Luca checks every seal before it stores anything, and sending the same book again changes nothing. Write to hello@luca.network for an account.
Changes
What changed in each version, and what you may need to change on upgrading: CHANGELOG.md.
Status
This is draft 1 of the format and version 0.1 of the libraries. We expect to change things as people use them. Tell us what breaks or what's missing: open an issue, or write to hello@luca.network.
License
Apache License 2.0 for the code: see LICENSE. Luca's patent commitment, which lets anyone implement the format with or without this code, is in PATENTS.md.
Luca (luca.network) uses SPR for its hosted accounting of agent payments. That covers reading the rails, classifying to US GAAP and IFRS, posting to the ERP, labels agreed with counterparties, and the close.
SPR MCP Fragen
Wie füge ich SPR MCP zu Claude Code hinzu?
Führe claude mcp add --env 'SPR_AGENT_ID=<SPR_AGENT_ID>' --env 'SPR_ENTITY=<SPR_ENTITY>' spr -- npx -y @luca-network/spr-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich SPR MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wo werden die Zahlungsdatensätze gespeichert?
Die Datensätze werden lokal auf deinem eigenen Rechner in einem Verzeichnis gespeichert, das durch die Umgebungsvariable SPR_DIR angegeben wird.
Sendet der MCP server Daten an Luca?
Nein, die lokalen Pakete laufen auf deinem Rechner und führen keine Aufrufe an Luca aus; der Hosted Service von Luca ist ein separates Produkt.
Welche Informationen sind in einem Zahlungsdatensatz enthalten?
Ein Datensatz enthält den deklarierten Zweck, Ausgabenlimits, das Ablaufdatum, den tatsächlich gezahlten Betrag, den Zahlungsweg, den Empfänger und die Information, ob die Zahlung mit der Deklaration übereinstimmte.