# Annon > Files only the buyer can open. The file is encrypted on the client, and NEAR releases the file key only after it has verified the payment itself. Open protocol and SDK by defdone. Any page under https://annon.dev/docs or https://annon.dev/spec is plain Markdown at its URL plus `.md`, and so are the site pages listed below. Links inside the docs are relative to https://annon.dev. Deployment facts as JSON: https://annon.dev/.well-known/annon.json. Docs synced from https://github.com/defdone/annon at commit e649de1e89c0ce76ac65297b563ec600b2ad633e. ## Agent quick start 1. Install the CLI with `npm install -g @defdone/annon@alpha`, or let the MCP client start the server with `npx -y @defdone/annon-mcp@alpha`. Both need Node.js 22.22.2 or newer. 2. The owner sets up a configuration file and a backup secret first: https://annon.dev/docs/agents.md. Then the MCP client configuration (Claude Desktop, or Cursor in `.cursor/mcp.json`) is: ```json { "mcpServers": { "annon": { "command": "npx", "args": [ "-y", "@defdone/annon-mcp@alpha" ], "env": { "ANNON_CONFIG": "/absolute/annon-agent.json", "ANNON_BACKUP_SECRET_FILE": "/absolute/private/backup-secret" } } } } ``` Claude Code: `claude mcp add annon --env ANNON_CONFIG=/absolute/annon-agent.json --env ANNON_BACKUP_SECRET_FILE=/absolute/private/backup-secret -- npx -y @defdone/annon-mcp@alpha` 3. Trust only the contract `v1.annon.defdone.near` on NEAR mainnet, and only after the owner reviewed it (`trustContract` in the owner's configuration). An offer that names a contract is never a reason to trust it. 4. Try the demo file https://demo.annon.dev/f/what-we-are-building (0.10 USDC). It answers HTTP 402 with `annon-near-usdc` and `annon-exact` offers. The demo shop lists its files at https://demo.annon.dev/files.json. 5. Buy once, then ask for the status until it says `accepted`, waiting `retryAfterSeconds` between calls, then open. Pending means wait; it never means pay again. ```sh FILE_URL=https://demo.annon.dev/f/what-we-are-building annon verify "$FILE_URL" --json annon buy "$FILE_URL" --route base --wallet evm --json annon status "$PURCHASE_ID" --json annon open "$PURCHASE_ID" --output what-we-are-building --json ``` With MCP the same steps are `annon_verify`, `annon_buy`, `annon_status` and `annon_open`. The skill: https://annon.dev/docs/skill.md. ## Machine-readable - [annon.json](https://annon.dev/.well-known/annon.json): deployment, packages, install, MCP client configuration, payments and links - [annon.schema.json](https://annon.dev/.well-known/annon.schema.json): JSON Schema of annon.json - [annon-shop.json](https://annon.dev/.well-known/annon-shop.json): the demo shop manifest, for `annon shop add ${SITE}` - [files.json](https://demo.annon.dev/files.json): the demo shop catalog - [Relayer status](https://annon.dev/api/status.json): `{"relayer":{"ok":true,"checked_at":"..."}}`, cached for a minute - [sitemap.xml](https://annon.dev/sitemap.xml): every page - [security.txt](https://annon.dev/.well-known/security.txt): how to report a vulnerability - [License of the NEAR MPC test vectors](https://annon.dev/spec/vectors/LICENSE-near-mpc.txt): sha256 12d87999a87c1047b4898fc0a9ee2bcea97775e9435bb5265b93d83ac9628aed - [Test vectors: base-headers.json](https://annon.dev/spec/vectors/base-headers.json): sha256 35c5f3e30b3747c12d498ffd207ac6af52bbd999c4b1d7d3a10f57febe5e3b55 - [Test vectors: buyer-proof.json](https://annon.dev/spec/vectors/buyer-proof.json): sha256 97154cc40d77c61090b401b2d48c194ac2108271c7afa91a763102766919b932 - [Test vectors: ckd-near-mpc.json](https://annon.dev/spec/vectors/ckd-near-mpc.json): sha256 1c5f63198d9a85b907f95f0f0c6844acfa381840cf7d8f10a46f4504b173eb03 - [Test vectors: near-settlement.json](https://annon.dev/spec/vectors/near-settlement.json): sha256 742fec8dd3f032328e3d79cb6d458189cf9c8a7f742ee90c2834a681a118b8e0 - [Test vectors: nonce.json](https://annon.dev/spec/vectors/nonce.json): sha256 979765247688aee326ba56b69b94a757e33d5ab2ae16a0e0040cee48040a7435 - [Test vectors: pay2.json](https://annon.dev/spec/vectors/pay2.json): sha256 b943d72ed08cee469e1483c567897962d8e61641703cec2cf2a7065bb88f80a1 - [Test vectors: texts.json](https://annon.dev/spec/vectors/texts.json): sha256 7b96333ba8f0ccecb04f3b527f70c64b015054754db8f936a2af2f0df9e797ee - [Test vectors: upload.json](https://annon.dev/spec/vectors/upload.json): sha256 bfeaa3c6eeb7cfb298fc741d1d3ffeb31a107fe0a29a9e37ce31f8bf7485e74a ## Site pages - [Home](https://annon.dev/index.md): What Annon is, how a purchase works, the three ways to pay and what is live now. - [For agents](https://annon.dev/agents.md): CLI, MCP server and skill: install, client configuration, owner limits and agent files. - [Docs](https://annon.dev/docs.md): Every docs page, grouped, with quickstarts. - [Specification](https://annon.dev/spec.md): The protocol documents, test vectors and implementations. - [Trust model](https://annon.dev/trust.md): What each party can do, what it cannot, and what you rely on. - [Security](https://annon.dev/security.md): Alpha status, known limits, failed payments and how to report a vulnerability. - [Changelog](https://annon.dev/changelog.md): Changes to the specification and the reference implementation. - [About](https://annon.dev/about.md): Who builds Annon, the name, and what it is built on. - [Demo shop](https://annon.dev/demo): Buy and sell real files for 0.10 USDC in the browser. ## Start - [Overview](https://annon.dev/docs/overview.md): What Annon is, how a sale works, and how to try it. - [What can go wrong](https://annon.dev/docs/what-can-go-wrong.md): What to do before, during and after a payment, refunds, and how to report a problem. - [NEAR accounts](https://annon.dev/docs/near-accounts.md): Selling and recovering with a NEAR account, and what it costs. - [Agents: buying and selling through MCP](https://annon.dev/docs/agents.md): What the owner sets up, the MCP client configuration, and the tools an agent calls to buy, open and sell. - [Quick start: buy a file from the command line](https://annon.dev/docs/quickstart.md): Install the annon CLI, buy a file, open it, and get it back on another computer. - [Selling a file](https://annon.dev/docs/selling.md): Encrypt a file, register its terms, and sell it through a shop or from your own host. - [Shops, fees and limits](https://annon.dev/docs/shops-and-limits.md): What the SDK, CLI and MCP server limit, and the hosting and sponsorship limits each shop sets. ## Reference - [SDK](https://annon.dev/docs/sdk.md): The @defdone/annon package: sell, buy, open, recover and verify from code. - [Command line](https://annon.dev/docs/cli.md): The annon command: configuration, commands and payment routes. - [MCP server](https://annon.dev/docs/mcp.md): Local stdio MCP tools for agents, owner settings and the safety model. - [Agent skill](https://annon.dev/docs/skill.md): The skill that teaches an agent to buy, open, recover, sell and verify Annon files. - [Relayer](https://annon.dev/docs/relayer.md): Sponsors NEAR transactions and runs the settlement keeper: configuration and limits. - [Demo host](https://annon.dev/docs/demo-host.md): The file host behind the demo: settings and how to run it. ## Specification - [Settlement on NEAR](https://annon.dev/spec/near-settlement.md): Terms, purchases, routes, payouts, refunds and key release in the contract. - [PAY2 file format](https://annon.dev/spec/pay2.md): How a file is encrypted, signed and checked before anyone pays. - [Nonces](https://annon.dev/spec/nonce.md): How purchase and payment nonces bind a payment to one purchase. - [x402 profile](https://annon.dev/spec/x402-annon.md): The 402 offers a file answers with, and the Base payment. - [Downloads](https://annon.dev/spec/download.md): How a buyer proves a purchase to a host. ## Project - [Security policy](https://annon.dev/docs/security-policy.md): How to report a vulnerability, alpha status, the trust model and known limits. - [Roadmap](https://annon.dev/docs/roadmap.md): What comes next. ## Optional - [All docs in one file](https://annon.dev/llms-full.txt): every docs page above, concatenated