Batchdata

mcp-batchdata

BatchData MCP — BatchData の不動産データおよびスキップトレース API（batchdata.com）をラップします

Pipeworx の一部です。AI エージェントを 1875 以上の稼働中データソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、推奨、公開のいずれもしていません。

ツール

ツール	説明
batchdata_property_lookup	既知の住所を 1 件以上指定して、不動産の詳細属性（所有者、建物の特徴、評価額、売却／税金履歴）を検索します。_apiKey で BatchData API トークンを指定する必要があります。例：batchdata_property_lookup({ street: "1011 Rosegold St", city: "Franklin Square", state: "NY", zip: "11010", _apiKey: "your-token" })
batchdata_property_search	場所や属性のフィルター（例：「Phoenix, AZ」）を使って、BatchData の 1 億 5,500 万件以上の不動産データベースを検索します。skip/take によるページネーションに対応しています。一致する不動産レコードと、一致件数の合計を示すメタ件数を返します。_apiKey で BatchData API トークンを指定する必要があります。例：batchdata_property_search({ query: "Phoenix, AZ", take: 25, _apiKey: "your-token" })
batchdata_skip_trace	住所（任意で所有者名も指定）をスキップトレースし、所有者の連絡先情報（電話番号とメールアドレス）を特定します。警告：スキップトレースの結果には、DPPA／GLBA の許容される利用に関する義務が伴います。返された連絡先データを適法に使用する責任は、すべて呼び出し側にあります。_apiKey で BatchData API トークンを指定する必要があります。例：batchdata_skip_trace({ street: "1011 Rosegold St", city: "Franklin Square", state: "NY", zip: "11010", _apiKey: "your-token" })

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "batchdata": {
      "url": "https://gateway.pipeworx.io/batchdata/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/batchdata/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールとともに、共通ツールがおよそ 30 個表示されます。接続の initialize 応答には正確な範囲が記載されており、その日の状況を確認する際の確実な情報源となります。

これは意図的な仕様であり、偶然の多重化ではありません。スコープを限定した接続でも、このパックが対応していない質問に対し、カタログ全体を横断してルーティングする ask_pipeworx を使って回答できるのが、これらのメタツールの役割です。MCP サーバーを 2 つ目に追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1875 以上のデータソースに接続します。違いは、どのパックのツールが直接表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

このパックでは独自の API キー（_apiKey）を使用します。キーをこちらで用意していないため、キーなしで実行できる curl コマンドはありません。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/batchdata_property_lookup を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも必要ありません：

{
  "mcpServers": {
    "batchdata": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-batchdata"]
    }
  }
}

または、直接実行して起動を確認できます：

npx -y @pipeworx/mcp-batchdata

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは、上記のパックエンドポイントでもフルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Batchdata data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

More

• Docs and guides
• pipeworx.io

License

MIT