Command line

Issue a card in one line

The agentpay CLI covers the whole platform — organizations, agents, cards, balances, credentials, webhooks, and MCP setup — so you can script it or run it in CI.

Create an account CLI reference

terminal

$ npm i -g agentpay
$ agentpay login
✔ Signed in as maya@northwind.co (test mode)

$ agentpay cards create --amount 50 --merchant DoorDash
CARD ID    STATUS   TYPE         LIMIT    LAST4
card_9fJ2  active   single_use   $50.00   4821

$ agentpay balance --agent agt_ops
budget      $500.00/mo
spent       $137.11
remaining   $362.89

Commands

The full surface

Authentication

agentpay signup
agentpay login
agentpay logout
agentpay whoami

Organizations

agentpay organizations create
agentpay organizations list
agentpay organizations select

Agents

agentpay agents create
agentpay agents list
agentpay agents details AGENT_ID
agentpay agents pause AGENT_ID
agentpay agents activate AGENT_ID

Cards

agentpay cards create --amount 25
agentpay cards create --amount 25 --multi-use
agentpay cards create --amount 50 --merchant DoorDash
agentpay cards list
agentpay cards details CARD_ID
agentpay cards freeze CARD_ID
agentpay cards cancel CARD_ID

Balances

agentpay balance
agentpay balance --agent AGENT_ID
agentpay balance --card CARD_ID

Developer

agentpay credentials create
agentpay credentials revoke KEY_ID
agentpay webhooks create
agentpay setup-mcp

Setup wizard

npx agentpay setup

One guided flow: sign in, create an organization, choose an environment, issue credentials, install the SDK, generate an example integration, create a test card, and configure a webhook.

terminal

$ npx agentpay setup

✔ Account          maya@northwind.co
✔ Organization     Northwind (org_2k1x)
✔ Environment      test
✔ Credentials      sk_test_••••4f2a  (shown once)
✔ SDK              @agentpay/sdk installed
✔ Example          examples/issue-card.ts written
✔ Test card        card_9fJ2 · $25.00 · active
✔ Webhook          https://northwind.co/api/agentpay  (verified)

Integration status: ready

Install the CLI and issue your first card

Test mode credentials are free and don't require a funding source.

Start in test mode View developer docs