ListRiver

ListRiver MCP サーバー

Claude やその他の AI アシスタントが、ListRiver を通じて州の公式事業者登録簿に掲載された、新規および営業中の米国企業を検索できるようにします。州、都市、郡、ZIP、NAICS 業種、事業体の種類、設立月、電話番号またはメールアドレスの登録有無で、新しい LLC、株式会社、非営利団体を検索できます。

次のような質問ができます。

• 「過去3か月間にマイアミ・デイド郡で設立され、電話番号が登録されている企業はいくつありますか？」
• 「テキサス州ハリス郡で、新しい建設会社を20社見つけてください。」
• 「今月設立されたZIP 80202の新しい LLC を、登録代理人とともに一覧表示してください。」

ツール

ツール	内容	料金
list_states	対象となる州とそのレコード数	無料
count_businesses	州ごとに、検索条件に一致する企業の数を表示	無料
search_businesses	条件に一致する企業（デフォルトは25件、1回の呼び出しにつき最大100件。続きを取得するには cursor を使用）	返された企業1社ごとに ListRiver のレコード数に加算されます

アシスタントには、まず件数を数え、必要な数だけ企業を取得するよう指示されています。

セットアップ

1. 無料の API キーを取得します（月500レコード）：listriver.com/Account/ApiSignUp.aspx
2. uv をインストールします（サーバーを uvx で実行するため、ほかのインストールは不要です）。
3. AI アプリにサーバーを追加します。

Claude Desktop（Settings > Developer > Edit Config を選択し、Claude Desktop を再起動します）：

{
  "mcpServers": {
    "listriver": {
      "command": "uvx",
      "args": ["listriver-mcp"],
      "env": { "LISTRIVER_API_KEY": "lr_key_..." }
    }
  }
}

Claude Code：

claude mcp add listriver -e LISTRIVER_API_KEY=lr_key_... -- uvx listriver-mcp

その他の MCP クライアント： 環境変数に LISTRIVER_API_KEY を設定し、uvx listriver-mcp（stdio）を実行します。または、pip install listriver-mcp を実行してから listriver-mcp を起動します。

ソース

このフォルダー内の listriver_mcp/server.py がサーバーです（Python 製で、公式 MCP Python SDK を使用し、このリポジトリの listriver クライアントを利用しています）。テスト：tests/test_server.py。

リポジトリをクローンして実行する場合：

pip install ./python ./mcp
LISTRIVER_API_KEY=lr_key_... listriver-mcp

または、リポジトリのルートにある Dockerfile をビルドします：docker build -t listriver-mcp . を実行し、続けて docker run -i --rm -e LISTRIVER_API_KEY=lr_key_... listriver-mcp を実行します。

注意事項

• 返される企業は、返されるたびにレコード数に加算されます。同じ検索や重複する検索を行った場合も、再度加算されます。件数のカウントは無料です。
• 電話番号、メールアドレス、NAICS、郡の情報が登録されているのは一部のレコードのみで、網羅性は州によって異なります。
• データはご自身の事業目的でのみ利用できます。再販や、信用、保険、雇用、住宅に関する判断には利用できません (ListRiver API agreement)。
• 詳細：API documentation - [email protected]

MIT ライセンス。