LocationLists

LocationLists MCP サーバー

コネクターは不要です。任意の AI アシスタントは、https://locationlists.com/find?q=<質問を平易な言葉で入力> を開くだけで、場所に関する質問に回答できます。件数、プレビュー、価格、カード決済用のチェックアウトリンクが表示されます。繰り返し利用する場合やウォレットで支払う場合は、MCP に接続してください。

リンクから回答を得る（コネクター不要）

リンクを開いてください。アカウント、キー、セットアップは不要です。該当する場所の件数、実際の行データ数件、価格、チェックアウトリンクが表示されます。

• ロサンゼルスから25マイル以内の小売店100店舗：https://locationlists.com/find?category=retail&near=Los+Angeles+CA&radius=25&total=100
• バージニア州リッチモンドの歯科医院：https://locationlists.com/find?dataset=dental-practice-list&city=Richmond&state=VA
• 郵便番号23219から車で30分以内のSTIHL販売店：https://locationlists.com/find?dataset=stihl-dealers&near=23219&drive=30

または、パラメーターを指定せず、質問自体を平易な言葉で q= に入力してください。

以下はすべて、繰り返し利用する場合やウォレットで支払う場合の説明です。

Smithery · Glama · Official MCP Registry · x402scan に掲載されています。

AI エージェント向けの事業所所在地データです。米国の事業所所在地リストを検索、サンプル確認、件数確認し、購入できます。966件のデータセットは、各ブランドの公式店舗検索またはデータを公開する公的台帳から作成されています。

市区町村、州、郵便番号、任意の場所を中心とした半径、またはファイル内の任意の列で絞り込めます。CSV 全体をカードで購入するか、エージェントが x402 を通じて Base 上の USDC で行単位の料金を支払うか、ファイル全体を購入できます。アカウントも API キーも不要です。クエリが失敗した場合や結果が空の場合、料金はかかりません。

このリポジトリには、ホスト型の LocationLists MCP サーバーのレジストリ登録情報（server.json）とクライアント設定の手順が含まれています。サーバーは locationlists.com で稼働しており、ローカルにインストールまたは実行するものはありません。

エンドポイント	https://locationlists.com/mcp
トランスポート	ストリーム可能な HTTP、ステートレス、JSON レスポンス
認証	なし
支払い	Stripe Checkout（個人向け）または x402（エージェント向け、Base 上の USDC）
レジストリ名	io.github.kylehawke-stack/locationlists
読み取り専用プロファイル	https://locationlists.com/mcp/chatgpt（検索、データセット、サンプル、件数確認のみ。チェックアウトなし）

カタログの内容

数値は、ライブの catalog.json（2026-09-16 生成）から読み取られます。

• 966件のデータセットと2件のバンドル、合計15,184,612件の米国事業所所在地（重複する区分は1回のみカウント）
• カテゴリー：朝食、機器、金融、家具、政府、グリル、ハードウェア、医療、産業、マットレス、非営利団体、その他の取引、屋外用家具、小売
• 各データセットは、公式の店舗検索、業界団体のディレクトリ、またはデータを公開する公的台帳から作成されています
• 1回限りの価格は、レコード数に応じてデータセットあたり9ドルから1,299ドルです

ツール

9つのツールはすべて /mcp 上にあります。ツールには readOnlyHint／destructiveHint／openWorldHint のアノテーションが付いています。initialize は serverInfo.name = "LocationLists" を返します。

無料ツール：

ツール	引数	機能
search_datasets	query? string、category? enum、limit? int（≤50）	ブランド、製品ライン、場所の種類、カテゴリでデータセットを検索します。スラッグ、名前、レコード数、対象範囲、ページ URL を返します。
get_dataset	slug string	完全なレコードを返します。説明付きフィールド、レコード数と州別件数、対象範囲、更新頻度、ファイルの実際の最終更新日、FAQ、サンプル URL、ページ URL が含まれます。
get_sample	slug string、rows? int（≤10）	ライブファイルから、データセット全体にわたる実際の行を最大10件、JSONとCSVテキストで返します。
count_locations	dataset string、state?、city?、county?、zip?、where? array	地理情報やその他の列（例：revenue_amt gt 2000000）のフィルターに一致する行数と、取得にかかる費用を返します。
get_quote	slugs string[]	1つ以上のデータセットの明細価格と合計金額を返します。複数の対象ブランドをより安くカバーするバンドルがあれば提示します。

カード決済（Stripe）：

ツール	引数	機能
create_checkout	slug string、email? string	1つのデータセットのStripe Checkoutセッションを開始し、決済 URL とセッション ID を返します。このツール自体で請求が発生することはありません。
check_order	sessionId string	Checkoutセッションの決済状況を返します。決済済みの場合は、恒久的なダウンロードリンクも返します。

エージェント決済（x402、Base上のUSDC）：

ツール	引数	機能
query_locations	dataset string、state?、city?、county?、zip?、where? array、order_by? object、offset? int、limit? int（≤100）	1つのデータセットから、任意の列でフィルタリング、並べ替え、ページ分割した行を返します。行単位で価格が設定され、行の生成後にのみ決済されます。レコード数が5,000件未満のデータセットは行単位では販売されません。
buy_dataset	dataset string	データセット全体を一括購入し、CSV の恒久的なダウンロードリンクを取得します。価格はカード購入時の通常価格と同じです。

エージェントはx402で決済できます

query_locations と buy_dataset は、HTTP 402決済プロトコルの x402 を使用します。Base上にUSDCを保有するエージェントは、アカウント、APIキー、チェックアウトページなしでデータを購入できます。

1. 支払いなしでツールを呼び出します。サーバーは正確な価格とx402の決済要件（Baseメインネット上のUSDC、Coinbase CDPファシリテーター経由で決済）を返します。
2. エージェントのウォレットで決済に署名し、決済情報を添えてツールを再度呼び出します。
3. サーバーは行（query_locations）または恒久的なダウンロードリンク（buy_dataset）を返します。行単位のクエリは行の生成後にのみ決済されるため、クエリが失敗した場合、費用はかかりません。

エージェントが利用できる料金ルール：

• count_locations は無料です。支払い前に、フィルターに一致する行数とその費用を確認できます。
• 行単位の価格はデータセットごとに設定され、レコード数に対する通常価格のおよそ2倍です。そのため、大きなファイルの一部だけなら数セントで済みます。料金はリクエストした limit 分だけかかります。
• 数百行を超える場合は、行を1つずつ集めるより buy_dataset のほうが安く、データセット全体を取得できます。

ウォレットを持たないクライアントは、get_quote → create_checkout → check_order の順に使用し、カードで支払えます。

クライアントの設定

Claude Code

claude mcp add --transport http locationlists https://locationlists.com/mcp

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "locationlists": {
      "url": "https://locationlists.com/mcp"
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "locationlists": {
      "type": "http",
      "url": "https://locationlists.com/mcp"
    }
  }
}

Claude.ai と ChatGPT

• Claude.ai：Settings → Connectors → Add custom connector → URL https://locationlists.com/mcp、OAuth は不要です。
• ChatGPT：Settings → Connectors（developer mode）→ https://locationlists.com/mcp/chatgpt を追加します。認証は不要です。ChatGPTではチャット内でのデジタル商品の購入が許可されていないため、ここでは読み取り専用プロファイルが使用されます。

任意の MCP クライアントを手動で操作

curl -s https://locationlists.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_datasets","arguments":{"query":"bobcat"}}}'

ツールをすばやく使う手順：search_datasets {query:"bobcat"} → get_sample {slug:"bobcat-dealers"} → count_locations {dataset:"bobcat-dealers", state:"TX"} → get_quote {slugs:["bobcat-dealers"]} → create_checkout {slug:"bobcat-dealers"} → check_order {sessionId}。

プレーンな HTTP エンドポイント（MCP クライアントは不要）

URL	内容
/llms.txt	アシスタント向けのサイト案内図（llmstxt.org）
/llms-full.txt	フィールド、件数、更新頻度、価格を含むすべてのデータセット
/catalog.json	同じカタログを JSON 形式で掲載
/data/{slug}/dataset.json	実際の最終更新日を含む、1 つのデータセットの全データ
/data/{slug}/sample.csv, /data/{slug}/sample.json	実データの 10 行分、登録不要
/data/{slug}/buy?src=<name>	該当データセットの Stripe Checkout にリダイレクト

例：bobcat-dealers/dataset.json、bobcat-dealers/sample.csv。

リンク

• サイト：https://locationlists.com
• プライバシーポリシー：https://locationlists.com/privacy
• データライセンスと利用規約：https://locationlists.com/license
• Glama：https://glama.ai/mcp/connectors/io.github.kylehawke-stack/locationlists
• お問い合わせ：[email protected]

ライセンス

このリポジトリ内のファイル（README、server.json）は MIT ライセンスで提供されています。詳細は LICENSE をご覧ください。サーバーを通じて販売されるデータセットはこのライセンスの対象外であり、https://locationlists.com/license が適用されます。