RE Data Refinery MCP Server

Сервер Model Context Protocol (MCP), который превращает неструктурированные данные о недвижимости в чистую, оцененную, готовую для ИИ аналитику недвижимости для Колумбуса, штат Огайо, и прилегающих городов агломерации.

В отличие от универсальных API недвижимости, RE Data Refinery объединяет живые данные Zillow с обогащением на уровне округа (GIS, налоговая задолженность, продажи шерифа, разрешения, наследственные дела) и вычисляет собственные инвестиционные баллы для каждого объявления. Агенты платят только за выполненные запросы — без подписок, без тарифных уровней API — через протокол микроплатежей x402 в основной сети Base.

• Живой источник данных: ZillAPI

• Покрытие: 150+ объектов, размещенных в 14 городах агломерации Колумбуса

• Оплата: USDC на Base, $0.35 за платный запрос

• Транспорт: stdio / SSE для Claude Desktop, Claude Code, ChatGPT Desktop, Hermes и других MCP-клиентов

Что делает его особенным

Инструменты (10)

Быстрый старт

1. Установите зависимости

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

2. Клонируйте репозиторий

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

3. Настройте окружение

Создайте файл .env в корне проекта:

# 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

Ваш кошелек должен содержать USDC на Base для оплаты запросов.

4. Добавьте в ваш 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"
      }
    }
  }
}

Режим локальной разработки

Для разработки или тестирования без траты USDC отключите x402 и укажите бесплатный локальный API:

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

Платные конечные точки будут вызывать localhost:5004 вместо Worker.

Как работают платежи

1. Ваш агент запрашивает платную конечную точку.

2. Worker отвечает HTTP 402 Payment Required с требованием оплаты x402.

3. MCP-клиент подписывает транзакцию Permit2 USDC на Base.

4. CDP facilitator проверяет подпись и проводит оплату в сети.

5. Worker возвращает запрошенные данные.

Все это обрабатывается автоматически после настройки EVM_PRIVATE_KEY.

Методология оценки

Каждый объект обогащается:

• flip_score (0–100): скидка относительно Zestimate, дни на рынке, медиана по району, возраст, размер участка

• wholesale_score (0–100): разница в капитале, налоговая задолженность, DOM, доля собственников-резидентов, цена относительно Zestimate

• rental_yield_pct: годовая оценка аренды ÷ цена

• market_heat: Hot / Warm / Cool на основе дней на рынке и недавнего тренда цен

Баллы пересчитываются относительно медиан по районам из кэша live-refinery.

Требования

• Python 3.11+

• x402>=2.20.0

• eth-account

• httpx

• Кошелек с USDC в основной сети Base

Worker

Cloudflare Worker, поддерживающий этот сервер, развернут по адресу:

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

Это первый сервис очистки данных о недвижимости, использующий монетизационный шлюз x402 от Cloudflare.

Лицензия

MIT

Создано Hightower Marketing — делаем данные о недвижимости полезными для ИИ-агентов.