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

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.

Related MCP server: Mnemexa MCP

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.