Configuración manual

Mortgage OS™ se expone como un servidor MCP remoto (HTTP). Si tu agente habla Model Context Protocol, lo conectas apuntando a nuestro punto de acceso. Una vez, y disponible en todas partes.

Punto de acceso

https://mcp.trioteca.com/mortgage

HTTP streamable sin clave para empezar 6 herramientas

Propiedad	Valor
Transporte	HTTP (streamable)
Autenticación	No requiere clave para empezar
Nombre del servidor	Mortgage server
Herramientas	6 (ver Herramientas)

Configuración por cliente

Claude Desktop / Claude Code

{
    "mcpServers": {
        "trioteca": {
            "type": "http",
            "url": "https://mcp.trioteca.com/mortgage"
        }
    }
}

Cursor / VS Code · mcp.json

{
    "servers": {
        "trioteca": {
            "type": "http",
            "url": "https://mcp.trioteca.com/mortgage"
        }
    }
}

Gemini CLI

Añade Trioteca con un comando:

gemini mcp add --transport http trioteca https://mcp.trioteca.com/mortgage

O decláralo en tu settings.json (~/.gemini/settings.json):

{
    "mcpServers": {
        "trioteca": {
            "httpUrl": "https://mcp.trioteca.com/mortgage"
        }
    }
}

Comprueba la conexión con /mcp dentro de la CLI.

Cliente MCP genérico

TypeScript

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
    new URL("https://mcp.trioteca.com/mortgage"),
);

const client = new Client({ name: "mi-agente", version: "1.0.0" });
await client.connect(transport);

// Descubre las herramientas disponibles
const { tools } = await client.listTools();
console.log(tools.map((t) => t.name));
// [
//   "simulate-mortgage",
//   "calculate-mortgage-taxes",
//   "calculate-associated-costs",
//   "calculate-mortgage-ratios",
//   "get-mortgage-index",
//   "search-knowledge-base"
// ]

curl

El punto de acceso habla JSON-RPC sobre HTTP streamable, así que puedes probarlo directamente desde la terminal. Incluye el header Accept con application/json y text/event-stream.

# Descubre las herramientas disponibles
curl -X POST https://mcp.trioteca.com/mortgage \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Llamar a una herramienta

Los nombres de argumentos son exactamente los que espera el servidor.

Simulación completa — simulate-mortgage

const result = await client.callTool({
    name: "simulate-mortgage",
    arguments: {
        currency: "eur",
        community: "community_of_madrid",
        property_usage: "primary_residence",
        property_amount: 250000,
        is_new_construction: false,
        down_payment: 60000,
        term_years: 30,
        interest_type: "fixed",
        interest_rate: 2.9,
        monthly_income_amount: 3200,
        monthly_expenses_amount: 400,
    },
});

Tipo variable

Para hipotecas a tipo variable, usa interest_type: "variable", indica el index_type (por ejemplo "euribor_12m") y pasa en interest_rate solo el diferencial negociado (por ejemplo 0.68 para "Euríbor + 0,68%"), sin sumar el valor del índice.

Impuestos de compra — calculate-mortgage-taxes

await client.callTool({
    name: "calculate-mortgage-taxes",
    arguments: {
        currency: "eur",
        community: "catalonia",
        property_amount: 300000,
        is_new_construction: false,
    },
});

Costes asociados — calculate-associated-costs

await client.callTool({
    name: "calculate-associated-costs",
    arguments: {
        currency: "eur",
        community: "valencian_community",
        property_amount: 300000,
        is_new_construction: false,
    },
});

Ratios de viabilidad — calculate-mortgage-ratios

await client.callTool({
    name: "calculate-mortgage-ratios",
    arguments: {
        currency: "eur",
        property_amount: 280000,
        savings_amount: 70000,
        monthly_income_amount: 3000,
        monthly_expenses_amount: 500,
        term_years: 30,
        interest_rate: 3.0,
    },
});

Índice de referencia — get-mortgage-index

await client.callTool({
    name: "get-mortgage-index",
    arguments: {
        type: "euribor_12m",
        period: "latest", // o un mes concreto: "2026-01"
    },
});

Base de conocimiento — search-knowledge-base

await client.callTool({
    name: "search-knowledge-base",
    arguments: {
        question: "¿Qué documentación necesito para pedir una hipoteca?",
    },
});

Valores admitidos

Algunos campos son enumeraciones. Estos son los valores válidos:

Campo	Valores
currency	eur, usd
community	andalusia, aragon, asturias, balearic_islands, basque_country, canary_islands, cantabria, castile_and_leon, castile_la_mancha, catalonia, community_of_madrid, extremadura, galicia, la_rioja, navarre, region_of_murcia, valencian_community
property_usage	primary_residence, secondary_residence, investment
interest_type	fixed, variable
index_type / type	euribor_1m, euribor_3m, euribor_6m, euribor_12m, irph

Probar con el inspector

¿Quieres inspeccionar las herramientas antes de integrar? Usa el MCP Inspector:

npx @modelcontextprotocol/inspector

Introduce la URL https://mcp.trioteca.com/mortgage, transporte HTTP, y explora tools, resources y prompts de forma interactiva.

Cálculo con datos reales

Las herramientas trabajan siempre con datos reales. Si falta un valor obligatorio (comunidad, precio, plazo, ingresos…), el agente lo pide antes de calcular, para garantizar un resultado fiable.

Próximos pasos

• Referencia completa de cada capacidad → Herramientas
• Dónde encaja y dónde no → Preguntas frecuentes