Command line
For any agent with a shell. --json prints one JSON line and turns off prompts. Needs Node.js 22.22.2 or newer.
npm install -g @defdone/annon@alphaAn Annon file is an ordinary URL. It answers with HTTP 402 and its offers; an agent with a wallet pays, receives the key and opens the file, with no account and no person in the loop.
For any agent with a shell. --json prints one JSON line and turns off prompts. Needs Node.js 22.22.2 or newer.
npm install -g @defdone/annon@alphaFor MCP clients. Tools: annon_share, annon_sell, annon_buy, annon_open, annon_verify, annon_recover, annon_budget, annon_status, annon_shops, annon_catalog.
npx -y @defdone/annon-mcp@alphaA short instruction file an agent reads once, then drives the command line on its own, including when to wait and never pay twice.
skills/annon/SKILL.mdThe owner, not the agent, sets the contract it trusts, the endpoints it reads, the most it may pay per file and per day, and the directory it may read and write. A tool call or an offer cannot change them. Keys come from a file or the environment and never appear in the agent's output.
The client configuration starts the server. The owner writes the configuration file it reads (ANNON_CONFIG), with the fields in What the owner sets, and keeps the wallet key and the backup secret (ANNON_BACKUP_SECRET_FILE) in files only the owner controls. Step by step in the agents guide.
{
"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"
}
}
}
}Full owner configuration in the MCP server reference CLI configuration
Replace the two paths with the configuration file and the backup secret the owner created. The server runs locally over stdio.
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{
"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"
}
}
}
}Two kinds of offer for the same file: USDC on NEAR, which any chain can pay through NEAR Intents, and USDC on Base. The agent picks the route its wallet can pay and gets a purchase it can check on NEAR.
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 --jsonEvery command answers { "ok": true, "result": ... } or { "ok": false, "error": { "code": ..., "message": ... } }.
After the owner's setup, the agent sets FILE_URL to the file it wants, buys once, and sets PURCHASE_ID to the full purchase ID in the buy result. It asks for the status until it says accepted, waiting as long as retryAfterSeconds says.
Pending means wait. It never means pay again.
Everything an agent needs, as plain files on this site. Every page under /docs and /spec is also Markdown at its URL plus .md.
files.json.what-we-are-building costs 0.10 USDC. Base needs 0.10 USDC on Base and no ETH. NEAR needs 0.10 USDC on NEAR and a little NEAR for gas.