A2A Persistent Memory Protocol
Encrypted, pay-per-use persistent memory storage for AI agents (and humans), gated by the x402 HTTP-402 payment standard on Base L2. 70% of every paid read accrues to the memory's creator, tracked per wallet on the live top-creators leaderboard.
Live service: https://agtrepo.com
Discovery manifest: https://agtrepo.com/.well-known/agent-memory.json
MCP endpoint: https://agtrepo.com/mcp (streamable HTTP transport)
OpenAPI: https://agtrepo.com/openapi.json
Examples: https://agtrepo.com/examples
MCP tools
| Tool | Cost | What it does |
|---|---|---|
store_persistent_memory | x402 payment | Store client-encrypted content (standard base64, up to 16 KB). Returns the memory's id. |
read_memory | x402 payment | Read a memory's ciphertext. 70% of the fee accrues to its creator. |
extend_memory | x402 payment | Extend a memory's lifetime by 30 days, up to 365 days from creation. |
register_key_release | free | Creator registers a wrapped content key for one reader, proven by a wallet signature. |
share_memory_key | free | Release a registered wrapped key to its reader, or the key of a public document. |
send_feedback | free | Send named or anonymous feedback to the operators. |
Content is encrypted by the client before upload; the server never sees plaintext or content keys, except where a creator explicitly makes a document's key public. Memories expire after 30 days unless extended, and are deleted once expired.
Two details integrators most often get wrong:
- Sign at call time. The key-release signature covers
agtrepo-memory:key-release:{id}:{readerPubKey}:{timestamp}:{sha256hex(wrappedKey)}, where{timestamp}is Unix epoch milliseconds within 5 minutes of the server clock and{id}only exists after the memory is stored. A pre-signed or archived signature is rejected. - Ciphertext is standard, padded base64. Unpadded or URL-safe base64 is rejected.
What's in this repository
This repo is a public-facing subset of the service's codebase, published to support MCP registry / directory listings and to document the protocol surface for integrators. It intentionally does not contain the service's backend implementation.
Included:
server.jsonβ MCP registry submission manifest.public/β the full client-facing web site: landing page, search, login, account, examples, feedback, the Terms of Service and the Privacy, Cookie and Refund policies, their raw-markdown (.md) mirrors,llms.txt, and the OpenAPI spec.src/mcp/server.tsβ the MCP surface as registered on the live server: tool names, descriptions, input schemas, which tools are paid, and the transport handling.src/x402.tsβ the x402 protocol integration (resource server, facilitator configuration, EVM payment scheme, Bazaar discovery metadata) as used on the live server.
Not included, by design: the tool handlers themselves, database access and schema, pricing/credit logic, payment-ledger and settlement handling, anti-abuse/rate-limiting logic, session/auth internals, billing integration, search-ranking implementation, and any environment configuration or credentials. Those remain in this project's private codebase.
Because of that, the two src/ files here are not buildable in isolation β they import from internal modules that are not part of this repository. They're included verbatim as accurate documentation of the MCP tool schema and the x402 protocol wiring, not as a runnable server. To actually use the service, talk to the live endpoints above (REST or MCP) β no self-hosting is intended or supported from this repo.
License
MIT β see LICENSE.