Herramientas disponibles

El servidor expone seis herramientas de solo lectura. No tienes que llamarlas tú: Claude elige cuál usar según tu pregunta. Conocerlas te ayuda a preguntar mejor.

Resumen

Herramienta	Para qué sirve	Pregunta típica
get_linked_companies	Lista las empresas (RFC y nombre) a las que tienes acceso. Es siempre la primera llamada.	«¿Qué empresas tengo vinculadas?»
get_invoice_aggregates	Totales de facturación (suma, subtotal, conteos, cancelados) con filtros y series por mes, trimestre o año.	«¿Cuánto facturé por mes en 2025?»
get_invoices	Facturas individuales con filtros y paginación.	«Dame las facturas de más de $100,000 de agosto.»
get_partners	Directorio de clientes y proveedores, con estatus en listas 69-B y facturación acumulada. Sirve para resolver un nombre a su RFC.	«¿Qué proveedores míos están en la lista 69-B?»
get_partner_billing_summary	Resumen de operaciones con un cliente o proveedor específico.	«¿Cuánto le he comprado a Aceros del Norte este año?»
get_top_partners	Top N de clientes o proveedores por monto, con participación porcentual.	«¿Quiénes son mis 10 principales clientes?»

Filtros que entienden

Todas las herramientas de facturas aceptan estos filtros; menciónalos en tu pregunta y Claude los aplicará:

• Dirección: emitidas (ventas, ingresos) o recibidas (compras, gastos).
• Tipo de comprobante: ingreso (I), egreso o nota de crédito (E), complemento de pago (P), nómina (N), traslado (T).
• Estado ante el SAT: vigentes, canceladas o todas.
• Periodo: fechas en formato ISO (2025-01-01), o expresiones como «este año» o «agosto» que Claude convierte por ti.
• Contraparte: por RFC o por nombre (Claude lo resuelve con get_partners).
• Método de pago (PUE o PPD), forma de pago (clave del SAT), uso de CFDI, moneda, monto mínimo y máximo, y para facturas individuales el UUID exacto.

Consejos para preguntar

• Pide totales antes que listas. «¿Cuánto…?» usa agregados y es más rápido y preciso que pedir todas las facturas.
• Nombra la empresa si tienes varias: «de Promovago» o «del RFC PLA930322167».
• Sé explícito con el periodo. «En 2025» es mejor que «últimamente».
• Para listas largas, pide páginas. get_invoices devuelve 50 facturas por página; Claude puede pedir la siguiente si se lo indicas.

Lo que no hace

• No descarga CFDI nuevos ni sincroniza con el SAT.
• No modifica facturas, contactos ni configuraciones.
• No ve empresas que no estén vinculadas a tu usuario.