Zentavo MCP
magiobus/zentavomcp
Gerencie suas finanças Zentavo via chat com Claude, ChatGPT ou Cursor
Ver no GitHubServidor MCP que integra sua conta Zentavo com Claude, ChatGPT e Cursor, permitindo gerenciar finanças em linguagem natural. Funciona como uma camada de ferramentas sobre a API pública do Zentavo, com suporte a múltiplos planos e controle granular de permissões (read/write).
Instalação
npx convez-ai magiobus/zentavomcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Consultar saldo de contas e transações em linguagem natural
- Registrar despesas e receitas sem sair do chat
- Analisar gastos por categoria e período
- Gerenciar múltiplos planos financeiros com uma única conexão
Veredito

Integração sólida e bem arquitetada para quem usa Zentavo. O suporte a múltiplos planos via JSON e a distinção clara entre permissões read/write reduzem riscos. Implementação eficiente que delega o custo de tokens ao usuário final.
README
A tradução para o português deste README ainda está na fila.
Zentavo MCP
Servidor MCP para manejar tus finanzas de Zentavo desde Claude, ChatGPT, Cursor o cualquier cliente compatible — en lenguaje natural.
No corre ningún modelo: es una capa de herramientas sobre la API pública de Zentavo (/api/v1). El LLM lo pone tu cliente (Claude/ChatGPT), así que los tokens los pagas tú en tu cuenta, no Zentavo.
Requisitos
- Una cuenta de Zentavo con acceso activo.
- Una o más API keys: en la app → Configuración → API → crear key (
ready/owrite). Cópiala (solo se muestra una vez). Cada key queda atada a un plan. - Node.js ≥ 18.
Configurar en tu cliente
Un solo plan
La key va en ZENTAVO_API_KEY:
{
"mcpServers": {
"zentavo": {
"command": "npx",
"args": ["-y", "github:magiobus/zentavomcp"],
"env": { "ZENTAVO_API_KEY": "zsk_live_..." }
}
}
}
Varios planes
Genera una key por plan y pásalas en ZENTAVO_PLANS (JSON con name + key). Una sola conexión cubre todos:
{
"mcpServers": {
"zentavo": {
"command": "npx",
"args": ["-y", "github:magiobus/zentavomcp"],
"env": {
"ZENTAVO_PLANS": "[{\"name\":\"personal\",\"key\":\"zsk_live_AAA\"},{\"name\":\"negocio\",\"key\":\"zsk_live_BBB\"},{\"name\":\"casa\",\"key\":\"zsk_live_CCC\"}]"
}
}
}
}
Con varios planes, cada herramienta acepta un parámetro plan (el name) que decide a cuál mandar. Usa list_plans para ver los nombres disponibles. El modelo puede inferirlo del contexto ("en mi plan de negocio, registra…").
Opcional: ZENTAVO_BASE_URL (default https://zentavo.lat/api/v1).
Desarrollo local (sin npm)
{
"mcpServers": {
"zentavo": {
"command": "node",
"args": ["/ruta/absoluta/a/zentavomcp/index.js"],
"env": { "ZENTAVO_API_KEY": "zsk_live_..." }
}
}
}
Reinicia el cliente y ya puedes pedirle cosas como "¿cuánto gasté este mes?" o "registra un gasto de 120 en Oxxo".
Herramientas
- Planes:
list_plans(ver los planes configurados). - Lectura (key con scope
read):list_accounts,list_transactions,get_transaction,list_categories,list_budgets,get_summary. - Escritura (key con scope
write):create_transaction,update_transaction,delete_transaction,create_category,assign_budget.
Los montos van en la moneda de la cuenta como decimal (ej. 45.50); el server los convierte a milliunits para la API.
Notas
- Si una key pierde acceso (suscripción vencida o te sacan del plan), sus herramientas devuelven error — las demás siguen.
- Una key
readque intente escribir recibe 403. - Docs de la API:
https://zentavo.lat/docs.