Log inSubmit server
Agent Receipts logo

Agent Receipts

by webaesbyamin

Adds local persistent memory and Ed25519-signed receipts for AI agent actions, with verification, export, and audit tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Agent Receipts

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "webaesbyamin-agent-receipts": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-receipts/mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

webaesbyamin/agent-receipts MCP server gives AI agents persistent memory and cryptographically signed records of memory changes and tracked actions. It stores data locally in SQLite, signs receipts with Ed25519, and hashes inputs and outputs without retaining the raw data in the receipt. MCP tools cover memory context, observations, recall, forgetting, action tracking, verification, constraints, judgments, invoicing, and bundles. Reach for it when an agent needs traceable memory or independently verifiable evidence of what it did, without a cloud service.

Use cases

  • Preserve agent memory across sessions
  • Verify significant agent actions offline
  • Audit how a stored fact entered memory
  • Export portable, verifiable memory bundles
  • Inspect receipts and memory through a local dashboard

Key features

  • Ed25519-signed receipts
  • Persistent entity-observation memory
  • SHA-256 input and output hashes
  • Local SQLite and FTS5 storage
  • Portable memory bundle export
  • Receipt verification and audit chains

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/8 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @agent-receipts/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads276Package downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Agent Receipts works

What webaesbyamin/agent-receipts MCP server does

webaesbyamin/agent-receipts provides an MCP interface for two related jobs: maintaining structured memory across agent sessions and producing verifiable receipts for memory events and agent actions. Memory is organized as entities, observations, relationships, preferences, and facts rather than a simple key-value list. Each stored observation can be traced to the conversation that created it.

The webaesbyamin/agent-receipts MCP server also records signed JSON receipts. A receipt contains an Ed25519 signature, hashes for the input and output, timestamps, an agent identifier, and links in a provenance chain. This lets a verifier check the record without relying on the agent's own mutable log or retaining the original raw payload in the receipt.

How it works

The server runs locally through the @agent-receipts/mcp-server npm package. Its default storage is a SQLite database under ~/.agent-receipts/, with FTS5 used for full-text memory search.

A typical session starts with memory_context, which loads relevant known information. The agent can call memory_observe when it learns a durable fact, memory_recall to search existing memory, and memory_forget to soft-delete information while preserving an audit trail. Significant work can be recorded with track_action. The system prompt supplied by the project tells an agent when to use these operations, so memory and action tracking do not depend only on manual calls.

Receipts can be checked with verification tools, and memory can be exported as a portable bundle. An export includes entities, observations, relationships, their creating receipts, and the public key needed for verification.

Setup and configuration

Install the MCP server with npx and add it to an MCP client using the command npx @agent-receipts/mcp-server. Claude Code uses claude mcp add agent-receipts -- npx @agent-receipts/mcp-server. Claude Desktop and Cursor can use an MCP configuration entry with command set to npx and args set to [@agent-receipts/mcp-server].

After adding the server, generate the client-specific system prompt with npx @agent-receipts/cli prompts claude-code. The generated text should be copied into project instructions or the agent's system prompt. No required environment variables or external credentials are documented.

The optional dashboard starts with npx @agent-receipts/dashboard and is available at localhost:3274. CLI commands include statistics, memory inspection, and memory export, such as npx @agent-receipts/cli stats and npx @agent-receipts/cli memory export.

Tools and capabilities

  • Persistent memory context, observation, recall, and forgetting.
  • Action tracking and receipt lifecycle operations.
  • Ed25519 receipt verification and public-key access.
  • Constraints, AI judgments, invoicing, and bundle operations.
  • Local receipt, memory, chain, agent, and related dashboard views.

The underlying SDK includes methods for starting and completing pending receipts, retrieving or listing receipts, checking judgments, and cleanup. The CLI also provides memory subcommands and terminal summaries.

Limitations and notes

webaesbyamin/agent-receipts is local-first, so its documented storage model is a SQLite database on the host running the server. The system prompt is an important part of the workflow: without it, an agent may not automatically call memory or action tools at the intended points.

Receipts hash inputs and outputs rather than storing the raw data in the receipt itself. Verification establishes the integrity of the signed record and its chain; it does not by itself establish that an agent's underlying action was appropriate or that an asserted result is factually correct. Exported bundles are intended to be independently verifiable using the included public key.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Agent Receipts

webaesbyamin/agent-receipts is an MCP server that connects AI agents to local persistent memory and cryptographic receipt storage. Its main tools support memory context, observation, recall, forgetting, action tracking, receipt verification, constraints, judgments, invoicing, and bundle export. It uses SQLite locally and signs records with Ed25519.

Install it by running `npx @agent-receipts/mcp-server` through your MCP client's server configuration. Claude Code supports `claude mcp add agent-receipts -- npx @agent-receipts/mcp-server`; Claude Desktop and Cursor use an MCP JSON entry with `npx` as the command.

Generate it with `npx @agent-receipts/cli prompts claude-code`, then copy the output into your project instructions or system prompt. The prompt tells the agent when to load context, save observations, and track significant actions.

Yes, it is documented as an offline, local-first server that requires no API key, account, or cloud service. Its SQLite database is stored under `~/.agent-receipts/`, and receipts can be verified using local data and the associated public key.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAgent Receipts AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/webaesbyamin-agent-receipts?style=directory)](https://allmcps.com/mcp/webaesbyamin-agent-receipts)
HTML Embed
<a href="https://allmcps.com/mcp/webaesbyamin-agent-receipts"><img src="https://allmcps.com/api/badge/webaesbyamin-agent-receipts?style=directory" alt="Agent Receipts on AllMCPs" /></a>