demo-app-mcp-prestamo
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@demo-app-mcp-prestamo Quiero solicitar un préstamo de S/ 3,500"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Banco D: demo de MCP App
Servidor MCP que muestra un widget interactivo dentro de un cliente MCP (por ejemplo, Claude Desktop) para un flujo de solicitud de préstamo online. La app pertenece a Banco D, un banco ficticio.
Es una demo educativa del estándar MCP Apps (SEP-1865). Lo interesante no es la solicitud de préstamo en sí, sino que en un mismo flujo se muestran tres niveles distintos de qué ve el agente en cada paso.
Autor: Diego Ponce de León. Los datos, la marca y los cálculos son ficticios.
Índice
Related MCP server: Consignado MCP Local
Los tres niveles de visibilidad al agente
Cada respuesta de una tool en MCP Apps tiene dos canales:
content: texto que el agente lee.structuredContent: JSON que va al widget (el agente no lo ve).
Con esos dos canales y el flag _meta.ui.visibility, el desarrollador decide, en cada paso, qué llega al agente. Esta demo usa los tres niveles posibles.
Nivel 1: el agente lo ve todo
En esta demo ocurre al iniciar la solicitud (iniciar_solicitud_prestamo). Si el usuario mencionó un monto en el chat, el agente lo pasa como monto_sugerido y el widget arranca con ese monto pre-llenado.
Nivel 2: el agente ve solo el resultado
El widget captura los datos y el content de la tool devuelve solo el resultado agregado. Los detalles del formulario no llegan al agente.
En esta demo ocurre en la selección de plan. Cuando el usuario elige un plan en el widget, el agente recibe un texto como "Plan elegido: 12 cuotas de S/ 320,88 (pago total S/ 3 850,56, intereses S/ 350,56)". Nada más.
Nivel 3: el agente no ve nada
La tool tiene _meta.ui.visibility=["app"], así que el cliente MCP la oculta del listado del agente. El agente ni siquiera sabe que la tool existe. Solo el widget la puede llamar, vía postMessage.
En esta demo ocurre con autorizar_con_clave (el PIN nunca aparece en el contexto del modelo, ni siquiera un intento fallido) y con capturar_cuenta_destino (el número de cuenta destino se queda dentro del widget). Cuando el flujo termina, el widget emite un ui/message explícito para avisar al agente del resultado final.
Cómo funciona la demo, paso a paso
Paso 1: monto y día de pago (nivel 1). El agente detecta que el usuario quiere un préstamo y llama
iniciar_solicitud_prestamo. Si el usuario mencionó un monto en el chat, el agente lo pasa comomonto_sugeridoy el widget arranca con ese valor pre-llenado; si no, el widget arranca vacío. El usuario ajusta el día de pago y hace clic en "Ver mis opciones".Paso 2: elegir plan (nivel 2). El widget calcula 3 planes (12, 24 y 36 cuotas) con cuota mensual, total, intereses y TCEA. El usuario elige uno. El agente recibe solo el plan elegido y los tres valores comerciales del plan.
Paso 3: evaluación y términos (nivel 2). El widget muestra un spinner por 2,5 segundos y transiciona a "aprobado". El usuario acepta los términos.
Paso 4: autorización con PIN (nivel 3). El widget muestra un keypad numérico con countdown de 2:00. El PIN de prueba es
1234. El agente no ve la toolautorizar_con_claveen su lista y no puede llamarla. Si el usuario ingresa mal el PIN, el widget lo indica; el agente no se entera.Paso 5: cuenta destino (nivel 3). El usuario elige a qué cuenta se acredita el préstamo y la forma de pago. Las cuentas están escritas directamente en el widget (en producción vendrían del perfil autenticado del cliente). La tool que registra la selección también es solo-widget, así que el número de cuenta no pasa por el canal del agente.
Paso 6: desembolsado (nivel 1, cierre). El widget confirma el desembolso y emite un
ui/messagecon el resumen: "Préstamo desembolsado: S/ 3 500,00 en 12 cuotas de S/ 320,88 (TCEA 19,56%). Nº operación BD-XXXXXXXX. Débito automático el día 15 de cada mes.". Con eso el agente puede continuar la conversación con contexto del cierre.
Instalación
Requisitos:
Python 3.11+
uvinstaladoClaude Desktop (macOS o Windows), o cualquier cliente compatible con MCP Apps
Clonar e instalar:
git clone https://github.com/dponcedeleonf/demo-app-mcp-prestamo.git
cd demo-app-mcp-prestamo
uv syncVerificar el servidor sin conectarlo al cliente:
uv run python -m banco_d --introspectDebería imprimir el UI resource, las 9 tools con su _meta y visibility, y validar que el HTML sea correcto.
Conectar a Claude Desktop
Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows) y agrega la entrada:
{
"mcpServers": {
"banco-d": {
"command": "uv",
"args": [
"--directory",
"/ruta/absoluta/a/demo-app-mcp-prestamo",
"run",
"python",
"-m",
"banco_d"
]
}
}
}Reemplaza /ruta/absoluta/... con la ruta real. Cierra Claude Desktop con Cmd+Q y ábrelo de nuevo. Empieza una conversación nueva y pídele un préstamo al agente. PIN de prueba: 1234.
Esta demo no es un patrón de despliegue a producción
Esta demo corre en stdio con edición manual del config del cliente. Esa no es la forma en la que un producto real se conecta a Claude Desktop u otro cliente MCP. Ninguna empresa (banco, retail, salud) le pediría a un cliente instalar Python, copiar archivos y editar claude_desktop_config.json.
En producción, un servidor MCP orientado a clientes se despliega sobre HTTPS con OAuth 2.1 y se instala vía Settings → Connectors en Claude Desktop, claude.ai u otro cliente compatible. Ese modelo permite autenticación por usuario, multi-tenencia, auditoría, control de tráfico y actualización centralizada.
Estructura del código
demo-app-mcp-prestamo/
├── pyproject.toml
├── README.md
├── uv.lock
└── src/banco_d/
├── __init__.py
├── __main__.py # punto de entrada: python -m banco_d
├── server.py # servidor MCP: registro de tools y resources
├── sessions.py # estado en memoria por session_id
├── prestamo/
│ ├── __init__.py
│ ├── state.py # PrestamoState + cálculo cuota francesa (TNA 18%)
│ └── tools.py # 9 tools del flujo, con visibility declarada
└── views/
└── prestamo_view.html # widget de 6 pantallas + keypad + countdownReferencias útiles para leer el código:
prestamo/tools.py: el docstring del módulo separa las tools visibles al agente de las que son solo del widget. Cada entrada de la listaTOOLSlleva un tag[AGENTE]o[SOLO WIDGET].server.py, función_tool_meta: genera el_meta.ui.visibilityque el cliente MCP respeta para ocultar tools del listado del agente.prestamo_view.html, sección PANTALLA 4: el keypad, el countdown OTP, el enlace "Solicitar nueva clave" y el emisor deui/messagepost-autorización.prestamo_view.html, sección MCP APPS: descripción de cada método JSON-RPC del protocolo y quién lo manda.prestamo_view.html,maybeEmitUiMessage: cómo el widget envía texto al contexto del agente cuando decide hacerlo.
Licencia
MIT.
Available Tools
9 toolsautorizar_con_claveA
Tool interna del widget: recibe el PIN que el usuario tecleó en el keypad y devuelve el resultado de la autorización. NO debe ser invocada por el agente.
Inputs: pin (required).
capturar_cuenta_destinoA
Tool interna del widget: recibe la cuenta destino del desembolso y la forma de pago (automatico/manual) elegidas por el usuario post-autorización. Genera el número de operación y confirma el desembolso. NO debe ser invocada por el agente.
Inputs: forma_pago (required), cuenta_destino (required).
capturar_monto_y_fechaA
Registra el monto (en soles) y el día del mes para el pago (1 a 28) de una solicitud de préstamo que ya se inició con iniciar_solicitud_prestamo. Con esos dos datos, el servidor calcula tres planes de pago (12, 24 y 36 cuotas, cada uno con su cuota mensual, intereses totales y TCEA) y el widget avanza al paso donde el usuario elige uno de esos planes.
Normalmente la llama el widget cuando el usuario envía el formulario del primer paso. Tú también puedes llamarla si el usuario te da los dos valores directamente en el chat (por ejemplo, 'quiero 3500 soles y que me cobren el día 15').
Te devuelve un mensaje con los tres planes ya calculados, para que puedas comentarlos si el usuario te pregunta antes de elegir.
Inputs: monto (required), dia_pago (required).
confirmar_prestamoA
Registra la aceptación de términos y condiciones del préstamo. Después de esta tool, el widget muestra al usuario un keypad donde ingresa su PIN para autorizar el desembolso.
Normalmente la llama el widget cuando el usuario acepta los términos con el botón de la interfaz. Tú también puedes llamarla si el usuario acepta explícitamente en el chat (por ejemplo, 'sí, acepto los términos y condiciones').
La autorización con el PIN la hace después el propio widget con una tool interna que tú no ves. El PIN del usuario no aparece en el chat ni en ninguna respuesta que tú recibas.
Inputs: acepta_terminos (required).
consultar_estado_solicitudA
Devuelve un resumen en texto del estado actual de la solicitud de préstamo del usuario: en qué paso va, qué datos se capturaron hasta el momento, si ya autorizó o no. No modifica nada ni afecta al widget.
Llámala cuando el usuario te pregunte por el estado de su solicitud (por ejemplo, 'en qué paso voy', 'qué me falta', 'cuánto era el monto que puse').
Inputs: no named parameters.
elegir_plan_pagoA
Selecciona uno de los tres planes de pago disponibles (12, 24 o 36 cuotas) para una solicitud en la que ya se capturó monto y día. El widget avanza al paso de confirmación de términos.
Normalmente la llama el widget cuando el usuario hace clic en la tarjeta de un plan. Tú también puedes llamarla si el usuario te dice cuál elige en el chat (por ejemplo, 'prefiero el de 24 cuotas').
Te devuelve un mensaje con la cuota mensual, el pago total y los intereses del plan elegido.
Inputs: cuotas (required).
estado_prestamoA
Tool interna del widget: devuelve el estado actual del préstamo en structuredContent. NO debe ser invocada por el agente.
Inputs: no named parameters.
iniciar_solicitud_prestamoA
Inicia una nueva solicitud de préstamo en Banco D. Muestra un widget interactivo (una pequeña app dentro del chat) donde el usuario captura él mismo el día de pago, el plan de cuotas, el PIN y la cuenta de destino paso por paso.
REGLA IMPORTANTE: llama esta tool INMEDIATAMENTE cuando el usuario expresa interés en un préstamo. NO le preguntes al usuario por día de pago, cuotas, plan, cuenta destino, PIN, ni ningún otro dato antes de llamar la tool. El widget se encarga de capturarlos.
El ÚNICO dato que puedes inferir del contexto conversacional es el monto_sugerido (si el usuario mencionó una cifra concreta, ej. 'una laptop de 3500', 'un electrodoméstico de 1200'). Ese monto pre-llena el formulario para que el usuario no lo escriba. Si no hay cifra clara, no pases el parámetro.
Inputs: monto_sugerido.
reiniciar_solicitudA
Descarta la solicitud actual y devuelve al usuario al primer paso del flujo (captura de monto y día de pago). Se pierden todos los datos capturados hasta el momento. El widget se vuelve a mostrar en el primer paso con los campos vacíos.
Llámala cuando el usuario te pida empezar de nuevo (por ejemplo, 'reinicia', 'cancela y empieza de cero', 'quiero cambiar el monto desde el principio').
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
The main flow tools are distinct, but the inclusion of internal widget tools (autorizar_con_clave, capturar_cuenta_destino, estado_prestamo) creates potential ambiguity, especially between estado_prestamo and consultar_estado_solicitud. Descriptions help clarify, but the agent must be careful to avoid invoking internal tools.
Most tool names follow a verb_noun pattern in Spanish snake_case (e.g., iniciar_solicitud_prestamo, capturar_monto_y_fecha, elegir_plan_pago). The main deviation is estado_prestamo, which is a noun phrase, and a couple of names use 'con' (autorizar_con_clave, capturar_cuenta_destino). Overall the convention is consistent.
Nine tools is within the typical range, but three are internal widget tools that the agent should never call, inflating the count and adding noise. The effective public tool count is six, which is well-scoped for the loan application flow.
The loan request flow is fully covered from initiation through capture, plan selection, confirmation, reset, and status query. PIN and destination account steps are handled internally by the widget, so no public tools are needed for those. No obvious gaps in the agent-facing surface.
Maintenance
Related MCP Connectors
MCP Server for agents to onboard, pay, and provision services autonomously with InFlow
Demo personal-finance MCP App: spending, subscriptions, and net worth as interactive UI.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
An AI concierge that turns static forms into adaptive AI conversations. From any MCP client.
Related MCP Servers
- AlicenseAqualityDmaintenanceThis MCP server connects AI agents with Colombian e-commerce, travel, and financial services, allowing users to search MercadoLibre, find hotels, and compare banking products like CDTs and loans. It enables seamless integration with local services in pesos colombianos through specialized tools for shopping, travel planning, and financial simulation.838 npm2MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for orchestrating the consignado loan journey via WhatsApp agent, centralizing flow rules, identity resolution, and journey consistency.-
- FlicenseNot gradedqualityDmaintenanceDemonstrates how to expose approved internal banking tools to AI assistants via MCP, enabling secure lookups of account balances, customer names, branch details, and live exchange rate conversions.-
- AlicenseNot gradedqualityDmaintenanceDemo MCP server for ACEL, a runtime verification middleware that blocks a rule-violating tool call before it executes. 5 tools (authenticate, read/validate/delete records, send payment) showing ACEL enforcing call ordering and state preconditions live via the official MCP SDK's middleware hook.1MIT