Developers

La API de finanzas personales pensada para agentes.

Finzaria es dev-first y agent-first: una API REST /v1 documentada en español y un servidor MCP para conectar Claude, ChatGPT o el agente que tú construyas. La misma API que usa la app — sin endpoints privados.

¿Finzaria tiene API pública?

Sí. La API REST /v1 vive en api.finzaria.com/v1 con autenticación Bearer (API key bxm_ u OAuth), y el servidor MCP en mcp.finzaria.com/mcp (Streamable HTTP, sin instalación local) para Claude, ChatGPT o cualquier host compatible con MCP. Es la misma API que usa la app: lo que un agente registra se refleja al instante.

Quickstart

Tu primera llamada en minutos

Genera tu API key desde la app (menú de tu perfil → Developers), guárdala como variable de entorno y pide tu workspace.

  • API keys bxm_ con scope read_only o read_write.
  • Revocables al instante desde tu cuenta.
  • OAuth para la conexión de un click desde clientes gestionados.

El paso a paso completo está en el quickstart de la documentación.

# Tu primera llamada: pide tu workspace
curl https://api.finzaria.com/v1/workspace \
  -H "Authorization: Bearer $FINZARIA_API_KEY"

# Registra un gasto
curl https://api.finzaria.com/v1/transactions \
  -H "Authorization: Bearer $FINZARIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "expense",
    "amount": "150.50",
    "date": "2026-07-24",
    "description": "Café",
    "accountId": "ACCOUNT_ID"
  }'
Superficies

REST para tu código, MCP para tus agentes.

⚙️

API REST /v1

Cuentas, transacciones, categorías, presupuestos, reglas y reportes. Referencia completa →

🔌

Servidor MCP

mcp.finzaria.com/mcp por Streamable HTTP: conecta Claude o ChatGPT sin instalar nada. Conectar tu agente →

🔑

Auth sin sorpresas

Bearer con API key bxm_ (scopes read_only / read_write) u OAuth. Guía de autenticación →

Filosofía

Sin caminos privilegiados

La app de Finzaria consume exactamente la misma API /v1 que tú. El MCP es un adaptador delgado sobre esa API — cero lógica propia — así que cualquier cosa que un agente haga queda reflejada al instante en la app, y viceversa.

Eso significa que puedes automatizar tus finanzas por completo: un script que importa movimientos, un agente que registra gastos cuando le mandas la foto del ticket, o un reporte que se arma solo cada semana.

¿No programas y solo quieres manejar tu dinero platicando? Esa parte está explicada sin tecnicismos en finanzas con IA.

Conecta tu agente hoy

Crea tu cuenta gratis, genera tu API key y haz tu primera llamada en menos de 5 minutos.

Preguntas rápidas

¿Necesito un plan de pago para usar la API?

No para empezar: creas tu cuenta gratis y generas tu API key desde la app (menú de tu perfil → Developers). El servidor MCP no está detrás de un plan de pago. Los planes están en la página de precios.

¿Cómo me autentico?

Con Bearer token: una API key bxm_ con scope read_only o read_write, revocable al instante, o con OAuth para la conexión de un click desde clientes gestionados como Claude o ChatGPT.

¿Qué puede hacer un agente conectado por MCP?

Lo mismo que la API /v1: registrar gastos e ingresos, consultar cuentas y saldos, pedir reportes de gasto y administrar reglas o recurrentes. El MCP es un adaptador delgado sobre la misma API, así que todo se refleja al instante en la app.

¿Dónde está la documentación?

En docs.finzaria.com: quickstart en menos de 5 minutos, referencia completa de la API /v1, guías de autenticación (API keys, OAuth, scopes) y cómo conectar tu agente por MCP.

Construye sobre tus propias finanzas

Crea tu cuenta gratis. Sin tarjeta.