Las herramientas
Qué puede hacer el agente con cada herramienta del servidor MCP.
El agente trabaja con el negocio de su API key y con ningún otro, así que ninguna herramienta pide elegir negocio; los negocios los registras tú en la plataforma. Ve solo las herramientas que el permiso de su API key le deja usar. Las que empiezan con fiscalbase_ son de tu cuenta y de la plataforma; las que empiezan con ec_ trabajan con los comprobantes del SRI y con tu historial.
| Herramienta | Para qué |
|---|---|
fiscalbase_whoami | El agente empieza aquí: el ambiente, el permiso, el negocio de su API key y si puede emitir, el uso del mes y una guía de trabajo con las llamadas, los formatos y los códigos que necesita para emitir |
fiscalbase_docs | La guía de cada comprobante con todos sus campos, y la búsqueda y lectura de esta documentación, para lo que la guía de trabajo no cubre |
ec_lookup_taxpayer | Un RUC o una cédula convertidos en el comprador del comprobante, con el correo que tu negocio ya usó para esa identificación como sugerencia |
ec_find | Busca en tu historial: comprobantes por tipo, estado, cliente, fechas o texto; clientes por nombre; y lo que vendes, con sus precios e impuestos reales |
ec_preview_document | Valida un comprobante y calcula sus totales sin gastar un número |
ec_issue_document | Emite cualquiera de los seis comprobantes y espera la decisión del SRI |
ec_issue_credit_note_for | Una nota de crédito sobre una factura: solo las líneas devueltas y el motivo |
ec_get_document | Hasta diez comprobantes completos de una vez, con su historial y enlaces a su XML y su RIDE |
ec_document_action | Reenviar el correo, consultar al SRI, corregir y reenviar, renumerar o registrar una anulación |
ec_document_report | El resumen de un periodo: totales por estado y tipo, y los rechazados con su motivo |
ec_catalog | Busca códigos del SRI: tarifas de IVA, ICE, formas de pago, retenciones, sustento tributario, mensajes del SRI con su solución |
ec_issuing_habits | Cómo emite normalmente tu negocio, para cuando le pides «la factura de siempre» |
ec_suggest_withholding | Propone la retención de la factura de un proveedor, a partir de su clave de acceso |
fiscalbase_webhooks | Lista, crea y pausa los webhooks del negocio de la API key y revisa sus entregas. El secreto de firma nunca pasa por el agente |
Con la primera llamada el agente aprende a trabajar con Fiscalbase, como si leyera esta documentación una vez: para una factura con todos los datos le bastan tres llamadas más (buscar al comprador, previsualizar y emitir). Lo que no está en esa guía lo busca aquí con fiscalbase_docs.
El agente también lee recursos: la misma guía de cada comprobante, los catálogos del SRI y los archivos de cada comprobante. Y tu cliente puede ofrecerte dos prompts listos: emitir una factura y revisar los comprobantes rechazados.