What is APN (Agent Payment Node)?

Agent Payment Node (APN) is an open-source, local-first payment runtime for AI agents. It lets an agent prepare payments while a human owner sets the limits and approves each signature. This page explains the idea, the mechanism and what APN is not.

Updated

APN in plain words

An AI agent that buys things needs a way to pay. Giving it a raw private key is risky, because the agent can spend everything. Giving it nothing makes it useless. APN sits in between.

APN is a program that runs on your machine. The agent talks to it through the apn command line or through a local stdio MCP server. APN holds a local encrypted wallet or binds a provider-managed one, enforces the owner's limits and signs a transfer only after the owner approves it in a terminal. Standard x402 purchases are the exception: they run unattended, but only within the per-payment and balance caps the owner set in a foreground terminal.

APN also records each payment as a durable operation under an idempotency key. If the process crashes or a response is lost, a retry resolves to the same operation. It does not send the same money twice.

Who uses APN and for what?

The user is a developer or owner who runs an AI agent that needs to move money. The agent works through APN. The owner stays in control of limits and approvals.

  • Direct transfers of native coins and listed tokens on EVM networks, Solana and TRON.
  • Standard x402 purchases: EIP-3009 USDC, Permit2 and ERC-20 transfer-proof merchants.
  • USDC transfers whose gas is paid from the USDC amount, and Ethereum USDT through a keyless sponsor.
  • Bridges: LI.FI with Across and Stargate, Relay, Circle CCTP V2, GasZip, NEAR 1Click and direct Stargate V2.
  • Guarded swaps: Uniswap V3 on Ethereum, SunSwap on TRON, Jupiter and Orca on Solana.

Each family has its own page: EVM, Solana, TRON, x402, gasless, bridges and swaps.

How does APN work?

Four ideas explain APN: profiles, owner limits, prepare and approve, and durable operations.

Profiles. Every money command names a profile with --profile. A profile is a local wallet that APN creates (wallet ensure, wallet ensure-solana, wallet ensure-tron) or imports (wallet import). It can also be a provider-managed wallet bound with wallet connect: Coinbase Agentic Wallet, MetaMask Agent Wallet or MetaMask Smart Account. APN never prints or exports a private key. See wallets.

Owner limits. Nothing moves money without limits the owner set. The owner allowlist admits each exact asset on a rail (direct, x402, gasless, bridge or swap) with per-operation and daily caps. For gasless, x402 and bridges it also names the exact mechanism, meaning the provider and reference. It can optionally pin recipients. The owner stages a policy file and activates it in a foreground terminal. APN never fills in a missing cap, account, recipient or amount. See security.

Prepare and approve. A prepare command freezes one exact effect under an idempotency key: chain, asset, amount, recipient and fee budget. It signs nothing. An approve or execute command re-checks the frozen facts and the active policy, shows the exact terms in a foreground terminal and asks for a typed code before signing.

Durable operations. Every send sits behind a durable marker, and an ambiguous send is observed before anything else happens. operation status, operation resume, operation abandon and receipt get work on a saved operation. Status and receipts survive restart, reinstall and upgrades, because Homebrew does not own ~/.apn. See recovery.

What does the agent do, and what does the owner do?

StepWhoWhat happens
Set limitsOwnerStages an allowlist policy file and activates it in a foreground terminal with a typed code.
PrepareAgentRuns prepare, which freezes recipient, amount and fee budget and signs nothing.
ApproveOwnerRuns approve in a foreground terminal, reads the exact terms and types a code.
CheckAgentRuns operation status and receipt get to read the result.

The agent never runs an approval or raises a limit. Its only unattended spending is x402, and that stays inside the caps the owner set.

How does APN relate to MCP?

apn mcp config prints the launch descriptor and apn mcp serve runs the stdio server. MCP tools are projected from the same catalog and run the same code as the CLI.

MCP never approves. Commands that need a human (approve, execute, abandon, wallet connect, allowlist activate) are not separate tools. One apn_foreground_handoff tool validates the arguments exactly as the CLI does and returns the exact command for the human to run in a terminal. It reads and writes nothing. Details are on the MCP page.

What APN is not

  • APN is not a hosted service. It runs on your machine and keeps state in ~/.apn.
  • APN is not a remote MCP server. The MCP server is local and speaks stdio. The README places remote MCP outside this repository.
  • APN is not cross-platform. Only macOS on Apple Silicon is supported, with Node 24. Linux and Windows are unsupported.
  • APN is not savings custody. The README calls its wallet custody local_software_disposable. Encryption protects a copied ~/.apn without the Keychain secret, but not a compromised, unlocked login session.
  • APN is not proof of live payments by its tests. The README says deterministic tests are source proof, not live provider acceptance or payment proof.

How do I try it?

Install with Homebrew, then follow the first journey, a direct Base USDC transfer.

brew install nuanu-ai/tap/apn

Go to install for the Node 24 note and release verification, then the quickstart. APN is MIT licensed and developed on GitHub.

Short answers to common questions are on the APN FAQ, and x402, AP2 and APN explains how APN relates to those protocols.

Questions

What does APN stand for in AI agents?

Agent Payment Node. It is an open-source, local-first payment runtime for AI agents.

Can the agent approve its own payments?

Not for transfers, bridges or swaps: approval needs the human owner in a foreground terminal, who reads the exact terms and types a code. Standard x402 purchases run unattended, but only within the per-payment and balance caps the owner set in the foreground.

Does APN run in the cloud?

No. It runs locally on Apple Silicon macOS and is not a hosted service or a remote MCP server.

Sources
  1. README: overview
  2. README: how APN works
  3. README: custody and threat model
  4. README: recovery guarantees
  5. README: proof boundary
  6. Platform support matrix