mcp-agent-brokerage-resolver について
米国の州別ライセンス登録情報から、不動産エージェントと所属ブローカーを調べる MCP サーバーです。事務所名簿や ZIP コード別のオフィス情報に加え、ライセンス状況と有効期限も取得できます。
主な機能
- 01エージェントと所属先の検索
- 02氏名やライセンス番号で一括検索
- 03ブローカーの有効エージェント数
- 04ブローカーと ZIP コード別の名簿
- 05ライセンス状況と有効期限
活用シーン
- 01所属先とライセンスの確認
- 02ブローカーの規模の比較
- 03事務所の有効エージェント一覧
- 04ZIP コード別オフィスの検索
MCP 対応
MCP クライアントに `resolve_agent_brokerage` ツールを提供します。Apify Actor を実行し、データセットの行を返します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
1掲載時のツール一覧 · 1 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| zip | string | いいえ | roster_zip モード。5 桁の郵便番号。 |
| city | string | いいえ | lookup モード:ブローカレッジオフィスの市区町村またはライセンス登録郡で名前の一致を絞り込みます。 |
| mode | enum | いいえ | lookup は 1 人または複数のエージェントを検索します。roster_firm は 1 つのブローカレッジに所属するアクティブなエージェントを一覧表示します。roster_zip は郵便番号内のブローカレッジオフィスを一覧表示します(NY、MO、OR、VT)。デフォルトは lookup です。lookup | roster_firm | roster_zip |
| zips | string | いいえ | roster_zip モードで複数を一度に指定します。1 行につき郵便番号を 1 つ入力します。 |
| state | string | いいえ | ライセンス発行州を示す 2 文字コード(例:TX)。license_number、agent_name、またはブローカレッジの各フィールドと併用します。 |
| agents | string | いいえ | lookup モードで複数を一度に指定します。1 行につき 1 件:state | name | brokerage(任意)| city(任意)。 |
| licenses | string | いいえ | lookup モードで複数を一度に指定します。1 行につき 1 件:state に続けてライセンス番号を入力します(例:TX 0123456)。 |
| agent_name | string | いいえ | lookup モードでライセンス番号がない場合に使用します。名と姓を指定します。よくある名前を絞り込むには、brokerage_name または city を追加します。 |
| active_only | enum | いいえ | Roster モードで使用します。ライセンスが有効なエージェントのみを一覧表示します。デフォルトは true です。true | false |
| max_results | string | いいえ | Roster モードで使用します。1 つのブローカレッジまたは郵便番号の検索で返す最大行数は 1~1000 です。デフォルトは 100 です。 |
| brokerage_name | string | いいえ | lookup モード:名前の一致を絞り込みます。roster_firm モード:一覧表示するブローカレッジを、登録されている正式名称で指定します。 |
| include_agents | enum | いいえ | roster_zip モード。true の場合、各オフィスのアクティブなエージェントも一覧表示します。デフォルトは false です。true | false |
| license_number | string | いいえ | lookup モード。州の登録簿に記載されたエージェントのライセンス番号(例:134224-SA)。最も信頼性の高い検索方法です。 |
| max_charge_usd | string | いいえ | 任意。実行料金がこの金額を超える場合、超過の原因となる行の処理前に停止します。 |
| brokerage_license_number | string | いいえ | roster_firm モード。仲介会社のライセンス番号。 |
詳細
エージェントから証券会社への照合 MCP サーバー
Apify 上の Mamba Labs Agent to Brokerage Resolver アクター用 MCP サーバーです。ライセンス番号、または氏名と州を指定して、米国でライセンスを取得した不動産エージェントを検索できます。州の公式ライセンス登録簿から登録先の証券会社を取得し、その証券会社の有効なエージェント数と規模区分、さらにエージェントのライセンス状況と有効期限も確認できます。証券会社に所属する有効なエージェント全員、または郵便番号に該当する証券会社の事務所すべてを一覧表示することもできます。
内容
できること
州の公式ライセンス登録簿で、米国でライセンスを取得した不動産エージェントを検索し、登録先の証券会社、その証券会社の有効なエージェント数と規模区分(1、2-15、16-50、51+)、エージェントのライセンス状況と有効期限を取得します。19 州に対応しており、証券会社のデータは CA、IA、MO、NV、NY、OH、OR、TX、VT で利用できます。モードは 3 種類です。lookup(ライセンス番号または氏名による 1 名または複数名の検索)、roster_firm(1 社の証券会社に所属する有効なエージェントの一覧)、roster_zip(郵便番号に該当する証券会社の事務所一覧。NY、MO、OR、VT)。メールアドレス、電話番号、自宅住所は返しません。入力内容が曖昧な場合や一致するものがない場合は、理由を説明する row_status を含む無料の行を返します。実行が成功しなかった場合は、実行 ID とともにエラーとして返します。
すべての処理は Apify 上で実行されます。このパッケージは、アクターの実行を開始して完了を待ち、データセットの行を返す薄いクライアントです。
クイックスタート
Node.js 18 以降と、API トークンを設定した Apify アカウントが必要です。
Claude Desktop の設定(claude_desktop_config.json)、Cursor、または任意の MCP クライアントに次の内容を追加します。
{
"mcpServers": {
"mamba-agent-brokerage-resolver": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-agent-brokerage-resolver"
],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}
クライアントを再起動します。resolve_agent_brokerage ツールが表示されます。
前提条件
- Node.js 18 以降。
- console.apify.com/account/integrations から取得した Apify API トークンを
APIFY_TOKENとして設定します。サーバーはトークンがなくてもツールを一覧表示しますが、ツールを呼び出すにはトークンが必要です。
プロンプトの例
- 「テキサス州のライセンス番号 134224-SA のエージェントが所属する仲介会社と、その規模を教えてください。」
- 「テキサス州のライセンス番号 566433-BB の仲介会社に所属する現役エージェントを一覧表示してください。」
- 「郵便番号 14201 にオフィスがある不動産仲介会社と、それぞれのエージェント数を教えてください。」
ツール
resolve_agent_brokerage。ツールは 1 つです。引数の例:
{ "mode": "lookup", "state": "TX", "license_number": "134224-SA" }
入力
| 入力 | 型 | 必須 | 説明 |
|---|---|---|---|
mode | string | いいえ | lookup、roster_firm、または roster_zip。デフォルトは lookup です。 |
state | string | いいえ | ライセンス登録州を表す 2 文字の略称。例:TX。 |
license_number | string | いいえ | lookup モード用。登録簿に記載されているエージェントのライセンス番号です。 |
agent_name | string | いいえ | ライセンス番号がない場合の lookup モード用。名と姓です。 |
brokerage_name | string | いいえ | 名前の一致候補を絞り込みます。roster_firm モードでは会社名を指定します。 |
city | string | いいえ | オフィスの市区町村またはライセンス上の郡で名前の一致候補を絞り込みます。 |
licenses | string | いいえ | lookup の一括処理用。1 行につき 1 件:州、ライセンス番号の順です。 |
agents | string | いいえ | lookup の一括処理用。1 行につき 1 件:州、名前、仲介会社、市区町村を縦棒で区切って指定します。 |
brokerage_license_number | string | いいえ | roster_firm モード用。仲介会社のライセンス番号です。 |
zip | string | いいえ | roster_zip モード用。5 桁の郵便番号です。 |
zips | string | いいえ | roster_zip の一括処理用。1 行につき 1 つの郵便番号を指定します。 |
include_agents | string | いいえ | roster_zip モード用。true にすると、各オフィスの現役エージェントも一覧表示します。 |
active_only | string | いいえ | 名簿モード用。有効なライセンスのみを対象にします。デフォルトは true です。 |
max_results | string | いいえ | 名簿モード用。仲介会社または郵便番号あたりの行数。1~1000。デフォルトは 100 です。 |
max_charge_usd | string | いいえ | 任意。請求額がこの金額を超える行の処理前に実行を停止します。 |
料金
Apify ではイベントごとに課金され、料金は Apify アカウントに請求されます。価格は米ドルです。
| イベント | 無料プラン | Bronze | Silver | Gold |
|---|---|---|---|---|
agent-resolved、一致した検索行ごと | $0.005 | $0.00475 | $0.0045 | $0.00425 |
roster-row、名簿の行ごと | $0.002 | $0.0019 | $0.0018 | $0.0017 |
apify-actor-start、実行開始ごと | $0.0005 | $0.000475 | $0.00045 | $0.000425 |
一致候補が曖昧な行、見つからない行、未対応の州の行、上限に達した行には課金されません。
キーについて
このアクターにプロバイダーキーは必要ありません。Mamba Labs のサービスを通じて、MMG が独自に管理する州のライセンス登録簿のインデックスを参照し、キーを保持しません。各アクターの実行では、その実行専用の Apify 実行トークンをサービスに送信します。サービスはリクエストごとに Apify API から実行情報を取得し、このアクターの実行が現在有効であることを確認します。サービスは結果をキャッシュせず、トークンを保存またはログに記録することもありません。
アクターのドキュメント全文
apify.com/mambalabs/agent-brokerage-resolver
ライセンス
MIT。LICENSE を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。