AgentPay

Secure payments infrastructure for AI agents.

A wallet for your AI agent. Let your agent purchase approved items within a budget, giving you back your time. Fully encrypted and local. Everything runs on the user's machine except for CUA running on Browserbase (can configure to https://github.com/trycua/cua + playwright using a headless browser).

Install

npm install @useagentpay/sdk

Quick Start

Human — set up credentials:

agentpay setup       # encrypt & store billing credentials locally
agentpay budget --set 200

Agent — propose & execute:

import { AgentPay } from '@useagentpay/sdk';
const ap = new AgentPay();

const tx = await ap.transactions.propose({
  merchant: 'amazon.com',
  amount: 29.99,
  description: 'Wireless mouse',
  url: 'https://amazon.com/dp/B09ABC1234',
});

const result = await ap.transactions.waitForApproval(tx.id);

if (result.status === 'approved') {
  const receipt = await ap.transactions.execute(tx.id);
}

Human — approve:

agentpay approve tx_a1b2c3   # signs with your local keypair

How It Works

1. Human encrypts billing credentials locally (~/.agentpay/credentials.enc)
2. Agent proposes a purchase — human reviews and approves (cryptographically signed)
3. Browserbase session fills checkout with {{placeholders}}
4. Real values swapped in milliseconds before form submission — agent never sees them
5. Agent gets a receipt. That's it.

Security

• Credentials never leave your machine except encrypted in transit to Browserbase at checkout
• Placeholder injection — forms show {{card_number}} until the instant of submission
• Signed purchase mandates — Ed25519 proof that a real human approved each transaction (inspired by Google AP2)
• Recording disabled — no Browserbase session playback
• Open source — audit the entire security model

MCP Server

Use AgentPay from any MCP-compatible host (Claude Desktop, Cursor, Claude Code, Windsurf):

npx @useagentpay/mcp-server

Or add to your host config:

{ "mcpServers": { "agentpay": { "command": "npx", "args": ["@useagentpay/mcp-server"] } } }

8 tools, 3 resources, 3 prompts — covers the full purchase lifecycle. See the MCP server package for details.

Packages

Docs

Browserbase

• SDK users: AgentPay handles Browserbase. Set BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID.
• Fork users: Set up your own Browserbase account.

License

MIT