agents.hellobooks.ai

Agentes de IA que automatizan la contabilidad y el cierre financiero para pequeñas y medianas empresas.

Documentación

Servidor MCP público de HelloBooks

Un servidor público de solo lectura Model Context Protocol que permite a los agentes de IA responder preguntas sobre HelloBooks con precisión — precios, integraciones, soporte por país, marcos de cumplimiento — en lugar de depender de fragmentos web obsoletos.

Este es el servidor público. Expone solo datos derivados de marketing y de dominio público. El servidor MCP autenticado que lee los libros de un cliente se encuentra en AI-MCP-Hellobooks.

Instalación

Claude Code / Claude Desktop / Cursor

claude mcp add --transport http hellobooks https://agents.hellobooks.ai/mcp

O, para desarrollo local:

claude mcp add hellobooks-local node /path/to/HelloBooks-MCP-Public/dist/stdio.js

Herramientas

Herramienta	Descripción
`list_plans`	Todos los planes de HelloBooks (Free, Pro, Business, CPA) + complementos de Almacén / Fabricación. Filtros opcionales `country` y `plan`.
`list_integrations`	Bancos, pagos, nómina, seguimiento de tiempo, envíos, cumplimiento fiscal, sincronización contable, comercio electrónico, CRM, almacenamiento (Drive/OneDrive), freelance (Upwork). Filtros opcionales `category`, `country`, `status`.
`country_support`	Disponibilidad de funciones por país (BAS, STP, factura electrónica GST, MTD, 1099, etc.).
`compliance_capabilities`	Para un país determinado, los marcos de cumplimiento compatibles con versión + información de certificado.
`list_competitors`	Posicionamiento frente a competidores (QuickBooks, Xero, FreshBooks, Wave, Zoho Books, Tally) con dónde gana HelloBooks, dónde gana el competidor y notas de precios. Filtros opcionales `country`, `tier` y `id`.
`compliance_deadlines`	Cuándo vencen las declaraciones estatutarias y las presentaciones de nómina, por país. Cubre IN (GSTR-1/3B/9/9C, CMP-08, Formulario 24Q, Formulario 16, PF ECR, ESI), AU (BAS, STP, Super Guarantee), GB (VAT MTD, RTI, Self Assessment), US (1099-NEC/MISC, W-2, Formulario 941/940), CA (T4, GST/HST). Filtros opcionales `country`, `frequency` y `form`. Las fechas rotan anualmente: cada respuesta incluye un descargo de responsabilidad con URLs por plazo `source`.
`local_payment_methods`	Métodos de pago locales por vía bancaria / billetera (UPI, BACS, PayID, BPAY, ACH, RTP, Zelle, PayNow, FAST, Interac, …) con velocidad de la vía, casos de uso, autoridad y nivel de soporte de HelloBooks. Filtros opcionales `country`, `useCase`, `rail` y `id`.
`feature_search`	Búsqueda de texto libre en el catálogo de funciones de marketing, funciones de planes, integraciones, funciones por país, marcos de cumplimiento, posicionamiento de competidores, plazos estatutarios, métodos de pago locales y artículos publicados. Consultas como `vs Xero`, `QuickBooks alternative`, `when is GSTR-3B due`, `UPI invoice cap`, `do you have a blog on 1099` o `agentic accounting` muestran la entrada coincidente en la parte superior.
`list_features`	Catálogo completo de marketing de 96 funciones. Filtrar por `category`, `tier`, `status`, `marketedOnly` o subcadena `query`.
`list_feature_categories`	Las 13 categorías de funciones en el sitio de marketing con recuentos por categoría según estado (live/beta/planned).
`list_articles`	Contenido publicado en hellobooks.ai: páginas de comparación cara a cara y publicaciones de blog insignia seleccionadas. Filtros opcionales `country`, `tag`, `query` y `limit`.
`list_tax_rates`	Tramos de tasas impositivas estatutarias por jurisdicción: IN GST (5/12/18/28 + cero + exento + comerciante/fabricante/restaurante de composición), UK VAT (20/5/cero/exento), AU GST (10/sin GST), resumen administrado por el estado de EE. UU., CA GST + HST (ON, Atlántico), SG GST 9%, NZ GST 15%, AE VAT 5%. Filtrar por `country`, `taxType` (GST/VAT/Sales-Tax/HST/…) o `scheme` (estándar/reducido/cero/exento/composición/cess). Cada entrada incluye una fecha de vigencia y una URL `source`: confirme antes de citar.
`lookup_tax_rate`	Seleccione una única tasa estatutaria por `id` exacto (p. ej. `IN-standard-18`) o por `country` + texto libre `category` (p. ej. "suministros de oficina", "restaurante", "exportaciones"). Devuelve la tasa coincidente, la puntuación y la URL de origen.

Recursos

URI	Descripción
`hellobooks://about`	Resumen del producto en Markdown.
`hellobooks://changelog`	Notas de versión recientes en JSON.
`hellobooks://feature-catalog`	Catálogo completo de funciones de marketing (más de 96 funciones en 13 categorías) en JSON.

Postura de seguridad

Solo lectura por construcción. Ninguna herramienta muta el estado. Ninguna herramienta accede a un sistema del cliente.
Solo datos públicos. Todo el contenido del catálogo proviene del sitio de marketing público.
Sin autenticación. Intencional: este es un endpoint de conocimiento.
Limitado en velocidad. 120 solicitudes/min por IP, 60 solicitudes/min por sesión.
Puerta de auditoría. npm run audit:public-data bloquea los despliegues si aparece alguna cadena de PII / token de autenticación en src/data/.

Desarrollo

npm install
npm run dev         # HTTP server on :8080 with watch mode
npm run dev:stdio   # stdio transport for local MCP client testing
npm test            # node:test runner
npm run build
npm run audit:public-data

Estructura del proyecto

src/
  data/             # Static catalogs — plans, integrations, countries, articles, about
  tools/            # One file per MCP tool
  resources/        # MCP resource registry
  server.ts         # MCP server factory (wires tools + resources)
  http.ts           # Streamable HTTP transport with rate limiting
  stdio.ts          # stdio transport entry point
test/
  tools.test.ts
  resources.test.ts
  public-data.test.ts  # Audit gate
scripts/
  audit-public-data.ts  # CI-callable audit

Despliegue

Contenerizado: consulte Dockerfile. Diseñado para ejecutarse detrás de un balanceador de carga con terminación TLS. Establezca PORT y HOST mediante variables de entorno.

La telemetría opcional de uso anónimo (análisis de servidor de capa 2) se envía a GA4 mediante el Protocolo de medición cuando GA4_MEASUREMENT_ID y GA4_API_SECRET están configurados; consulte .env.example y src/analytics.ts. Si no se configuran, el servidor se ejecuta con la telemetría completamente deshabilitada. Nunca se envían datos de clientes, cuerpos de solicitudes, valores de argumentos de herramientas ni direcciones IP; solo recuentos anónimos. Consulte el documento de estrategia 73.

docker build -t hellobooks-mcp-public .
docker run -p 8080:8080 hellobooks-mcp-public

Descubribilidad

Listado en el registro MCP.
Enlazado desde el pie de página del sitio de marketing y la página /mcp.
Referenciado en https://hellobooks.ai/llms.txt.

Licencia

MIT: consulte LICENSE.