RE Data Refinery

RE Data Refinery MCP Server

AI エージェントが、オハイオ州の主要5都市（Columbus、Cincinnati、Toledo、Dayton、Cleveland）におけるスコア付き不動産投資データにリアルタイムでアクセスできる MCP（Model Context Protocol）サーバーです。物件情報、転売・卸売スコア、賃貸利回り、差し押さえオークション、税金滞納物件の競売情報を利用できます。エージェントは MCP ツールを通じてデータを検索し、x402 のマイクロペイメント（Base メインネット上の USDC）で検索ごとに料金を支払います。

機能

このサーバーは、あらゆる AI エージェント（Claude、Cursor、Hermes など）が利用できる13個の MCP ツールを提供します。

• 物件情報を検索 — 転売スコア、卸売スコア、賃貸利回り率、市場の過熱度評価、近隣地域との比較情報を含む、スコア付きのオハイオ州の1,040件以上の物件を検索します。都市、郵便番号、価格帯、スコアのしきい値、物件種別で絞り込めます
• 物件の詳細を取得 — ZPID で物件の全記録を取得します。価格履歴、税金・評価額の履歴、学校の評価が含まれます
• 差し押さえオークションを検索 — Franklin County の差し押さえ物件192件の情報を検索します。オークション日、住所、売却状況、区画面積が含まれます（PropertyOnion から取得し、毎日更新）
• 税金滞納物件のオークションを検索 — 同じ構成の Franklin County の税金滞納物件161件の情報を検索します
• オークション情報をまとめて検索 — 353件すべてのオークション情報を1回の呼び出しで取得できます。都市、郵便番号、状況、種別で絞り込めます

有料の検索にはすべて x402 プロトコル を使用します。エージェントは Base メインネット上で USDC のマイクロペイメント（クエリごとに $0.15～$0.50）を送信し、応答としてデータを受け取ります。サブスクリプションも API キーも不要です。暗号資産で検索ごとに支払うだけです。

データソース

ソース	データ	対象範囲
ZillAPI	物件情報、スコア、価格・税金・学校の履歴	Columbus、Cincinnati、Toledo、Dayton、Cleveland にあるスコア付き物件1,040件
PropertyOnion	差し押さえ＋税金滞納物件のオークション情報	Franklin County の物件353件（毎日更新）
Franklin County GIS	税金滞納、許可、用途地域	拡充データレイヤー（継続中）

都市別の物件数

都市	スコア付き物件数
Columbus	184
Cincinnati	200
Toledo	200
Dayton	200
Cleveland	256
合計	1,040

ツール

ツール	説明
refinery_health	API の状態＋キャッシュ済み物件数（無料）
refinery_cache_stats	キャッシュの鮮度＋都市・近隣地域の数（無料）
refinery_credits	ZillAPI のクレジット残高（無料）
refinery_payment_status	x402 の支払い設定状況（無料）
refinery_search_properties	スコア付き物件の検索結果（複数都市）。1回あたり $0.50
refinery_list_properties	転売・卸売・賃貸スコア付きのキャッシュ済み物件一覧。1回あたり $0.35
refinery_get_property	ZPID による物件の詳細情報。1回あたり $0.35
refinery_get_price_history	物件の価格履歴。1回あたり $0.25
refinery_get_tax_history	物件の税金・評価額の履歴。1回あたり $0.25
refinery_get_schools	物件近くの学校の評価。1回あたり $0.25
refinery_search_foreclosures	差し押さえオークション情報192件。1回あたり $0.15
refinery_search_tax_sales	税金滞納物件のオークション情報161件。1回あたり $0.15
refinery_search_auctions	オークション情報353件すべてをまとめて検索。1回あたり $0.25

セットアップ

cd ~/projects/re-refinery/mcp-server
uv sync

環境変数

このディレクトリに .env を作成します。

# Optional: override the worker or local API URLs
REFINERY_BASE_URL=https://re-data-refinery.ares-hms.workers.dev
REFINERY_LOCAL_URL=http://localhost:5004

# Required for paid x402 endpoints
EVM_PRIVATE_KEY=0x...

# Optional x402 spend cap (default $1 per payment)
X402_SPEND_CAP=$1

# Set to false to disable payments and use the free local API
REFINERY_ENABLE_X402=true

実行

# stdio transport (default; for Claude Desktop, Hermes, etc.)
uv run python re_refinery_mcp.py

# SSE transport
uv run python re_refinery_mcp.py --transport sse

MCP の設定

MCP クライアントの設定（Claude Desktop の claude_desktop_config.json、Cursor など）に追加します。

{
  "mcpServers": {
    "re-refinery-mcp": {
      "command": "uv",
      "args": ["run", "python", "re_refinery_mcp.py"],
      "cwd": "/path/to/re-refinery-mcp"
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "re-refinery-mcp": {
      "command": "uv",
      "args": ["run", "python", "re_refinery_mcp.py"],
      "cwd": "/path/to/re-refinery-mcp",
      "env": {
        "REFINERY_BASE_URL": "https://re-data-refinery.ares-hms.workers.dev",
        "REFINERY_ENABLE_X402": "true",
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

MCP Inspector でテストする

npx @modelcontextprotocol/inspector \
  uv run python /Users/ares.hmsgmail.com/projects/re-refinery/mcp-server/re_refinery_mcp.py

Hermes の設定

~/.hermes/config.yaml の mcp_servers: の下に追加します。

re_refinery:
  enabled: true
  command: /Users/ares.hmsgmail.com/projects/re-refinery/mcp-server/.venv/bin/python
  args:
    - /Users/ares.hmsgmail.com/projects/re-refinery/mcp-server/re_refinery_mcp.py
  timeout: 120

メモ

• サーバーは読み取り専用です。プロパティを作成または変更するツールはありません。
• すべての有料ツールは、機械可読な出力を得るための response_format: "json" をサポートしています。
• EVM_PRIVATE_KEY が設定されておらず、x402 が有効な場合でも、サーバーは起動しますが、有料の呼び出しは明確な 402 エラーメッセージを返します。