Esta página reúne todas las herramientas que el conector de facturillo ofrece a un asistente de IA: qué lee o qué cambia cada una y quién puede llamarla. Es para quienes conectan Claude o ChatGPT y para quienes revisan directorios de asistentes de IA. La dirección del conector y los pasos para conectarlo están en la guía de conexión. Qué herramientas ve un asistente depende de la cuenta: una cuenta de pago con el Permiso de escritura activado y una conexión para leer y agregar ve las 34.
Cómo leer las clases
Cada herramienta lleva una clase junto a su nombre.
- Lectura: la herramienta solo lee.
- Escritura: agrega o cambia datos.
- Escritura sensible: quita, reemplaza o mueve algo. Los asistentes suelen preguntarte antes de ejecutarla.
Las anotaciones MCP que se muestran en cada herramienta (readOnlyHint y destructiveHint) son lo que el asistente lee para decidir cuándo preguntarte.
Reglas comunes a todas las herramientas
Estado de las respuestas. Cada herramienta devuelve un resultado MCP con structuredContent y una copia en texto JSON. Un rechazo es un resultado con isError: true y un texto bilingüe (español e inglés), nunca un error HTTP, para que el asistente pueda decirte el motivo.
Errores comunes. El servidor envía cada texto en español y en inglés. Aquí se citan en inglés.
- Límite de solicitudes: "Too many requests in a row, wait a moment and retry."
- Servicio de datos no disponible (herramientas de facturas e ingresos): "The data service is temporarily unavailable, retry in a few minutes."
- Rechazo del argumento: un argumento desconocido o inválido se rechaza con el motivo, antes de ejecutar la herramienta.
- Cuota diaria de precios (herramientas de precios): el rechazo nombra el plan y cuándo se reinicia, y en el plan Gratis agrega "A Pro plan raises the daily limit."
- Herramientas que agregan facturas: "This account does not have Write permission turned on.", "This account is read-only (subscription lapsed).", "Daily AI-add limit reached. Try again tomorrow or add it in the app."
Límites de uso.
- Por cuenta y por instancia del servidor: un cubo de fichas de 60 que se recarga a 0.5 fichas por segundo. Las lecturas baratas cuestan 1 ficha, y
spending_summaryyvendors_summarycuestan 5. - Consultas de precios al día, por plan: Gratis 30, Pro 300, Negocio 1,000, Cuestio sin tope diario. Exportaciones al día: Negocio 10, Cuestio 50. Son los valores por defecto y la configuración en vivo puede cambiarlos.
- Facturas agregadas con IA: 50 por cuenta al día.
Cuenta y contextos
whoami · Lectura
- Qué devuelve: el identificador de la cuenta y su plan (gratis o de pago). En el plan gratis, añade una línea sobre lo que incluye.
- Entradas (* obligatoria): ninguna
- Campos de salida:
uid,tier,message - Quién puede llamarla: cualquier cuenta de facturillo conectada
- Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
list_contexts · Lectura
- Qué devuelve: los contextos que la cuenta puede consultar: personal, de negocio, y las cuentas familiares o de negocio vinculadas.
- Entradas (* obligatoria): ninguna
- Campos de salida:
contexts - Quién puede llamarla: plan de pago, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
Precios en línea
price_search · Lectura
- Qué devuelve: los productos que coinciden, cada uno con su número de tiendas, la tienda y el precio más barato y más caro, en páginas con cursor.
- Entradas (* obligatoria):
query*,limit,cursor - Campos de salida:
products,total,relaxed,cursor,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
price_offers · Lectura
- Qué devuelve: todas las ofertas en línea vigentes de un producto, de la más barata a la más cara: tienda, sucursal, precio, precio anterior, página del producto, el día en que se leyó y el día en que cambió, y las marcas de existencias si se piden.
- Entradas (* obligatoria):
product*,includeOutOfStock,stock,include_hidden - Campos de salida:
product,offers,notes,storeCount,offerCount,hidden_count,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
price_history · Lectura
- Qué devuelve: el precio en línea de un producto en cada tienda, como tramos de precio constante o un punto por día. Por defecto los últimos 30 días, como máximo 400 días.
- Entradas (* obligatoria):
product*,stores,from,to,granularity - Campos de salida:
product,from,to,granularity,series,clampedTo,sparseBefore,note,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
price_basket · Lectura
- Qué devuelve: el total de cada tienda sobre los productos que tiene con precio, los productos que le faltan, la tienda más barata y una matriz de precios en páginas.
- Entradas (* obligatoria):
products,basketId,watchList,stores,inStockOnly,limit,cursor - Campos de salida:
scope,stores,cheapestStore,matrix,total,cursor,unmatched,unmatchedCount,unpriced,unpricedCount,notes,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
price_changes · Lectura
- Qué devuelve: bajas, alzas, ofertas nuevas y productos retirados en un ámbito, cada uno con el precio antes y después, el cambio en porcentaje y su día.
- Entradas (* obligatoria):
scope*,from,to,kinds,limit,cursor - Campos de salida:
changes,counts,window,total,cursor,scope,scopeKind,notes,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read, plan Pro o superior - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo por plan, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
price_watch · Escritura sensible
- Qué devuelve: los productos de la lista de seguimiento (acción list), o la lista después de un set, add o remove.
- Entradas (* obligatoria):
action*,items,limit,cursor - Campos de salida:
action,items,total,cursor,count,removed,watchMax,used,unresolved,notes,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:write, planes Negocio y Cuestio - Efectos secundarios: set reemplaza toda la lista, add suma productos, remove los quita, list no cambia nada.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo por plan, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint true
price_index · Lectura
- Qué devuelve: por cada competidor, los productos que coinciden, la razón de precios mediana y media, la proporción de más baratos, más caros e iguales, y las diez mayores diferencias en cada sentido.
- Entradas (* obligatoria):
reference*,competitors,scope,inStockOnly - Campos de salida:
reference,competitors,inStockOnly,scope,scopeKind,notes,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read, plan Cuestio - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo por plan, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
price_promotions · Lectura
- Qué devuelve: las promociones vigentes de los supermercados en línea, cada una con su profundidad en porcentaje, su día de inicio y su tienda.
- Entradas (* obligatoria):
stores,scope,from,to,rule,includeEnded,limit,cursor - Campos de salida:
promotions,counts,byStore,suspectPromotions,window,rule,includeEnded,total,cursor,scope,scopeKind,notes,quota,asOf,sources,partial - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read, plan Cuestio - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo por plan, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
price_availability · Lectura
- Qué devuelve: por producto y tienda, si está publicado, su marca de existencias en línea, su precio y su día, más un resumen por tienda.
- Entradas (* obligatoria):
brand,basketId,watchList,products,stores,limit,cursor - Campos de salida:
products,summary,total,cursor,scope,notes,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read, plan Cuestio, y Negocio para su propia lista de seguimiento o sus canastas - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo por plan, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
price_export · Escritura
- Qué devuelve: un enlace de descarga privado a un archivo CSV de un reporte de precios, válido 15 minutos, en partes cuando pasa de 200,000 filas.
- Entradas (* obligatoria):
report*,args,format,part - Campos de salida:
report,part,parts,rows,bytes,url,expiresAt,exportBudget,quota,asOf,sources,partial - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:write, planes con presupuesto de exportación (por defecto Negocio y Cuestio) - Efectos secundarios: escribe un archivo CSV en el servidor de facturillo detrás de un enlace privado que caduca a los 15 minutos, borra el archivo después de un día y cuenta contra el presupuesto de exportación del plan.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo por plan, presupuesto de exportación, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint false
price_stores · Lectura
- Qué devuelve: las tiendas en línea cubiertas, con sus banners, sucursales, número de ofertas y de productos, categorías principales y si cada una publica existencias.
- Entradas (* obligatoria): ninguna
- Campos de salida:
stores,total,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
Canastas
basket_list · Lectura
- Qué devuelve: las canastas de la cuenta (nombre, ícono, color, número de líneas, última actualización y mejor compra), o una canasta con sus productos.
- Entradas (* obligatoria):
basketId,limit,cursor - Campos de salida:
baskets,total,cursor,basket,lines,caps,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
basket_create · Escritura
- Qué devuelve: la canasta nueva, el resultado de cada producto (added, duplicate, capReached, notFound) y los límites del plan.
- Entradas (* obligatoria):
name*,icon,color,products - Campos de salida:
basketId,name,lines,linesAdded,notes,caps,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:write - Efectos secundarios: crea una canasta en la cuenta, que se ve en la app de facturillo de inmediato.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, límites de canastas, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint false
basket_add_products · Escritura
- Qué devuelve: el resultado de cada producto (added, duplicate, capReached, notFound o error) y la canasta después del cambio.
- Entradas (* obligatoria):
basketId*,products* - Campos de salida:
basketId,results,lineCount,linesMax,notes,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:write - Efectos secundarios: agrega líneas de producto a una canasta, que se ven en la app.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, límites de canastas, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint false
basket_remove_product · Escritura sensible
- Qué devuelve: el número de líneas de la canasta después del cambio.
- Entradas (* obligatoria):
basketId*,product* - Campos de salida:
basketId,removed,lineCount,notes,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:write - Efectos secundarios: quita una línea de producto de una canasta.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, límites de canastas, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint true
basket_delete · Escritura sensible
- Qué devuelve: los límites del plan después del cambio.
- Entradas (* obligatoria):
basketId* - Campos de salida:
basketId,deleted,caps,quota,asOf,sources - Quién puede llamarla: una cuenta con acceso a precios, alcance
receipts:write - Efectos secundarios: borra una canasta de la cuenta y de la app.
- Errores: límite de solicitudes, cuota diaria de precios alcanzada, límites de canastas, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint true
Facturas y gastos
receipts_search · Lectura
- Qué devuelve: las facturas que coinciden, 20 por página por defecto y 50 como máximo, cada una con una marca de archivo adjunto.
- Entradas (* obligatoria):
context,date_from,date_to,vendor_query,text_query,vendor_category,product_category,min_total,max_total,has_attachment,cursor,page_size,response_format - Campos de salida:
receipts,nextCursor,notice,processingCount - Quién puede llamarla: plan de pago, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
receipts_get · Lectura
- Qué devuelve: una factura: encabezado, totales, formas de pago, si tiene archivo adjunto y las líneas de producto consolidadas.
- Entradas (* obligatoria):
context,receipt_id*,include_items - Campos de salida:
receipt - Quién puede llamarla: plan de pago, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
spending_summary · Lectura
- Qué devuelve: totales, conteos o promedios agrupados por comercio, categoría, mes, semana, día o forma de pago.
- Entradas (* obligatoria):
context,metric,group_by,date_from,date_to - Campos de salida:
metric,group_by,rows,notice,processingCount - Quién puede llamarla: plan de pago, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
products_search · Lectura
- Qué devuelve: las líneas de producto compradas, con precio, comercio, fecha e identificador de la factura, en páginas.
- Entradas (* obligatoria):
context,query,vendor_query,date_from,date_to,cursor,page_size - Campos de salida:
products,nextCursor,notice - Quién puede llamarla: plan de pago, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
vendors_summary · Lectura
- Qué devuelve: por comercio, el número de facturas, el total gastado, el ticket promedio y la primera y la última visita, los 60 con mayor total.
- Entradas (* obligatoria):
context,vendor_query,date_from,date_to - Campos de salida:
vendors,notice - Quién puede llamarla: plan de pago, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
receipt_attachments · Lectura
- Qué devuelve: los documentos de la factura como enlaces de descarga válidos 15 minutos, y los archivos en línea si se piden.
- Entradas (* obligatoria):
context,receipt_id*,include_content - Campos de salida:
receiptId,attachments,notice,dgiPdfUnavailable - Quién puede llamarla: plan de pago, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
Ingresos
income_search · Lectura
- Qué devuelve: las facturas emitidas del negocio y los ingresos manuales, en páginas.
- Entradas (* obligatoria):
context,q,from,to,category,client,doc_type,min_total,max_total,cursor,limit - Campos de salida:
incomes,nextCursor,notice - Quién puede llamarla: plan de pago, alcance
receipts:read, contexto principal de una cuenta de negocio con acceso de propietario o superadministrador - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
income_get · Lectura
- Qué devuelve: un documento de ingreso con las líneas de producto que vendió.
- Entradas (* obligatoria):
context,id*,include_items - Campos de salida:
income - Quién puede llamarla: plan de pago, alcance
receipts:read, contexto principal de una cuenta de negocio con acceso de propietario o superadministrador - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
income_summary · Lectura
- Qué devuelve: las ventas del negocio como total, conteo, impuesto o ticket promedio, agrupadas como se pida.
- Entradas (* obligatoria):
context,from*,to*,metric,group_by - Campos de salida:
metric,group_by,rows,notice - Quién puede llamarla: plan de pago, alcance
receipts:read, contexto principal de una cuenta de negocio con acceso de propietario o superadministrador - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
income_products_search · Lectura
- Qué devuelve: los productos que vendió el negocio, con número de líneas y de documentos, cantidad, ingreso neto y último precio, en páginas.
- Entradas (* obligatoria):
context,q,category,from,to,cursor,limit - Campos de salida:
products,nextCursor,notice - Quién puede llamarla: plan de pago, alcance
receipts:read, contexto principal de una cuenta de negocio con acceso de propietario o superadministrador - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
Búsqueda para ChatGPT
search · Lectura
- Qué devuelve: hasta 20 facturas (identificador y título).
- Entradas (* obligatoria):
query* - Campos de salida:
results,processingNote - Quién puede llamarla: plan de pago, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
fetch · Lectura
- Qué devuelve: una factura como texto de documento, con las líneas de producto consolidadas.
- Entradas (* obligatoria):
id* - Campos de salida:
id,title,text,url,metadata - Quién puede llamarla: plan de pago, alcance
receipts:read - Efectos secundarios: ninguno, solo lee.
- Errores: límite de solicitudes, servicio de datos no disponible, rechazo del argumento
- Anotaciones: readOnlyHint true, destructiveHint false
Agregar facturas
receipts_add_dgi · Escritura sensible
- Qué devuelve: el estado de procesamiento de la factura agregada, o la factura existente cuando ya está en una de las cuentas de la persona.
- Entradas (* obligatoria):
context,url,cufe,move - Campos de salida:
receiptId,status,alreadyExists,existingContext,canMove,moved,notice - Quién puede llamarla: plan de pago, alcance
receipts:write, Permiso de escritura activado en la app (y en la cuenta de destino) - Efectos secundarios: agrega una factura (se lee en segundo plano). Con move en true, mueve una factura de la cuenta personal a la cuenta indicada.
- Errores: límite de solicitudes, servicio de datos no disponible, permiso de escritura desactivado, cuenta de solo lectura, límite diario de facturas agregadas con IA, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint true
receipts_add_manual · Escritura
- Qué devuelve: la factura agregada a partir de los datos escritos.
- Entradas (* obligatoria):
context,title*,date*,total*,tax,category*,fine_category,note,currency,tax_id,lines - Campos de salida:
receiptId,status,totalUsd,originalTotal,originalCurrency,exchangeRate,notice - Quién puede llamarla: plan de pago, alcance
receipts:write, Permiso de escritura activado en la app (y en la cuenta de destino) - Efectos secundarios: agrega una factura a partir de datos escritos, y un monto en otra moneda se convierte a USD con la tasa del día.
- Errores: límite de solicitudes, servicio de datos no disponible, permiso de escritura desactivado, cuenta de solo lectura, límite diario de facturas agregadas con IA, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint false
receipts_add_upload · Escritura
- Qué devuelve: un enlace de carga de un solo uso para el teléfono de la persona y un identificador de carga.
- Entradas (* obligatoria):
context - Campos de salida:
uploadUrl,uploadId,expiresInSec,notice - Quién puede llamarla: plan de pago, alcance
receipts:write, Permiso de escritura activado en la app (y en la cuenta de destino) - Efectos secundarios: crea un enlace de carga de un solo uso, y la foto que envía la persona se agrega como factura en segundo plano.
- Errores: límite de solicitudes, servicio de datos no disponible, permiso de escritura desactivado, cuenta de solo lectura, límite diario de facturas agregadas con IA, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint false
receipts_add_status · Escritura
- Qué devuelve: el estado de la carga (waiting-for-upload, processing, done, needs-review, exists-elsewhere, expired o failed) y el identificador de la factura una vez agregada.
- Entradas (* obligatoria):
upload_id* - Campos de salida:
status,receiptId,processId,reason,message,notice - Quién puede llamarla: plan de pago, alcance
receipts:write, Permiso de escritura activado en la app (y en la cuenta de destino) - Efectos secundarios: lee el estado de la carga y registra el resultado en la factura que creó.
- Errores: límite de solicitudes, servicio de datos no disponible, permiso de escritura desactivado, cuenta de solo lectura, límite diario de facturas agregadas con IA, rechazo del argumento
- Anotaciones: readOnlyHint false, destructiveHint false
Si tienes una pregunta sobre una herramienta, escribe a support@facturillo.com.