Partner API

Buy gift cards and eSIMs with a prepaid Spend Credits balance. Same catalog and fulfillment as the SpendCrypto app.

API reference · API keys · Fund Spend Credits

Prepaid checkout

  1. Create an account and an API key on API keys.
  2. Fund Spend Credits from My credits.
  3. Search the catalog, quote a price, then create an order with cryptoSlug=SCC.
  4. Poll the order. When it is delivered, call reveal-codes for vouchers or eSIM install data.

Authentication

Send the key on every request. Either header works:

Authorization: Api-Key YOUR_KEY
X-Api-Key: YOUR_KEY
X-Client: agent

MCP

Agents connect to https://api.spendcrypto.com/mcp. Claude, Grok, and other hosts start OAuth on the first tool call — sign in with your SpendCrypto email code and approve access. Cursor and Claude Code can still send an API key on every request.

{
  "mcpServers": {
    "spendcrypto": {
      "url": "https://api.spendcrypto.com/mcp",
      "headers": {
        "Authorization": "Api-Key YOUR_KEY"
      }
    }
  }
}

Flow: search → quote → confirm with the user → create_order (scc or crypto) → get_order → reveal_codes. Voucher codes are cash; never paste them into group chat or TTS.

Connect by host

Cursor

Add .cursor/mcp.json with the MCP URL and an API key (see the example above). Create keys on API keys.

Claude Code

Install the SpendCrypto plugin from spendcrypto-agents or run:

claude mcp add --transport http spendcrypto https://api.spendcrypto.com/mcp

OAuth runs on the first tool call.

Claude.ai

Settings → Connectors → custom MCP → https://api.spendcrypto.com/mcp. Sign in with email OTP when prompted.

Grok

grok.com/connectors → custom MCP → same URL. OAuth on first use.

Agent skill docs: github.com/LocalCoinSwap/spendcrypto-agents.

Create an order

curl -X POST "$API/api/v1/order-cart/" \
  -H "Authorization: Api-Key YOUR_KEY" \
  -H "Idempotency-Key: order-1" \
  -H "Content-Type: application/json" \
  -d '{
    "cryptoSlug": "SCC",
    "orderItems": [{
      "giftcardSid": "PRODUCT_SID",
      "voucherCurrency": "USD",
      "voucherAmount": 25,
      "quantity": 1
    }]
  }'

Machine-readable OpenAPI: /developers/openapi.json · fallback explorer on the API host /api/v1/docs/