Herramientas

Seis capacidades componen el núcleo de Mortgage OS™. Cada una es una herramienta MCP de solo lectura y sin efectos secundarios, que responde con datos estructurados (cada importe como { value, currency }) listos para construir encima.

Herramienta	Qué obtienes
simulate-mortgage	Cuota mensual, interés total, pago total y número de cuotas.
calculate-mortgage-taxes	Desglose y total de impuestos de compra (IVA, AJD, ITP).
calculate-associated-costs	Desglose y total de costes no fiscales (notaría, registro, gestoría, tasación).
calculate-mortgage-ratios	Ratios de viabilidad LTC, LTV y DTI.
get-mortgage-index	Índice de referencia oficial (Euríbor, IRPH) del Banco de España.
search-knowledge-base	Respuesta fundamentada desde la base de conocimiento de Trioteca.

simulate-mortgage solo lectura

Genera una simulación hipotecaria completa para España con salidas deterministas: proyección de cuotas, coste total de financiación, impuestos de compra, costes asociados e indicadores de viabilidad en un único escenario coherente.

Entradas

Campo	Tipo	Obligatorio	Notas
currency	enum	Sí	eur (por defecto) o usd.
community	enum	Sí	Comunidad autónoma de la vivienda.
property_usage	enum	Sí	primary_residence, secondary_residence, investment.
property_amount	número	Sí	Precio o valor de tasación (≥ 1).
is_new_construction	booleano	Sí	Si es obra nueva.
down_payment	número	No	Entrada inicial (≥ 0).
term_years	entero	Sí	Plazo en años (1–50).
interest_type	enum	Sí	fixed o variable.
interest_rate	número	No	% anual (0–20). En variable, solo el diferencial. Si se omite, se usa la mejor oferta disponible (por defecto 2,25).
index_type	enum	No	Índice de referencia para tipo variable (euribor_1m, euribor_3m, euribor_6m, euribor_12m, irph).
monthly_income_amount	número	Sí	Ingresos mensuales (≥ 0).
monthly_expenses_amount	número	No	Gastos mensuales (≥ 0).

Salida: devuelve los datos de la operación (comunidad, uso, importe, entrada, ingresos y gastos, plazo, tipo y tipo de interés) más un objeto details con:

• loan_amount — importe financiado.
• monthly_payment — cuota mensual estimada.
• number_of_payments — número total de cuotas.
• total_interest — interés total del préstamo.
• total_payment — pago total (principal, interés, impuestos y costes).
• ratios_result — ratios de viabilidad (LTC, LTV, DTI).
• taxes_result — impuestos de compra (mismo formato que calculate-mortgage-taxes).
• associated_costs_result — costes asociados (mismo formato que calculate-associated-costs).
• index — índice de referencia usado, en hipotecas a tipo variable.

Cada importe se devuelve como { value, currency }.

calculate-mortgage-taxes solo lectura

Estima los impuestos de compra de una vivienda en España y su impacto en caja, aplicando la lógica fiscal específica del país.

Entradas

Campo	Tipo	Obligatorio	Notas
currency	enum	Sí	eur (por defecto) o usd.
community	enum	Sí	Comunidad autónoma.
property_amount	número	Sí	Precio o valor (≥ 0).
is_new_construction	booleano	Sí	Si es obra nueva.

Salida: lista de impuestos aplicables (iva, ajd, itp), cada uno con su tipo (rate, en %) e importe (amount como { value, currency }), más el tipo total combinado (total_rate) y el importe total (total_amount).

calculate-associated-costs solo lectura

Estima los costes no fiscales de una operación residencial en España, con un desglose determinista independiente de los impuestos.

Entradas

Campo	Tipo	Obligatorio	Notas
currency	enum	Sí	eur (por defecto) o usd.
community	enum	Sí	Comunidad autónoma.
property_amount	número	Sí	Precio o valor (≥ 1).
is_new_construction	booleano	Sí	Si es obra nueva.

Salida: lista de costes (notary, registry, agency, appraisal), cada uno con su tipo (rate, en % cuando aplica, o 0 en importes fijos) e importe (amount como { value, currency }), más el importe total (total_amount).

calculate-mortgage-ratios solo lectura

Evalúa la viabilidad y capacidad de pago de una hipoteca en España mediante los ratios de decisión clave. Útil para un cribado rápido antes de un análisis más profundo.

Entradas

Campo	Tipo	Obligatorio	Notas
currency	enum	Sí	eur (por defecto) o usd.
property_amount	número	Sí	Precio o valor (≥ 1).
savings_amount	número	Sí	Ahorros disponibles (≥ 0).
monthly_income_amount	número	Sí	Ingresos netos mensuales (≥ 1).
monthly_expenses_amount	número	No	Gastos mensuales, incluidos otros préstamos.
term_years	entero	Sí	Plazo en años (1–50).
interest_rate	número	Sí	% anual (0,01–20).

Salida

• LTC (Loan to Cost): préstamo sobre el coste total de la operación.
• LTV (Loan to Value): préstamo sobre el valor de la vivienda.
• DTI (Debt to Income): cuota estimada sobre los ingresos netos mensuales.

get-mortgage-index solo lectura Banco de España

Recupera índices de referencia oficiales (Euríbor a 1/3/6/12 meses, IRPH) usando fuentes del Banco de España. Admite el último dato disponible o un mes concreto.

Entradas

Campo	Tipo	Obligatorio	Notas
type	enum	Sí	euribor_1m, euribor_3m, euribor_6m, euribor_12m, irph.
period	string	No	latest o un mes YYYY-MM (por ejemplo 2026-01).

Salida: el índice (type), su unidad (unit: percent o basis_points) y su valor (value), junto con el mes (period) al que corresponde.

search-knowledge-base solo lectura

Busca en la base de conocimiento curada de Trioteca respuestas sobre política, producto, procesos, elegibilidad y dudas hipotecarias, apoyándose en contenido documentado para responder con contexto en lugar de suposiciones.

Entradas

Campo	Tipo	Obligatorio	Notas
question	string	Sí	Pregunta a buscar (mín. 3 caracteres).

Salida: respuesta fundamentada, o aviso de que no se encontró información relevante.

Widget de simulación

El conector incluye un recurso de widget interactivo (ui://mortgage/simulation). En clientes MCP App, el usuario ve la simulación de forma visual y puede comparar escenarios, no solo leer texto.

Datos y precisión

Cada resultado se calcula con el mismo motor que Trioteca usa en producción. La precisión depende de los datos que proporciones; como cualquier simulación, las condiciones definitivas las formaliza la entidad. Impuestos y costes asociados se devuelven como bloques separados para preservar la claridad financiera.