DealFlowPro MCP Server

Servidor MCP DealFlowPro

Analise negócios imobiliários multifamiliares a partir do Claude Code, Cursor, Claude Desktop ou qualquer cliente compatível com MCP. A primeira ferramenta de underwriting imobiliário do ecossistema MCP.

DealFlowPro é uma plataforma de análise de negócios multifamiliares com inteligência artificial. Este servidor MCP encapsula a API REST do DealFlowPro, dando aos agentes de IA acesso a cálculos de underwriting de nível institucional.

Demonstração

O Que Você Pode Fazer

Pergunte ao Claude naturalmente e ele chama a ferramenta certa:

• "Analise este negócio de 24 unidades em Charlotte — pedindo $2M, aluguel de $13,6K/mês, despesas de $5,5K"
• "Pontue este negócio: 12 unidades, $1,5M, renda mensal de $9K"
• "Qual é o máximo que devo oferecer em uma propriedade com aluguel de $28,8K/mês se quero 8% de retorno sobre o capital investido?"
• "Esta propriedade está em uma zona de inundação? 2909 Burgess Dr, Charlotte, NC"

Ferramentas

Ferramenta	Descrição
analyze_deal	Análise completa do negócio: cap rate, DSCR, retorno sobre o capital investido, TIR, pontuação DFP (0-100), preço máximo de oferta, fluxos de caixa anuais
score_deal	Triagem rápida: pontuação DFP + métricas principais
reverse_calc	Preço máximo de oferta a partir de retornos-alvo (cap rate, CoC, DSCR, TIR)
market_data	Zona de inundação, renda do bairro vs. mediana estadual, crescimento de empregos para qualquer endereço

Todas as quatro possuem anotações MCP 2025-06-18 (title, readOnlyHint, destructiveHint, idempotentHint, openWorldHint). Todas as ferramentas são somente leitura.

Instalar como plugin do Claude

Este repositório também funciona como um plugin do Claude Code / Cowork. O plugin se conecta ao servidor remoto em https://dealflowpro.io/mcp em vez do pacote npm acima, o que significa:

• Oito ferramentas em vez de quatro. Adiciona list_my_deals, get_deal_analysis, get_my_criteria e portfolio_summary — seus negócios salvos, critérios de buy-box e pipeline, limitados à sua conta.
• OAuth em vez de chave de API. Sem DFP_API_KEY para exportar; você faz login na sua conta DealFlowPro quando o plugin se conecta.

claude --plugin-dir /path/to/dealflowpro-mcp-server

Use o pacote npm abaixo se quiser um servidor stdio local, preferir autenticação por chave de API ou estiver conectando o DealFlowPro a um cliente MCP que não seja o Claude.

Para Equipes de IA Institucionais

O DealFlowPro foi criado para se encaixar em pipelines de avaliação de IA e stacks de IA de produção. O servidor MCP (este pacote, mais o endpoint remoto em https://dealflowpro.io/mcp) encapsula o mesmo mecanismo da API REST — schema estrito, idempotente, previsível.

Autenticação + escopo. Toda chamada de ferramenta exige uma chave de API Bearer. As chamadas são limitadas à conta que emitiu a chave — sem caminho de acesso entre locatários. Linhas de auditoria por ferramenta chegam ao logs/mcp_tool_calls.log da sua conta, capturando nome da ferramenta + chaves de argumentos achatadas (não valores) — o uso é auditável sem expor o conteúdo dos negócios.

Limites de taxa por nível.

Nível	Limite diário	Mensal	Custo
Gratuito	5 solicitações, vitalício	—	grátis, sem cartão
Pague conforme usar	baseado em saldo	por créditos	$1/solicitação
Essencial	50 req/dia	~1.500	$79/mês
Premium	200 req/dia	~6.000	$149/mês
Empresarial	1.000 req/dia	~30.000	$399/mês

Cabeçalhos de limite de taxa (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) retornados em cada resposta. Respostas 429 incluem Retry-After.

Códigos de erro. Estáveis, documentados em dealflowpro.io/api/docs/#errors — todos os erros têm 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).

Schemas de ferramentas. Cada ferramenta MCP tem uma definição de entrada com schema estrito. Chame tools/list no endpoint remoto para obter os schemas canônicos em tempo de execução; a especificação OpenAPI REST cobre as mesmas formas (as quatro ferramentas MCP mapeiam 1:1 para os quatro endpoints REST).

Padrão de harness de avaliação. Para benchmarking, o padrão recomendado: mantenha um conjunto de fixtures de pares (payload de negócio → métricas esperadas), execute cada um contra score_deal (menor custo, ~$0,01/chamada), verifique as métricas dentro da tolerância. O endpoint é determinístico — as mesmas entradas produzem as mesmas saídas.

Tratamento de dados. Os payloads de solicitação são processados em memória e não persistidos em disco. TLS 1.2+ em trânsito. Chamadas à API da Anthropic (quando o DealFlowPro usa internamente o Claude para extração de documentos) fluem pelo workspace Anthropic de retenção zero de dados do DealFlowPro. Postura completa: dealflowpro.io/security#api-mcp-data-handling.

Configuração

Você tem dois caminhos de instalação — escolha o que corresponde ao seu cliente.

Caminho A — URL MCP remota (sem instalação local)

Use isto para claude.ai web (Conectores Personalizados), Claude Code com transporte HTTP ou API do Claude mcp_servers. O endpoint é https://dealflowpro.io/mcp (HTTP Streamable, MCP 2025-06-18).

claude.ai web / Claude Desktop: O DealFlowPro não está no Diretório de Conectores da Anthropic, então adicione-o como um conector personalizado — Personalizar → Conectores → "Adicionar conector personalizado" → nomeie-o como DealFlowPro, cole https://dealflowpro.io/mcp → Adicionar → Conectar → faça login no DealFlowPro → clique em Permitir. O OAuth lida com a autenticação automaticamente (sem chave de API para gerenciar). Depois, em um chat, clique em "+" → Conectores → ative o DealFlowPro.

Adicionar DealFlowPro ao Claude → — abre o diálogo com o nome e a URL pré-preenchidos. Você ainda revisa e confirma antes que qualquer coisa seja adicionada.

Planos Team / Enterprise: membros não podem adicionar conectores personalizados por conta própria. Um proprietário da organização o adiciona uma vez em Configurações da organização → Conectores → Adicionar → Personalizado (tipo: Web), e cada membro então conecta sua própria conta DealFlowPro em Personalizar → Conectores.

Claude Code (HTTP):

claude mcp add dealflowpro \
  --transport http \
  --url https://dealflowpro.io/mcp \
  --header "Authorization: Bearer dfp_sk_your_key_here"

API do Claude:

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"
  }],
  ...
}

Obtenha uma chave Bearer (chave gratuita de 5 solicitações, sem cartão, ou créditos pague conforme usar) em dealflowpro.io/api.

Detalhes completos de configuração + revogação de Aplicativos Conectados: dealflowpro.io/api/docs#mcp.

Caminho B — stdio local (este pacote npm)

Use isto em qualquer lugar onde quiser que o servidor MCP rode localmente em vez de remoto — ou para um cliente que não tenha um caminho de URL remota próprio. O Claude Desktop suporta ambos: remoto via Configurações → Conectores, ou a configuração local abaixo.

1. Obtenha uma chave de API. Visite dealflowpro.io/api para obter uma chave gratuita de 5 solicitações (sem cartão) ou comprar créditos pague conforme usar. Entregue por e-mail.

2. Adicione ao seu 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

Use

Basta perguntar ao Claude sobre um negócio. Ele escolhe automaticamente a ferramenta certa.

Exemplo de Saída

## 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)

Documentação da API

Documentação completa da API REST em dealflowpro.io/api/docs

Preços

• Pague conforme usar: $1/solicitação de API, a partir de $5
• Essencial: 50 solicitações de API/dia incluídas ($79/mês)
• Premium: 200 solicitações/dia + calculadora reversa ($149/mês)
• Empresarial: 1.000 solicitações/dia ($399/mês)

Requisitos

• Node.js 18+
• Chave de API DealFlowPro

Sobre o DealFlowPro

O DealFlowPro automatiza o underwriting multifamiliar para propriedades de 2 a 200 unidades. Envie um e-mail de corretor ou OM e obtenha uma análise completa de investimento em 10 minutos em vez de 2 horas. Usado por operadores, sindicadores e empresas de private equity para triar negócios mais rápido.

dealflowpro.io

Licença

MIT