Get started

Quickstart

From zero to first virtual card in under 5 minutes. Test mode only; no real charges.

1
Sign up
Go to /signup and enter your email. We send a one-time magic link that signs you in and lands you on the setup wizard.
2
Complete setup
Two steps. Both required before any card can be issued.
1. Verify identity (KYB). Legal name, DOB, address, phone. Used to create a real Stripe Issuing cardholder under your account. Address is used for AVS at merchants.
2. Connect a payment method. Saved via a Stripe SetupIntent for off-session re-use. In test mode, use 4242 4242 4242 4242.
3
Create an API key
Open /api-keys, click Create key, pick Test mode. Copy the full key — it's shown once.
4
Issue your first card
Call POST /v1/cards. Minimum: amount in cents and optionally an agent_id.
```
curl -X POST https://agentpay-mvp.vercel.app/v1/cards \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount_cents": 2000,
    "agent_id": "claude-desktop",
    "purpose": "Cloudflare domain purchase"
  }'
```
You'll get back a card with last_four, expiration, and a spending_limit_cents matching your request. To reveal PAN/CVV, call GET /v1/cards/:id — the response includes a Stripe ephemeral_key_secret you use client-side per Stripe's Issuing docs.
5
Wire up an MCP agent (optional)
Install the MCP server so Claude Desktop, Cursor, or Windsurf can call your AgentPay API as tools.
```
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["-y", "@agentpay/mcp-server"],
      "env": {
        "AGENTPAY_API_KEY": "sk_test_...",
        "AGENTPAY_API_URL": "https://agentpay-mvp.vercel.app/v1"
      }
    }
  }
}
```
Restart your client. Five tools appear: create_card, list_cards, get_card, close_card, check_balance. Ask your agent "create a $10 card for a Cloudflare domain" and watch it call the API.

Sign up

Complete setup

Create an API key

Issue your first card

Wire up an MCP agent (optional)