DFX Real Estate Intelligence

DFX Real Estate Intelligence: Servidor MCP

A DFX responde perguntas com data sobre duas coisas: dívida imobiliária comercial e de programas federais dos Estados Unidos, onde os vencimentos de empréstimos são publicados em 52 códigos estaduais e os vencimentos de subsídios e conformidade em 54 e 56, e propriedades em Massachusetts, onde 269.984 lotes carregam propriedade, valor avaliado e 80.448 instrumentos de venda registrados. Use-o quando um agente precisar saber quem é o dono de um edifício específico, por quanto ele foi vendido pela última vez, ou quais empréstimos e subsídios vencem em um determinado estado e janela de tempo, com a fonte e a data de observação anexadas a cada afirmação.

A cobertura é deliberadamente desigual e é declarada antecipadamente, em vez de descoberta por tentativa e erro. O cronograma de dívidas, subsídios e conformidade é nacional. Inadimplência e execução hipotecária são multiestaduais e escassas. Lotes, propriedade e vendas registradas são apenas em Massachusetts. Licenças de construção são apenas em Boston. Os números medidos por tipo e por estado estão em Cobertura de eventos, medida abaixo, e dfx_coverage retorna a mesma grade no momento da chamada, para que um agente nunca precise adivinhar a partir de um resultado vazio.

Endpoint: https://exchange-production-9123.up.railway.app/mcp Transporte: HTTP Streamable Autenticação: nenhuma, para tudo, exceto uma ferramenta paga Registro: io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt

Nove ferramentas. Oito são gratuitas, não autenticadas e permanentes: sem chave, sem cadastro, sem OAuth. Uma custa US$ 1,00 por conjunto de resultados entregue e avisa antes de cobrar qualquer coisa.

A cobertura é desigual de propósito e as lacunas estão impressas abaixo, em vez de escondidas. Uma ferramenta que responde "não" claramente vale mais para um agente do que uma que responde com uma lista vazia, então este servidor recusa argumentos desconhecidos com o vocabulário servido anexado e se recusa a vender um conjunto de resultados que chegaria vazio.

---

Leia os esquemas antes de chamar qualquer coisa

Um GET simples no endpoint retorna a lista completa de ferramentas, os números de cobertura, o preço e um exemplo prático. Sem handshake, sem sessão, sem initialize.

curl -s https://exchange-production-9123.up.railway.app/mcp

Em seguida, chame uma ferramenta via JSON-RPC:

curl -s https://exchange-production-9123.up.railway.app/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":
       {"name":"resolve_address","arguments":
        {"address":"100 Binney St","city":"Cambridge","state":"MA"}}}'

Esse endereço retorna um lote com uma venda registrada de US$ 1.020.000.000, com o livro e a página do registro sob os quais foi registrada.

---

As nove ferramentas

Ferramenta	Recebe	Retorna	Preço
what_can_dfx_answer	um objetivo, em linguagem natural	se a DFX pode ajudar, qual ferramenta chamar, os argumentos e uma amostra gratuita	grátis
dfx_coverage	nada	cobertura medida, fontes servidas, tipos de objetos, lacunas conhecidas	grátis
resolve_address	endereço, cidade?, estado?	IDs canônicos da DFX com a base da correspondência e qualquer ambiguidade	grátis
resolve_organization	nome	IDs de entidades para proprietários, gestores, credores, servicers	grátis
get_property_record	um ID da DFX	estado, eventos datados, relacionamentos, dívidas com datas de vencimento, vendas registradas, proveniência	grátis
search_parcels	filtros	lotes por atributo, em vez de um endereço que você já conhecia	grátis
search_property_events	event_type?, state?, within_days?	eventos datados com proveniência	grátis
changes_since	um cursor opaco	o que a DFX aprendeu desde o seu cursor	grátis
debt_maturity_schedule	estado, within_days?, limit?	a fita de empréstimos: principal, credor, instrumento, vencimento, propriedade garantida	US$ 1,00

Comece com what_can_dfx_answer se você não souber o que pedir. Ela diz não claramente quando a resposta é não e registra a pergunta, para que perguntas que a DFX não consegue responder moldem o que será construído em seguida.

---

O que realmente está aqui

Duas populações que quase não se sobrepõem, e confundi-las é a maneira mais comum de interpretar mal este servidor.

Objeto	Geografia	O que é
property	Nacional	Multifamiliar de programa federal: HUD, LIHTC e FHA. 90.278 resolvíveis.
parcel	Apenas em Massachusetts	A camada do avaliador municipal e do registro, com valor avaliado, uso do solo e vendas registradas. 269.984 resolvíveis.
organization	Nacional	Proprietários, gestores, credores e servicers.

Um endereço pode retornar um, o outro ou ambos.

Vendas registradas são apenas em Massachusetts: 80.448 instrumentos em 89.191 vínculos de lotes. Uma escritura repete sua consideração total em cada lote que cobre, então allocated_consideration é carregado separadamente de consideration, e allocation_basis informa quando uma divisão é nossa, em vez do registro.

Cobertura de eventos, medida

62.524 eventos publicáveis em 16 tipos e 13 fontes.

Tipo de evento	Estados	Publicados
PROPERTY_SOLD	1	30.055
COMPLIANCE_PERIOD_ENDING	56	13.549
SUBSIDY_CONTRACT_EXPIRING	54	4.721
PERMIT_ISSUED	1	4.203
LOAN_MATURITY_SCHEDULED	52	3.717
CERTIFICATE_OF_OCCUPANCY	1	2.768
LEASE_EXPIRING	49	1.432
DEMOLITION_FILED	1	881
USE_CONVERSION_PERMITTED	1	849
DISTRESS_FLAG_RAISED	26	188
FORECLOSURE_EVENT	22	142
LOAN_MODIFIED	5	12
BANKRUPTCY_EVENT	4	4
COMPANY_CONTRACTED	1	1
LEASE_TERM_REVISED	1	1
PERMIT_STATUS_CHANGED	0	1

PROPERTY_SOLD, PERMIT_ISSUED, CERTIFICATE_OF_OCCUPANCY, DEMOLITION_FILED e USE_CONVERSION_PERMITTED são de Massachusetts. COMPLIANCE_PERIOD_ENDING, SUBSIDY_CONTRACT_EXPIRING e LOAN_MATURITY_SCHEDULED são nacionais.

---

A única ferramenta paga: debt_maturity_schedule, US$ 1,00

Tudo acima é gratuito e permanece gratuito. Esta é precificada, e o preço está impresso na descrição da ferramenta, na ferramenta _meta e na cotação. Você nunca é solicitado a negociar, não há ligação de vendas e não há campo pelo qual um chamador possa propor um preço: o valor é lido da cotação, no lado do servidor.

O que você recebe. Para um estado dos EUA e uma janela futura, até 200 empréstimos, uma linha por empréstimo, ordenados por data de vencimento:

• maturity_date e maturity_basis
• original_principal_usd, origination_date, term_months
• instrument_type
• o nome canônico do credor e o ID da DFX quando resolvido
• a propriedade garantida: ID da DFX, endereço, cidade, estado, CEP, número de unidades, tipo de propriedade
• o source_key para essa linha

Por que pode valer um dólar. 19.881 empréstimos têm data de vencimento e 19.881 de 19.881 carregam maturity_basis = 'confirmed'. Nenhum é estimado, inferido a partir de um prazo ou transportado de uma leitura desatualizada. Cada data foi arquivada na SEC por um servicer de empréstimos ou registrada pela HUD e, em seguida, resolvida para um edifício específico.

A ferramenta gratuita search_property_events retorna o evento: uma data, um título, um endereço. A paga retorna o empréstimo: o principal, o credor, o instrumento, deduplicado em uma linha por empréstimo, até 200 linhas em vez de 50, com a população declarada para que você possa distinguir uma resposta completa de uma truncada.

Quantas linhas seu dólar realmente compra. Dos 19.881 empréstimos, 1.614 vencem dentro da janela padrão de dezoito meses, e eles não estão distribuídos uniformemente. Medido em 2026-09-01:

Estado	Empréstimos vencendo nos próximos 548 dias
CA	329
NY	193
TX	117
FL	97
OH	61
GA	58
IL	56
NJ	53
PA	52
MI	50
NV	43
IN	40
VA	38
NC	34
WA	31
CO	26
AZ	24
LA	24
AL	20
MD	20
SC	20

Vinte e oito outros estados têm entre 1 e 19 empréstimos nessa janela. Montana e Wyoming têm um cada. Alargue within_days para alcançar mais longe; o preço não muda com o número de linhas ou a janela.

Peça um estado e uma janela sobre os quais você não tem certeza com o search_property_events gratuito primeiro: ele retorna os eventos de vencimento para o mesmo filtro sem custo, para que você possa ver se o mercado está lá antes de gastar qualquer coisa.

O que não cobre, declarado claramente. Apenas CMBS de rótulo privado e multifamiliar segurado pela FHA. Empréstimos bancários de balanço, multifamiliar de agência e empréstimos apenas de registro municipal estão ausentes. Um edifício financiado convencionalmente pode carregar dívidas que este cronograma nunca mostrará. Uma propriedade ausente de uma busca de vencimento não é uma propriedade sem dívida. Um empréstimo garantido por vários edifícios não tem uma única âncora de propriedade e, portanto, não é alcançável por um filtro de estado; esses são alcançados através do get_property_record gratuito.

Como o pagamento funciona

Duas idas e voltas, de propósito.

1. call debt_maturity_schedule WITHOUT `authorize`
   -> PAYMENT_REQUIRED. The price, the quote id, what arrives, how many rows
      your filter holds, the known limits, and the free alternative.
      Nothing is charged for a quote.

2. call it again WITH `authorize: {quote_id, max_price_usd}` and your account
   key in the X-DFX-Account header
   -> charged once, and served in the same response, with a receipt.

max_price_usd é seu teto e é verificado antes do nosso. Se o preço algum dia subir acima dele, você é recusado em vez de cobrado. Ele pode reduzir o que você paga e nunca pode aumentá-lo.

Uma cotação é liquidada exatamente uma vez: repetir uma chamada autorizada retorna ALREADY_SETTLED em vez de cobrar duas vezes. Se a entrega falhar após o débito, a liquidação é revertida integralmente na mesma solicitação e seu saldo é restaurado. Você nunca é cobrado por um resultado que não recebeu.

A conta é um saldo financiado, não um cartão no caminho da solicitação. Uma pessoa o financia uma vez; seu agente então gasta dentro dele com tetos por chamada, diários e de conta, sem nenhuma etapa humana adicional. Um agente que detém um instrumento de pagamento pode criar uma obrigação; um agente que detém um saldo não pode.

Status atual, declarado honestamente: o autofinanciamento ainda não está aberto. Se você quiser uma conta, abra uma issue neste repositório ou escreva para jesse@uemembers.com. Toda ferramenta gratuita funciona agora, sem conta e sem chave.

---

Conecte-o

Qualquer cliente MCP que fale HTTP Streamable. Sem credenciais.

{
  "mcpServers": {
    "dfx-real-estate": {
      "type": "http",
      "url": "https://exchange-production-9123.up.railway.app/mcp"
    }
  }
}

Claude Code:

claude mcp add --transport http dfx-real-estate \
  https://exchange-production-9123.up.railway.app/mcp

Tanto a revisão atual do protocolo quanto o handshake mais antigo initialize são servidos, porque a maioria dos clientes implantados ainda envia o último.

---

Perguntas para as quais este servidor é bom

• Quais hipotecas comerciais neste estado vencem nos próximos dezoito meses, quem emprestou e contra qual edifício?
• O que a DFX aprendeu desde a última vez que perguntei? (changes_since, baseado em cursor, ordenado por quando a DFX passou a saber um fato, em vez de quando o fato ocorreu.)
• Quais períodos de conformidade do LIHTC e contratos de subsídio da HUD estão expirando e onde?
• Por quanto este lote de Massachusetts foi vendido pela última vez, para quem e sob qual livro e página?
• Quem é dono, gerencia ou empresta contra este edifício?

Perguntas para as quais não é bom e dirá isso

• Qualquer coisa sobre uma pessoa. A busca de pessoas é deliberadamente não oferecida.
• Dados de lotes, avaliadores ou vendas registradas fora de Massachusetts.
• Dívidas sobre propriedades financiadas convencionalmente.
• Qualquer coisa fora dos Estados Unidos.

---

Notas de design que um desenvolvedor de agentes pode considerar

• changes_since é ordenado por quando a DFX aprendeu um fato, não quando o fato ocorreu. Uma escritura assinada em março é registrada em agosto. Consultar um filtro de data mostraria as mesmas linhas para sempre.
• Um event_type não reconhecido é recusado com o vocabulário servido anexado, nunca respondido com uma lista vazia, porque uma lista vazia parece um mercado ausente.
• Um nome é uma chave de bloqueio, nunca uma identidade. resolve_organization retorna todos os candidatos em vez de adivinhar um.
• Cada fato retornado carrega sua proveniência: a fonte, a classe de evidência e, para vendas, o livro e a página do registro.
• A cobertura é uma ferramenta, não uma nota de rodapé. Chame dfx_coverage antes de concluir que um resultado vazio significa um mercado ausente.

Termos

O código de exemplo em examples/ é licenciado sob MIT. Os dados servidos pelo endpoint não são: eles são derivados de fontes federais e municipais públicas sob o próprio processamento da DFX e são servidos para uso, não para redistribuição como um conjunto de dados. Pergunte se quiser algo mais amplo; a resposta geralmente é sim.

Operado pela DFX Intelligence. Referência do desenvolvedor: https://dfxintel.com/ai/real-estate-mcp