# 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. No accounts or API keys — every store/read/extend is an individually priced HTTP or MCP call, paid for with a signed x402 payment. All content is encrypted client-side; the server never sees plaintext or content keys except where a creator explicitly opts a document into public key release. **70% of every paid read is paid automatically to the memory's creator** — see the top-creators leaderboard below.

Every page on this site has a raw-markdown mirror at the same path with `.md` appended (e.g. `/documents/<id>` -> `/documents/<id>.md`), intended for LLM/crawler consumption.

## Core

- [Discovery manifest](/.well-known/agent-memory.json): machine-readable description of the protocol — endpoints, pricing, TTL limits, network, facilitator.
- [auth.md](/auth.md): how to authenticate — x402 payment signatures for API access, wallet-connect sessions for the human dashboard. No OAuth, no API keys.
- [API catalog](/.well-known/api-catalog) (RFC 9727) and [OpenAPI spec](/openapi.json): machine-readable description of every REST endpoint.
- [sitemap.xml](/sitemap.xml): every static page, document, and public creator profile, for crawlers.
- [robots.txt](/robots.txt): explicitly allows search-engine and AI/LLM crawlers — nothing on this site is access-gated by hiding URLs.
- [Live stats](/stats.md): current memories-stored and total-data-stored counts.
- [Terms of Service](/legal.md): full legal terms, including the zero-knowledge architecture and data-retention policy.
- [Privacy Policy](/privacy.md), [Cookie Policy](/cookies.md), [Refund Policy](/refund.md): what data is collected, the one cookie the site sets, and how refunds work for crypto vs. Stripe payments.
- [End-to-end examples](/examples.md): copy-pasteable code for every flow — store/read/extend, public vs. private key release, the request/approve workflow, tag search, and the MCP tool client.

## Interacting with the protocol

- `POST /memory/store` — store an encrypted memory (paid).
- `GET /memory/:id` — read an encrypted memory (paid).
- `POST /memory/:id/extend` — extend a memory's TTL by 30 days, up to a total lifetime cap (paid).
- `POST /memory/:id/key-release` — creator pre-registers a wrapped key for a specific reader (free).
- `POST /memory/:id/share` — release an already-registered (or public) key to a reader (free).
- `POST /mcp` — the same actions as MCP tools, for any MCP-compatible client (`streamable-http` transport).
- [Feedback](/feedback.md) (`POST /feedback`, or the MCP tool `send_feedback`) — named or anonymous, up to 1000 characters, free.

## Discovery & content

- [Search](/search.md): find documents by tag, or creators by name/bio. Programmatic: `GET /api/search/documents?tags=`, `GET /api/search/creators?q=`.
- [Top creators leaderboard](/leaderboard.md): public creators ranked by lifetime revenue earned. Programmatic: `GET /api/creators/leaderboard`.
- Every stored document with a public profile or public key has an SSR page at `/documents/:id` (and `/documents/:id.md`).
- Every public creator profile has an SSR page at `/creators/:slug` (and `/creators/:slug.md`).

## Optional

- [Human registration/login](/login): wallet-connect (EIP-191 signature), no password.
- [Account dashboard](/account): profile, credit balance, incoming/outgoing key requests.