Capacidades (MCP tools)

48 herramientas que los agentes pueden invocar. JSON en /capabilities.json · probar el chat.

bastanteo 3
bastanteo_legal_entity_data	Devuelve los datos de PERSONA JURÍDICA del usuario autenticado en bastanteo: datos de la empresa (nombre, CIF, dirección, CNAE), administradores y titulares reales. Solo aplica si el usuario es persona jurídica (si no, devuelve found:false). No recibe email: el servidor resuelve al usuario autenticado.
bastanteo_onboarding_status	Devuelve el ESTADO del onboarding/KYC del usuario autenticado en bastanteo: pasos completados, paso actual, y verificaciones (teléfono, identidad, contrato firmado, wallet creada). No recibe email: el servidor resuelve al usuario autenticado.
bastanteo_user_profile	Devuelve el perfil del usuario autenticado en bastanteo (KYC/onboarding): si es persona física o jurídica y si completó el proceso de bastanteo. No recibe email: el servidor resuelve al usuario autenticado.
cache 1
redis_get	Lee claves de un servidor Redis del cliente (solo lectura). Soporta las operaciones get, mget, keys, ttl, type, exists, hgetall, llen, scard y strlen. Rechaza cualquier operación de escritura o destructiva. Útil para inspeccionar el contenido de un Redis sin riesgo de modificarlo.
crypto-utils 5
base64_tool	Codifica un texto a base64 o decodifica una cadena base64 a texto plano. Útil cuando el usuario necesita convertir datos hacia/desde base64.
hash_text	Calcula el hash de un texto con md5, sha1, sha256 o sha512 y lo devuelve en hexadecimal. Útil para verificar integridad o generar huellas de un texto.
jwt_decode	Decodifica (SIN verificar la firma) el header y el payload de un JWT y muestra sus claims. ATENCIÓN: no valida la firma ni la caducidad, solo decodifica para inspección. Útil para depurar tokens, nunca para confiar en ellos.
password_strength	Evalúa la fortaleza de una contraseña analizando su longitud, las clases de caracteres que usa, una estimación de entropía en bits y un veredicto. Útil para orientar al usuario sobre si una contraseña es débil o robusta. No almacena ni transmite la contraseña.
uuid_generate	Genera identificadores UUID. Soporta v4 (aleatorio) y v7 (ordenable por tiempo). Útil cuando el usuario necesita uno o varios identificadores únicos.
cuadro 4
dashboard_bank_summary	Devuelve el RESUMEN BANCARIO del cuadro de mandos del usuario autenticado: saldo agregado de sus cuentas y las 10 transacciones más recientes (de la agregación bancaria de WealthReader). No recibe email: el servidor resuelve al usuario.
dashboard_documents_analysis	Devuelve el ESTADO del análisis de documentos fiscales/financieros del usuario autenticado en el cuadro de mandos: total, conteo por estado (pendiente/procesando/completado/fallido) y tipos de documento. No incluye el contenido extraído. No recibe email: el servidor resuelve al usuario.
dashboard_erp_summary	Devuelve los ERPs conectados del usuario autenticado en el cuadro de mandos y su estado de sincronización (tipo, nombre, empresa, activo, última actualización, errores y qué datos tiene). Nunca expone credenciales. No recibe email: el servidor resuelve al usuario.
dashboard_kpi_snapshot	Devuelve un RESUMEN EJECUTIVO (KPIs) del cuadro de mandos del usuario autenticado: saldo bancario agregado, nº de cuentas, documentos analizados y % completado, ERPs activos e incidencias. No recibe email: el servidor resuelve al usuario. Úsala para una visión global rápida.
data 3
csv_to_json	Convierte texto CSV en JSON (array de objetos), usando la primera fila como cabecera de campos. Útil cuando el usuario quiere transformar datos tabulares CSV en estructuras JSON.
json_tool	Valida y formatea texto JSON. Operaciones: "validate" (comprueba si es JSON válido), "pretty" (lo indenta de forma legible) y "minify" (lo compacta sin espacios). Útil cuando el usuario quiere comprobar, embellecer o compactar un JSON.
regex_test	Prueba un patrón de expresión regular (PCRE) contra un texto y devuelve si hay coincidencia y los grupos capturados. Útil cuando el usuario quiere validar o depurar una regex.
database 4
db_tables	Introspecciona el esquema de una base de datos (MySQL/MariaDB o PostgreSQL). Sin "table" devuelve la lista de tablas base; con "table" devuelve sus columnas (nombre, tipo, si admite NULL y valor por defecto). Útil para que el agente sepa qué tablas y columnas existen antes de consultar.
mysql_query	Ejecuta una consulta de SOLO LECTURA (SELECT/SHOW/EXPLAIN/DESCRIBE/WITH) contra una base de datos MySQL o MariaDB de un cliente y devuelve las filas resultantes. Rechaza cualquier sentencia que modifique datos. Aplica un LIMIT defensivo si la consulta no lo incluye.
postgres_query	Ejecuta UNA consulta de solo lectura (SELECT, SHOW, EXPLAIN, DESCRIBE o WITH) contra una base de datos PostgreSQL y devuelve las filas. Las consultas que modifican datos están bloqueadas. Se aplica un LIMIT por defecto para no traer demasiadas filas. Útil para inspeccionar datos de una BD Postgres del cliente.
project_query	Ejecuta una consulta de SOLO LECTURA (SELECT/WITH) contra la base de datos de un PROYECTO del cliente identificado por nombre (p. ej. "wallet" o "factoring"). Las credenciales NO se exponen: se resuelven en el servidor por el nombre del proyecto. Los resultados se acotan SIEMPRE, en el servidor, al email del usuario autenticado: el backend fuerza el filtro por usuario, así que NO es posible leer datos de terceros y NO debes incluir ningún email/usuario en la consulta (se ignora). Usa el campo "project" con uno de los proyectos disponibles y una consulta SELECT sobre las tablas del proyecto.
datetime 3
current_datetime	Devuelve la fecha y hora actuales en una zona horaria concreta (por defecto "Europe/Madrid"): ISO 8601, timestamp Unix, fecha y hora legibles y día de la semana. Útil cuando el usuario pregunta "qué hora es" o necesita la fecha de hoy.
date_diff	Calcula la diferencia entre dos fechas/horas y la devuelve humanizada (años, meses, días, horas, minutos, segundos) y en totales. Útil cuando el usuario pregunta cuánto tiempo hay entre dos fechas o cuántos días faltan para algo.
timezone_convert	Convierte una fecha/hora de una zona horaria a otra. Útil cuando el usuario quiere saber qué hora será en otra ciudad o región para un instante concreto.
domain-health 1
check_domain_health	Comprueba la salud de correo de un dominio: registros MX, SPF, DKIM y DMARC. Útil cuando el usuario pregunta si un dominio está bien configurado para enviar correo.
factoring 4
factoring_investment_detail	Devuelve el DETALLE de una inversión concreta del usuario autenticado en factoring (importes, beneficio, fechas, tipo, garantías, porcentajes). Requiere el id de la inversión. El servidor verifica que la inversión pertenece al usuario (no es posible ver las de terceros).
factoring_investments	Devuelve el listado paginado de inversiones/operaciones del usuario autenticado en factoring (importe, retorno, beneficio, fechas, estado de pago). No recibe email: el servidor resuelve al usuario. Acepta paginación opcional (page, limit).
factoring_user_profile	Devuelve el PERFIL del usuario autenticado en factoring: si es inversor o financiado, razón social, NIF/CIF, nombre de empresa y nacionalidad. No recibe email/identificador: el servidor resuelve al usuario autenticado. Úsala cuando pregunte por su perfil de factoring.
factoring_user_statistics	Devuelve las ESTADÍSTICAS agregadas del usuario autenticado en factoring: número de inversiones/operaciones, total invertido o recibido, total pagado y beneficio. No recibe email: el servidor resuelve al usuario. Úsala para un resumen de su actividad de factoring.
net 2
dns_lookup	Resuelve registros DNS de un host para un tipo concreto (A, AAAA, MX, TXT, NS o CNAME). Útil cuando el usuario quiere consultar la configuración DNS de un dominio o host.
ip_info	Resuelve un hostname a sus direcciones IP (v4 y v6) y, si se le pasa una IP, intenta el reverse DNS (PTR). Útil para saber a qué IPs apunta un host.
prontopago 4
prontopago_active_rules	Devuelve las REGLAS configuradas para el usuario autenticado en prontopago: elegibilidad, fechas de vencimiento, límites, métodos de pago y grupos de descuento. No recibe email: el servidor resuelve al usuario. Úsala cuando pregunte por sus reglas/condiciones.
prontopago_invoices_summary	Devuelve un RESUMEN de las facturas del usuario autenticado en prontopago: número total, pendientes de pago, conteo por estado e importe total. No recibe email: el servidor resuelve al usuario. Úsala para una visión rápida de la facturación del usuario.
prontopago_unpaid_invoices	Devuelve la lista de FACTURAS PENDIENTES de pago del usuario autenticado en prontopago (número, importe, estado, fecha de vencimiento, si está vencida), ordenadas por vencimiento. No recibe email: el servidor resuelve al usuario. Acepta limit opcional.
prontopago_user_profile	Devuelve el PERFIL del usuario autenticado en prontopago: razón social, NIF de empresa, roles (proveedor/cliente), IBAN de proveedor y estado. No recibe email: el servidor resuelve al usuario autenticado. Úsala cuando pregunte por su perfil en prontopago.
sso 2
sso_authorized_projects	Devuelve la lista de PROYECTOS/servicios de SmartEscrow a los que el usuario autenticado tiene acceso autorizado (p. ej. wallet, factoring, prontopago, cuadro, bastanteo). No recibe argumentos: el servidor resuelve al usuario autenticado. Útil para saber qué datos puedes consultarle.
sso_user_profile	Devuelve el PERFIL del usuario autenticado en el SSO de SmartEscrow: nombre, email, roles, tipo de persona, NIF/empresa, estado de la cuenta y los proyectos a los que tiene acceso. No recibe ni necesita ningún email/identificador: el servidor resuelve al usuario autenticado. Úsala cuando el usuario pregunte por sus datos de cuenta, su perfil o quién es.
text 4
case_convert	Convierte un texto entre mayúsculas, minúsculas, Título, snake_case, camelCase y kebab-case. Útil cuando el usuario quiere normalizar el estilo de un texto o identificador.
lorem_ipsum	Genera texto de relleno (lorem ipsum) con el número de párrafos y de palabras por párrafo indicados. Útil cuando el usuario necesita contenido de prueba para maquetar.
slugify	Convierte un texto en un slug apto para URLs (minúsculas, sin acentos, palabras unidas por un separador). Útil cuando el usuario necesita un identificador legible para una URL.
text_stats	Cuenta palabras, caracteres (con y sin espacios), líneas y frases de un texto, y estima el tiempo de lectura. Útil cuando el usuario quiere medir la longitud de un texto.
wallet 5
wallet_account_details	Devuelve el ESTADO DE CUENTA EN VIVO de la wallet del usuario autenticado, consultado a Sefide: IBAN, saldo disponible, divisa, estado operativo de la cuenta y bloqueos (normativo/operativo). No recibe ni necesita ningún email/identificador: el servidor resuelve al usuario autenticado y consulta SOLO su cuenta. Úsala cuando el usuario pregunte por su IBAN, el estado de su cuenta o los detalles de su wallet (más allá del saldo).
wallet_balance	Devuelve el SALDO REAL y EN VIVO de la wallet del usuario autenticado, consultado a Sefide (la fuente de verdad), no a la base de datos (que está desincronizada). No recibe ni necesita ningún email/identificador: el servidor resuelve al usuario autenticado y consulta SOLO su wallet. Devuelve el saldo disponible, la divisa y el estado operativo de la cuenta. Úsala SIEMPRE que el usuario pregunte por su saldo, dinero disponible o estado de su wallet.
wallet_direct_debits	Devuelve las DOMICILIACIONES/adeudos directos recibidos (recibos) EN VIVO de la wallet del usuario autenticado, consultados a Sefide. No recibe email/identificador: el servidor resuelve al usuario autenticado. Acepta filtros opcionales por fechas (fecha_inicio, fecha_fin en formato YYYY-MM-DD) y limit. Úsala cuando el usuario pregunte por sus recibos o quién le domicilia pagos.
wallet_movements	Devuelve los MOVIMIENTOS/transacciones EN VIVO de la wallet del usuario autenticado (ingresos, cargos, transferencias), consultados a Sefide. No recibe email/identificador: el servidor resuelve al usuario autenticado y consulta SOLO sus movimientos. Acepta paginación opcional (limit, offset). Úsala cuando el usuario pregunte por sus últimos movimientos, su historial o sus transacciones.
wallet_transfer_details	Devuelve el DETALLE EN VIVO de una transferencia concreta de la wallet del usuario autenticado (IBAN ordenante/beneficiario, importe, concepto, estado, fechas), consultado a Sefide. Requiere el id de operación de la transferencia. El servidor acota la consulta a la cuenta del usuario autenticado: no es posible ver operaciones de terceros.
web 3
http_api_request	Llama a una API REST (interna de SmartEscrow o del cliente) con el método, cabeceras, query string y cuerpo (JSON o texto) indicados, y devuelve la respuesta: estado HTTP, content-type, un subconjunto seguro de cabeceras, el cuerpo (truncado a 20000 caracteres) y, si la respuesta es JSON, el cuerpo decodificado. AVISO DE SEGURIDAD: es un fetch ejecutado en el servidor y puede apuntar a URLs arbitrarias (riesgo de SSRF); úsalo solo con APIs internas o del cliente, nunca con URLs no confiables.
http_status	Hace una petición GET a una URL y devuelve el código de estado HTTP, el content-type, el tamaño en bytes del cuerpo y el tiempo total en milisegundos. Útil para comprobar si una URL está disponible y cómo responde.
url_metadata	Descarga una URL HTML y extrae sus metadatos básicos: el <title>, la meta description y el og:title de Open Graph. Útil para obtener una vista previa de una página web.