MCP

Conectá tu agente a Cardia por MCP.

Claude, Cursor o ChatGPT crean y operan tarjetas solos — siempre dentro del scope que vos definís. Hablás en lenguaje natural, Cardia ejecuta y el authorizer decide.

bash

$ claude mcp add --transport http cardia https://cardia.digital/api/mcp --header "Authorization: Bearer <tu-token>"

Una línea en Claude Code y listo: el MCP hosteado ya está en producción. Cada cliente usa SU token en el header Authorization.

claude

> Creá una tarjeta de $25 para mi suscripción de OpenAI

● create_card (amount 25, currency USD)

● grant (merchant OpenAI, max 25, ttl 30d)

✓ Tarjeta lista: •••• 3119 · $25 USD · scope OpenAI

> Pagá la suscripción

● authorize_payment (merchant OpenAI, amount 20)

✓ APPROVED · OpenAI · $20 USD

> Ahora pagá $300 en Steam

● authorize_payment (merchant Steam, amount 300)

✗ REJECTED · sin permiso para Steam ▋

Opción 1 — MCP hosteado (HTTP)

El server MCP vive en https://cardia.digital/api/mcp. No instalás nada: apuntás tu cliente ahí y te autenticás con tu token en el header Authorization: Bearer. El token nunca se guarda en el server — viaja por request.

¿Todavía no tenés cuenta ni token? Creá tu cuenta →

URLhttps://cardia.digital/api/mcp

HeaderAuthorization: Bearer <tu-token>

Para clientes que soportan MCP por HTTP (Cursor, Claude Desktop, etc.), pegá esto en la config:

mcp.json

{
  "mcpServers": {
    "cardia": {
      "type": "http",
      "url": "https://cardia.digital/api/mcp",
      "headers": {
        "Authorization": "Bearer <tu-token>"
      }
    }
  }
}

Opción 2 — Setup local (npx cardia mcp)

Si preferís correr el server MCP en tu máquina (stdio), el CLI lo trae incluido:

Instalá el CLI (o usá npx directo)

$ npm install -g cardia

Conseguí tu token

$ export CARDIA_API_TOKEN=<tu-token>

Agregalo a Claude Code en una línea

$ claude mcp add cardia -- npx cardia mcp

Para otros clientes, agregá esto a la config y reiniciá

claude_desktop_config.json

{
  "mcpServers": {
    "cardia": {
      "command": "npx",
      "args": ["cardia", "mcp"],
      "env": {
        "CARDIA_API_URL": "https://cardia-api.emipanelli.com",
        "CARDIA_API_TOKEN": "<tu-token>"
      }
    }
  }
}

Clientes compatibles

Claude DesktopClaude CodeCursorChatGPTOpenClaw / Hermes

Las 12 tools que expone

El agente opera con un set acotado de herramientas. El authorizer valida cada compra con el comercio y el monto reales — no los que dice el modelo.

list_cards

create_card

check_balance

set_limit

freeze_card

unfreeze_card

grant_permission

list_permissions

authorize_payment

get_transactions

create_purchase_card

reveal_card

Próximamente

OAuth: en camino

El MCP hosteado ya existe y se autentica con tu token (Authorization: Bearer). Lo próximo es OAuth: conectar tu cuenta con un click, sin copiar tokens.

https://cardia.digital/api/mcp

CLI→API→Docs→

¿Listo para darle una tarjeta a tu agente?

Sumate a la lista de espera y probá el authorizer en vivo en la demo.

Sumate →Probar la demo