RE Data Refinery MCP Server

Un servidor de Model Context Protocol (MCP) que convierte datos inmobiliarios desordenados en inteligencia de propiedades limpia, puntuada y lista para IA para Columbus, OH y las ciudades metropolitanas circundantes.

A diferencia de las API de propiedades genéricas, RE Data Refinery combina datos en vivo de Zillow con enriquecimiento a nivel de condado (GIS, morosidad fiscal, ventas del sheriff, permisos, registros sucesorios) y calcula puntuaciones de inversión propietarias para cada listado. Los agentes pagan solo por las consultas que ejecutan, sin suscripciones ni niveles de API, mediante el protocolo de micropagos x402 en la red principal de Base.

• Fuente de datos en vivo: ZillAPI

• Cobertura: más de 150 propiedades sembradas en 14 ciudades metropolitanas de Columbus

• Pago: USDC en Base, $0.35 por consulta de pago

• Transporte: stdio / SSE para Claude Desktop, Claude Code, ChatGPT Desktop, Hermes y otros clientes MCP

Qué lo hace diferente

Herramientas (10)

Inicio rápido

1. Instalar dependencias

pip install "x402>=2.20.0" eth-account httpx

2. Clonar el repositorio

git clone https://github.com/areshms/re-refinery-mcp.git
cd re-refinery-mcp

3. Configurar tu entorno

Crea un archivo .env en la raíz del proyecto:

# Required for paid Worker lookups
EVM_PRIVATE_KEY=0x...

# Optional
X402_SPEND_CAP=$1                    # max per-payment USD cap (default: $1)
REFINERY_BASE_URL=https://re-data-refinery.ares-hms.workers.dev
REFINERY_LOCAL_URL=http://localhost:5004

Tu billetera debe tener USDC en Base para pagar las consultas.

4. Añadir a tu cliente MCP

Claude Desktop / Claude Code:

{
  "mcpServers": {
    "re_refinery_mcp": {
      "command": "python3",
      "args": ["/path/to/re-refinery-mcp/re_refinery_mcp.py"],
      "env": {
        "EVM_PRIVATE_KEY": "${EVM_PRIVATE_KEY}",
        "X402_SPEND_CAP": "$1"
      }
    }
  }
}

Modo de desarrollo local

Para desarrollar o probar sin gastar USDC, desactiva x402 y apunta a una API local gratuita:

export REFINERY_ENABLE_X402=false
export REFINERY_LOCAL_URL=http://localhost:5004
python3 re_refinery_mcp.py --transport stdio

Los endpoints de pago llaman entonces a localhost:5004 en lugar del Worker.

Cómo funcionan los pagos

1. Tu agente solicita un endpoint de pago.

2. El Worker responde con HTTP 402 Payment Required y un requisito de pago x402.

3. El cliente MCP firma una transacción USDC Permit2 en Base.

4. El facilitador CDP verifica la firma y liquida el pago en cadena.

5. El Worker devuelve los datos solicitados.

Todo esto se maneja automáticamente una vez que se configura EVM_PRIVATE_KEY.

Metodología de puntuación

Cada propiedad se enriquece con:

• flip_score (0–100): descuento vs. Zestimate, días en el mercado, mediana del vecindario, antigüedad, tamaño del lote

• wholesale_score (0–100): diferencial de capital, morosidad fiscal, DOM, ocupación por el propietario, precio vs. Zestimate

• rental_yield_pct: estimación de alquiler anual ÷ precio

• market_heat: Caliente / Templado / Frío según los días en el mercado y la tendencia reciente de precios

Las puntuaciones se recalculan contra las medianas del vecindario extraídas de la caché de live-refinery.

Requisitos

• Python 3.11+

• x402>=2.20.0

• eth-account

• httpx

• Una billetera con USDC en la red principal de Base

Worker

El Worker de Cloudflare que respalda este servidor está desplegado en:

https://re-data-refinery.ares-hms.workers.dev

Es la primera refinería de datos inmobiliarios que utiliza la pasarela de monetización x402 de Cloudflare.

Licencia

MIT

Construido por Hightower Marketing: haciendo que los datos inmobiliarios funcionen para los agentes de IA.