Model Context Protocol

Payment tools your agent can call directly

Point any MCP client at the AgentPay server and your agent gains a scoped, policy-enforced wallet — without you writing a tool layer.

Get an MCP URL Read the docs

claude_desktop_config.json

{
  "mcpServers": {
    "agentpay": {
      "type": "http",
      "url": "https://mcp.agentpay.dev/v1",
      "headers": { "Authorization": "Bearer sk_test_••••4f2a" }
    }
  }
}

Tool catalog

Eleven tools, one policy engine behind them

Every tool call is evaluated against the same budgets, policies, and risk signals as the API and dashboard.

create_card

Mint a single-use or multi-use card with amount, merchant, and expiry.

list_cards

Cards assigned to the connected agent, with balances and status.

get_card

Non-sensitive card detail: type, limits, restrictions, spend.

get_card_credentials

Elevated permission only. Short-lived, fully audited, never logged.

get_balance

Agent budget, card balance, and organization wallet balance.

list_transactions

Transactions for the connected agent with status and decline reasons.

request_purchase

Open a purchase task with product, merchant preference, and cap.

request_approval

Page a human approver with the cart and all-in total.

get_approval_status

Poll whether a pending purchase was approved or declined.

cancel_card

Cancel an active card and release its reserved balance.

buy

End-to-end purchase workflow for supported merchant integrations.

Guardrails

The buy tool refuses to check out early

Checkout only proceeds once required information is collected, the final total is calculated, policies are evaluated, any required approval is received, and a valid card exists.

mcp · buy

> buy({ description: "Standing desk under $400", merchant: "Amazon" })

blocked: approval_required
  policy  pol_office_250 — amount above $250 in office_supplies
  approver  finance@northwind.co (notified in Slack)
  expires_at  2026-08-02T20:14:00Z

> get_approval_status({ id: "apr_71bc" })
approved  amount_cents: 38900  by: finance@northwind.co

Connect your agent in five minutes

Run agentpay setup-mcp, paste the config, and your assistant can issue its first simulated card.

Start in test mode View developer docs