AgenticBooks
Libros que se construyen a sí mismos.
Documentación
Servidor MCP de AgenticBooks
Infraestructura de datos financieros para agentes de IA. Conecta a Claude (o cualquier cliente MCP) directamente con los libros de una startup — lee P&L en vivo y saldos bancarios, revisa y reclasifica transacciones, gestiona el catálogo de cuentas y conecta fuentes bancarias — a través de un servidor MCP remoto seguro y autenticado con OAuth.
Este es un servidor MCP alojado (remoto). No lo instalas ni lo auto-alojas — conectas tu cliente MCP al endpoint de AgenticBooks y te autenticas con tu cuenta de AgenticBooks. Este repositorio es el listado público y la guía de conexión; el servidor en sí se ejecuta como infraestructura gestionada.
- Sitio web: https://www.agenticbooks.ai
- Endpoint MCP:
https://mcp.agenticbooks.ai/mcp - Transporte: HTTP transmisible (Streamable HTTP)
- Autenticación: OAuth 2.0 (flujo de "Conector personalizado" de Claude vía Clerk) o una
clave API de
ab_
Qué hace
AgenticBooks ingiere webhooks de Stripe, Mercury, RevenueCat y otras fuentes, normaliza y clasifica los eventos en contabilidad de partida doble, y sincroniza con QuickBooks/Xero. Este servidor MCP expone ese libro mayor a un agente de IA para que el agente pueda responder preguntas financieras y realizar acciones contables en nombre del usuario — cada escritura queda registrada en una pista de auditoría y se limita a la organización del llamante.
Prompts típicos una vez conectado:
- "¿Cuál es nuestro P&L del mes pasado?"
- "¿Cuánto efectivo tenemos en todas las cuentas bancarias ahora mismo?"
- "Muéstrame las transacciones que aún necesitan revisión, agrupadas por proveedor."
- "Reclasifica los cargos de Vercel como Alojamiento, y recuérdalo para la próxima vez."
Conectar
Claude (Escritorio / Web) — Conector personalizado (OAuth)
- Abre Configuración → Conectores → Añadir conector personalizado.
- Introduce la URL del servidor MCP:
https://mcp.agenticbooks.ai/mcp - Completa el inicio de sesión OAuth cuando se te solicite. Te autenticarás con tu cuenta de AgenticBooks; el acceso se limita a tu organización.
Consulta la guía de Anthropic sobre conectores personalizados remotos: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp
Cursor — instalar como plugin
Este repositorio es un Plugin de agente: plugin.json
lleva la identidad y mcp.json el servidor remoto. Instálalo desde el
Directorio de Cursor o apunta Cursor a este
repositorio; Cursor ejecuta el inicio de sesión OAuth en el primer uso.
Clave API (cualquier cliente MCP sobre HTTP)
Si tu cliente no admite el flujo de conector OAuth, autentícate con una
clave API de ab_ (créala en el panel de AgenticBooks) como token de portador:
{
"mcpServers": {
"agenticbooks": {
"transport": "http",
"url": "https://mcp.agenticbooks.ai/mcp",
"headers": {
"Authorization": "Bearer ab_your_api_key_here"
}
}
}
}
Los dos modos de autenticación son independientes — OAuth y las claves de ab_ funcionan; solo
necesitas uno.
Herramientas
Todas las herramientas operan dentro de la organización autenticada. Las lecturas son no destructivas; las escrituras se registran en una pista de auditoría de solo añadido.
Informes y saldos
| Herramienta | Qué hace |
|---|---|
get_financial_summary | Instantánea de una llamada: P&L del mes actual, saldos en todos los proveedores conectados, recuento de eventos sin revisar y estado de sincronización del libro mayor. |
get_pnl_report | Informe de pérdidas y ganancias en un rango de fechas, elaborado a partir de eventos clasificados. |
get_account_balance | Saldos actuales en los proveedores de dinero conectados de la organización. |
get_bank_balances | Tenencias bancarias, una línea por banco conectado (Mercury, etc.). |
get_audit_log | Lee la pista de auditoría de solo añadido, de la más reciente a la más antigua. |
get_books_status | Todo lo que un agente necesita primero: qué está conectado, cada cola abierta y el ÚNICO siguiente paso. |
get_transaction | Detalle completo de una transacción: asiento, contraparte, evidencia adjunta, historial de auditoría. |
get_billing_status | El estado de suscripción de AgenticBooks de la organización (prueba, activo, gracia, bloqueado). |
Revisión y clasificación
| Herramienta | Qué hace |
|---|---|
get_unreviewed_events | Lista los eventos clasificados que el motor de reglas no pudo categorizar con confianza. |
get_pending_by_counterparty | Resume la cola de revisión agrupada por contraparte y dirección. |
approve_classification | Aprueba un evento de la cola de revisión asignando su cuenta. |
reclassify_entry | Cambia la cuenta en un asiento del libro mayor ya publicado (con pista de auditoría). |
list_suggested_transfers | Pares de transferencia banco a banco que el emparejador propuso pero no pudo asentar con certeza. |
confirm_transfer | Asienta un par de transferencia sugerido como transferencia interna (sin efecto en P&L). |
reject_transfer | Rechaza un par sugerido para que ambas patas vuelvan a la clasificación ordinaria. |
Reglas de contraparte (el mapa de proveedores aprendido)
| Herramienta | Qué hace |
|---|---|
create_counterparty_rule | Crea/actualiza una regla persistente que asigna una contraparte a una cuenta. |
list_counterparty_rules | Lista las reglas aprendidas de contraparte → cuenta de la organización. |
update_counterparty_rule | Reapunta una regla existente a una cuenta diferente (afecta a eventos futuros). |
delete_counterparty_rule | Elimina una regla; los eventos futuros de esa contraparte dejan de auto-clasificarse. |
Catálogo de cuentas
| Herramienta | Qué hace |
|---|---|
list_chart_accounts | Lista el catálogo de cuentas de la organización (código, nombre, tipo, activa). |
add_chart_account | Añade una nueva cuenta; el sistema asigna automáticamente el código. |
rename_chart_account | Renombra una cuenta (el código nunca cambia). |
set_chart_account_active | Desactiva o reactiva una cuenta del catálogo. |
Documentos (recibos y facturas)
| Herramienta | Qué hace |
|---|---|
list_documents | Recibos y facturas almacenados con su estado de canalización; muestra propuestas de emparejamiento abiertas. |
attach_document | Adjunta un documento almacenado a una transacción como su evidencia (nunca asienta nada). |
Periodos e integraciones
| Herramienta | Qué hace |
|---|---|
close_period | Ejecuta el cierre de fin de mes, incluida la revalorización de FX no realizado. |
reimport_historical | Pone en cola una importación histórica en una ventana elegida. |
connect_mercury | Conecta la organización a Mercury mediante un token API de solo lectura y ámbito limitado. |
disconnect_mercury | Desactiva la integración de Mercury de la organización (con pista de auditoría). |
connect_meow | Conecta la organización a Meow mediante una clave API de solo lectura. |
disconnect_meow | Desactiva la integración de Meow de la organización (con pista de auditoría). |
get_onboarding_status | Recorrido solo de conexión (sustituido por get_books_status). |
Seguridad
- Cada llamada a herramienta está autenticada (token de acceso OAuth o clave API de
ab_) y limitada a una sola organización. - Todas las escrituras se registran en una pista de auditoría de solo añadido.
- Las credenciales bancarias se almacenan por organización y se cifran en reposo; nunca se aceptan ni se exponen como argumentos de herramientas MCP.
Enlaces
- Sitio web — https://www.agenticbooks.ai
- Soporte — https://www.agenticbooks.ai (contacto a través del panel)
AgenticBooks es un servicio alojado. Este repositorio documenta cómo conectarse; no es el código fuente del servidor.