Agent Setup

Give your AI agent a credit card in 5 minutes.

Give your agent this command

Any AI agent that can read a URL can use this.

curl -s https://agents.karmapay.xyz/skill.md

Add to system prompt

For Claude, ChatGPT, or any LLM.

You have access to a Karma credit card. Read the API docs at:
https://agents.karmapay.xyz/skill.md

Your API key is: sk_agent_...
Use it to check balance, verify purchases, and get card details for checkout.

Run the interactive agent

CLI that walks through the entire setup.

$ git clone https://github.com/amrixsol/karma-agent.git
$ cd karma-agent && npm install
$ npx tsx src/agent.ts

Quick API Reference

# 1. Register
curl -X POST https://agents.karmapay.xyz/api/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'
# → { account_id, secret_key: "sk_live_..." }

# 2. Complete KYC (one-time)
curl -X POST https://agents.karmapay.xyz/api/kyc \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"firstName":"...", ...}'
# → { status, kyc_url } — open kyc_url in browser

# 3. Create a card
curl -X POST https://agents.karmapay.xyz/api/cards \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"My Agent","per_txn_limit":100}'
# → { card_id, agent_api_key: "sk_agent_...", deposit_address }

# 4. Fund it — send USDC to the deposit_address

# 5. Agent endpoints (use sk_agent_... key):
#    GET  /api/spend/balance
#    GET  /api/spend/card        (PAN, CVV, expiry)
#    POST /api/spend/can-spend   {"amount": 49.99}
#    GET  /api/spend/transactions

Full API docs →

Security Model

sk_agent_

Scoped to one card. Can check balance, verify spend, get card details, view history. Cannot withdraw, freeze, or change limits.

sk_live_

Owner key. Full access: create cards, set limits, freeze/unfreeze, withdraw USDC, rotate agent keys.