DealFlowPro MCP Server
análisis de ofertas de bienes raíces multifamiliares — cap rate, DSCR, cash-on-cash, IRR, DFP Score, precio máximo de oferta para propiedades de 2 a 200 unidades
Documentación
Servidor MCP de DealFlowPro
Analiza ofertas de bienes raíces multifamiliares desde Claude Code, Cursor, Claude Desktop o cualquier cliente compatible con MCP. La primera herramienta de suscripción de bienes raíces en el ecosistema MCP.
DealFlowPro es una plataforma de análisis de ofertas multifamiliares impulsada por IA. Este servidor MCP envuelve la API REST de DealFlowPro, brindando a los agentes de IA acceso a cálculos de suscripción de nivel institucional.
Demo
Lo que puedes hacer
Pregúntale a Claude de forma natural y él llamará a la herramienta correcta:
- "Analiza esta oferta de 24 unidades en Charlotte — piden $2M, $13.6K/mes de renta, $5.5K de gastos"
- "Califica esta oferta: 12 unidades, $1.5M, $9K de ingreso mensual"
- "¿Cuál es el máximo que debería ofrecer por una propiedad con $28.8K/mes de renta si quiero un 8% de retorno en efectivo?"
- "¿Está esta propiedad en una zona de inundación? 2909 Burgess Dr, Charlotte, NC"
Herramientas
| Herramienta | Descripción |
|---|---|
analyze_deal | Análisis completo de la oferta: tasa de capitalización, DSCR, retorno en efectivo, TIR, puntaje DFP (0-100), precio máximo de oferta, flujos de efectivo anuales |
score_deal | Evaluación rápida: puntaje DFP + métricas clave |
reverse_calc | Precio máximo de oferta a partir de retornos objetivo (tasa de capitalización, CoC, DSCR, TIR) |
market_data | Zona de inundación, ingreso del vecindario vs. mediana estatal, crecimiento de empleo para cualquier dirección |
Las cuatro llevan anotaciones MCP 2025-06-18 (title, readOnlyHint, destructiveHint, idempotentHint, openWorldHint). Cada herramienta es de solo lectura.
Instalar como plugin de Claude
Este repositorio funciona también como plugin de Claude Code / Cowork. El plugin se conecta al servidor remoto en https://dealflowpro.io/mcp en lugar del paquete npm anterior, lo que significa:
- Ocho herramientas en lugar de cuatro. Agrega
list_my_deals,get_deal_analysis,get_my_criteriayportfolio_summary— tus ofertas guardadas, criterios de compra y pipeline, limitados a tu cuenta. - OAuth en lugar de una clave API. No hay
DFP_API_KEYque exportar; inicias sesión en tu cuenta de DealFlowPro cuando el plugin se conecta.
claude --plugin-dir /path/to/dealflowpro-mcp-server
Usa el paquete npm a continuación si prefieres un servidor stdio local, prefieres autenticación con clave API o estás conectando DealFlowPro a un cliente MCP que no sea de Claude.
Para equipos de IA institucionales
DealFlowPro está diseñado para integrarse en pipelines de evaluación de IA y stacks de IA de producción. El servidor MCP (este paquete, más el endpoint remoto en https://dealflowpro.io/mcp) envuelve el mismo motor que la API REST — estricto en esquemas, idempotente, predecible.
Autenticación + alcance. Cada llamada a herramienta requiere una clave API Bearer. Las llamadas están limitadas a la cuenta que emitió la clave — sin ruta de acceso entre inquilinos. Las líneas de auditoría por herramienta llegan a logs/mcp_tool_calls.log de tu cuenta capturando el nombre de la herramienta + claves de argumentos aplanadas (no valores) — el uso es auditable sin exponer el contenido de las ofertas.
Límites de tasa por nivel.
| Nivel | Límite diario | Mensual | Costo |
|---|---|---|---|
| Gratis | 5 solicitudes, de por vida | — | gratis, sin tarjeta |
| Pago por uso | basado en saldo | por créditos | $1/solicitud |
| Essentials | 50 solicitudes/día | ~1,500 | $79/mes |
| Premium | 200 solicitudes/día | ~6,000 | $149/mes |
| Enterprise | 1,000 solicitudes/día | ~30,000 | $399/mes |
Los encabezados de límite de tasa (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) se devuelven en cada respuesta. Las respuestas 429 incluyen Retry-After.
Códigos de error. Estables, documentados en dealflowpro.io/api/docs/#errors — todos los errores tienen formato JSON {success: false, error: {code, message}}. Códigos: invalid_input (400), invalid_json (400), unauthorized (401), tier_required (403), method_not_allowed (405), payload_too_large (413), rate_limit_exceeded (429), internal_error (500).
Esquemas de herramientas. Cada herramienta MCP tiene una definición de entrada estricta en esquema. Llama a tools/list contra el endpoint remoto para obtener los esquemas canónicos en tiempo de ejecución; la especificación OpenAPI REST cubre las mismas formas (las cuatro herramientas MCP se mapean 1:1 a los cuatro endpoints REST).
Patrón de evaluación. Para benchmarking, el patrón recomendado: mantén un conjunto de fixtures de pares (payload de oferta → métricas esperadas), ejecuta cada uno contra score_deal (costo más bajo, ~$0.01/llamada), verifica métricas dentro de tolerancia. El endpoint es determinista — las mismas entradas producen las mismas salidas.
Manejo de datos. Los payloads de solicitud se procesan en memoria y no se persisten en disco. TLS 1.2+ en tránsito. Las llamadas a la API de Anthropic (cuando DealFlowPro usa internamente Claude para extracción de documentos) fluyen a través del espacio de trabajo de Anthropic de DealFlowPro con retención de datos cero. Postura completa: dealflowpro.io/security#api-mcp-data-handling.
Configuración
Tienes dos rutas de instalación — elige la que coincida con tu cliente.
Ruta A — URL MCP remota (sin instalación local)
Úsala para claude.ai web (Conectores personalizados), Claude Code con transporte HTTP o Claude API mcp_servers. El endpoint es https://dealflowpro.io/mcp (HTTP Streamable, MCP 2025-06-18).
claude.ai web / Claude Desktop: DealFlowPro no está en el Directorio de Conectores de Anthropic, así que agrégalo como conector personalizado — Personalizar → Conectores → "Agregar conector personalizado" → nómbralo DealFlowPro, pega https://dealflowpro.io/mcp → Agregar → Conectar → inicia sesión en DealFlowPro → haz clic en Permitir. OAuth maneja la autenticación automáticamente (sin clave API que gestionar). Luego en un chat, haz clic en "+" → Conectores → activa DealFlowPro.
Agregar DealFlowPro a Claude → — abre el diálogo con el nombre y la URL prellenados. Aún revisas y confirmas antes de que se agregue algo.
Planes Team / Enterprise: los miembros no pueden agregar conectores personalizados por sí mismos. Un propietario de la organización lo agrega una vez en Configuración de organización → Conectores → Agregar → Personalizado (tipo: Web), y cada miembro luego conecta su propia cuenta de DealFlowPro desde Personalizar → Conectores.
Claude Code (HTTP):
claude mcp add dealflowpro \
--transport http \
--url https://dealflowpro.io/mcp \
--header "Authorization: Bearer dfp_sk_your_key_here"
Claude API:
POST https://api.anthropic.com/v1/messages
anthropic-beta: mcp-client-2025-11-20
{
"mcp_servers": [{
"type": "url",
"url": "https://dealflowpro.io/mcp",
"name": "dealflowpro",
"authorization_token": "dfp_sk_your_key_here"
}],
...
}
Obtén una clave Bearer (clave gratuita de 5 solicitudes, sin tarjeta, o créditos de pago por uso) en dealflowpro.io/api.
Detalles completos de configuración + revocación de aplicaciones conectadas: dealflowpro.io/api/docs#mcp.
Ruta B — stdio local (este paquete npm)
Úsala en cualquier lugar donde quieras que el servidor MCP se ejecute localmente en lugar de remoto — o para un cliente que no tenga una ruta de URL remota propia. Claude Desktop admite ambas: remoto vía Configuración → Conectores, o la configuración local a continuación.
1. Obtén una clave API. Visita dealflowpro.io/api para reclamar una clave gratuita de 5 solicitudes (sin tarjeta) o comprar créditos de pago por uso. Se entrega por correo electrónico.
2. Agrégalo a tu cliente.
Claude Desktop — claude_desktop_config.json:
{
"mcpServers": {
"dealflowpro": {
"command": "npx",
"args": ["-y", "dealflowpro-mcp"],
"env": {
"DFP_API_KEY": "dfp_sk_your_key_here"
}
}
}
}
Claude Code:
claude mcp add dealflowpro -e DFP_API_KEY=dfp_sk_your_key_here -- npx -y dealflowpro-mcp
Úsalo
Solo pregúntale a Claude sobre una oferta. Él elige automáticamente la herramienta correcta.
Ejemplo de salida
## Deal Analysis Results
**DFP Score: 19/100 (Poor)**
### Key Metrics
| Metric | Value |
|--------|-------|
| Cap Rate | 4.48% |
| DSCR | 0.86 |
| Cash-on-Cash | -1.95% |
| IRR | -12.17% |
| NOI | $89,524 |
### Max Offer Price
**$1,197,476** (binding constraint: cash-on-cash)
Documentación de la API
Documentación completa de la API REST en dealflowpro.io/api/docs
Precios
- Pago por uso: $1/solicitud de API, desde $5
- Essentials: 50 solicitudes de API/día incluidas ($79/mes)
- Premium: 200 solicitudes/día + calculadora inversa ($149/mes)
- Enterprise: 1,000 solicitudes/día ($399/mes)
Requisitos
- Node.js 18+
- Clave API de DealFlowPro
Acerca de DealFlowPro
DealFlowPro automatiza la suscripción multifamiliar para propiedades de 2 a 200 unidades. Sube un correo de corredor o un OM y obtén un análisis de inversión completo en 10 minutos en lugar de 2 horas. Usado por operadores, sindicadores y firmas de capital privado para evaluar ofertas más rápido.
Licencia
MIT