Conectá tu agente a Cardia: CLI, MCP y API

Cardia le da a un agente una tarjeta con límites de verdad: scope de comercio, monto y vigencia. Pero una tarjeta no sirve de nada si conectarla es un dolor de cabeza. Por eso hay tres caminos para integrarla, según quién sea el que la usa: una persona en la terminal, un agente que habla por MCP, o tu propio backend. Esta nota explica los tres, sin vender humo: lo que ya está y lo que viene.

1. La CLI: para vos, en la terminal

Si trabajás en la terminal —y si estás leyendo esto, probablemente sí— la CLI es el camino más rápido.

npm install -g cardia

Con eso tenés el comando cardia disponible. La idea es que crear y manejar tarjetas sea tan directo como cualquier otra herramienta de dev: te autenticás una vez y desde ahí emitís tarjetas, les ponés límites y mirás el gasto sin salir de la consola.

El subcomando que más vas a usar si manejás un equipo es:

cardia teams

Pensado para el caso "soy el que administra": crear tarjetas por persona o por agente, asignar límites y ver quién gastó qué. Es la misma lógica del panel web, pero scriptable —ideal para meterlo en un onboarding automatizado o en un cron.

Por qué una CLI y no solo un dashboard: porque los agentes y los devs viven en la terminal. Una tarjeta que se crea con un comando se puede automatizar; una que requiere clicks en una web, no. Esta es, honestamente, una de las cosas que más nos diferencia de las soluciones que son solo un panel.

2. MCP: para que el agente se maneje solo

MCP (Model Context Protocol) es el estándar que dejó a los agentes de Claude, Cursor y compañía hablar con herramientas externas. Cardia expone un server MCP en:

cardia.digital/api/mcp

Conectándolo, tu agente obtiene las acciones de Cardia como tools nativas: puede consultar su límite, ver su saldo, revisar sus últimos movimientos y operar dentro del scope que vos le definiste. El punto clave es ese dentro del scope: por más que el agente tenga la tool, no puede pasarse del monto, pagarle a un comercio fuera de la lista ni operar después de la fecha de vigencia. El control no depende de que el agente "se porte bien"; está puesto en la tarjeta.

Es la forma más natural de integrar un agente autónomo: no le pasás credenciales sueltas, le das una herramienta acotada.

3. API REST: para tu backend

Si estás construyendo tu propio producto sobre Cardia —tu app, tu plataforma, tu flota de agentes— la API REST es el camino. Te autenticás con un token y desde ahí tenés acceso programático a todo: emitir tarjetas, definir y cambiar límites, consultar transacciones, manejar el ciclo de vida de cada tarjeta.

Es el mismo motor que usan la CLI y el MCP por debajo, así que no hay funcionalidad de segunda: lo que se puede hacer en cualquier lado, se puede hacer acá. La diferencia es el control total y la posibilidad de integrarlo a tu lógica de negocio.

Cómo elegir

No son excluyentes. Lo común es usar la CLI para administrar, MCP para que los agentes operen y la API para lo que automatices a medida. Las tres pegan contra el mismo backend, así que una tarjeta creada por CLI se ve igual desde la API y la maneja el agente por MCP.

Lo honesto: qué está y qué viene

No vamos a venderte una plataforma terminada que no existe. El motor de tarjetas con control por scope —emisión con Pomelo, soporte de pesos y USDT— es el corazón de Cardia y es lo que estamos puliendo primero. La CLI, el MCP y la API son las tres puertas a ese motor, y van madurando a distinto ritmo: algunas piezas ya están andando y otras están en beta cerrada mientras las endurecemos.

Si querés conectar tu agente o tu equipo hoy, escribinos y entrás al beta. Preferimos que pruebes algo que funciona de verdad antes que prometerte un changelog perfecto.