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_summary y vendors_summary cuestan 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.