What is APN?
APN gives an AI agent a wallet that it can use but cannot overrule. The agent prepares a payment. The owner reads the exact terms in a terminal and types a code to approve. Only then does APN sign.
Here "APN" always means Agent Payment Node. It has nothing to do with Access Point Name in mobile networks. Read the full explanation for the mechanism, or jump to the install guide.
APN keeps each payment as a durable operation with an idempotency key. If the process crashes or a response is lost, APN does not send the same money twice.
Who is APN for?
APN is for developers who want an AI agent to move money under rules the owner controls. You run it on your own Mac: APN is a local-first runtime, not a hosted service.
- You build an agent that must pay for an API, a resource or a transfer, and you want a hard spending limit that the agent cannot raise.
- You want direct transfers to need a human at a terminal and x402 spending to stay inside a policy you activated, even when the agent runs the rest of the flow on its own.
- You want a payment that survives a crash, a restart or a lost network response without a double send.
- You use an MCP client and want payment tools that prepare and inspect operations, while approval stays a command the human runs in a terminal.
What does APN cover?
- Direct transfers of native coins and listed tokens on EVM networks, Solana and TRON. See EVM, Solana and TRON.
- Standard x402 purchases: EIP-3009 USDC, Permit2 and ERC-20 transfer-proof merchants. See x402.
- USDC transfers where the gas is paid from the USDC amount, and Ethereum USDT through a keyless sponsor. See gasless.
- Bridges through LI.FI with Across and Stargate, Relay, Circle CCTP V2, GasZip, NEAR 1Click and direct Stargate V2. See bridges.
- Guarded swaps: Uniswap V3 on Ethereum, SunSwap on TRON, and Jupiter and Orca on Solana. See swaps.
- An owner allowlist that admits each asset, rail and mechanism with per-operation and daily caps. See security.
Wallets can be local and encrypted, or provider-managed through Coinbase Agentic Wallet, MetaMask Agent Wallet or MetaMask Smart Account. The wallets page explains each.
How do I install APN?
APN runs on Apple Silicon macOS with Node 24. Install it with Homebrew:
brew install nuanu-ai/tap/apnThen list the commands the installed version supports:
apn --help
apn help --jsonThe install page covers the Node 24 PATH note and how to verify a release. The quickstart walks through a first Base USDC transfer.
How does APN work with MCP?
apn mcp config prints the launch descriptor and apn mcp serve runs a local stdio MCP server. Its tools run the same code as the CLI.
MCP never approves a payment. Commands that need a human, such as approve, execute and allowlist activate, are not MCP tools. One apn_foreground_handoff tool returns the exact command for the human to run in a terminal. See the MCP page.
Where do I go next?
- What is APN? explains the idea and the mechanism in plain words.
- Install and quickstart get you to a first transfer.
- MCP and x402 cover how agents call APN and how they buy from sellers.
- Wallets, security and recovery explain keys, limits and what happens after a crash.
- EVM, Solana, TRON, gasless, bridges and swaps cover each family.
- x402, AP2 and APN shows how APN relates to those standards.
- FAQ answers short questions, and releases lists published versions.
APN is MIT licensed. The source is on GitHub.
Questions
What is Agent Payment Node (APN)?
APN is an open-source, local-first payment runtime for AI agents. An agent uses it through the apn CLI or a local stdio MCP server, and a human owner sets spending limits and approves direct transfers in a terminal.
Is APN the same as Access Point Name?
No. On this site APN means Agent Payment Node, a payment tool for AI agents. It is unrelated to mobile-network access point names.
Which platforms does APN support?
Apple Silicon macOS with Node 24. Linux and Windows are unsupported.