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 Agent 的商业地点数据。搜索、抽样、计数并购买可直接使用的美国商业地点列表：966 个数据集，整理自各品牌的官方门店查询工具或发布数据的公共名录。

可按城市、州、邮编、任意地点周边半径或文件中的任意列筛选。可通过银行卡购买完整 CSV，也可让 Agent 通过 x402 使用 Base 上的 USDC 按行付款或购买整个文件，无需账户或 API 密钥。查询失败或无结果均不收费。

此仓库包含托管版 LocationLists MCP 服务的注册表条目（server.json）和客户端设置说明。服务运行于 locationlists.com；无需在本地安装或运行任何内容。

端点	https://locationlists.com/mcp
传输方式	Streamable HTTP，无状态，JSON 响应
身份验证	无
付款方式	Stripe Checkout（个人用户）或 x402，Base 上的 USDC（Agent）
注册表名称	io.github.kylehawke-stack/locationlists
只读配置	https://locationlists.com/mcp/chatgpt（仅限搜索、数据集、抽样、计数；不支持结账）

目录内容

数据取自实时 catalog.json（生成于 2026-09-16）：

• 966 个数据集和 2 个合集，共计 15,184,612 个美国商业地点（重叠部分只计一次）
• 类别：早餐、设备、金融、家具、政府、烤架、五金、医疗保健、工业、床垫、非营利组织、其他交易、户外家具、零售
• 每个数据集均整理自发布相关数据的官方查询工具、行业协会目录或公共名录
• 每个数据集按记录数量收取一次性费用，价格为 $9 至 $1,299

工具

所有 9 个工具都位于 /mcp。工具带有 readOnlyHint / destructiveHint / openWorldHint 注解。initialize 会返回 serverInfo.name = "LocationLists"。

免费工具：

工具	参数	功能
search_datasets	query? string，category? enum，limit? int（≤50）	按品牌、产品线、地点类型或类别查找数据集。返回 slug、名称、记录数、覆盖范围和页面 URL。
get_dataset	slug string	完整记录：字段及说明、记录数和州数、覆盖范围、刷新频率、文件的真实最后修改日期、常见问题、示例 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[]	返回一个或多个数据集的分项价格和总价；如果某个套餐涵盖多个所请求的品牌且价格更低，也会指出。

银行卡结账（Stripe）：

工具	参数	功能
create_checkout	slug string，email? string	为一个数据集创建 Stripe Checkout 会话，并返回付款 URL 和会话 ID。此操作本身不会扣款。
check_order	sessionId string	报告 Checkout 会话是否已付款；若已付款，则返回永久下载链接。

Agent 付款（x402，Base 上的 USDC）：

工具	参数	功能
query_locations	dataset string，state?、city?、county?、zip?、where? array，order_by? object，offset? int，limit? int（≤100）	从单个数据集中返回经过任意列筛选、排序和分页的记录。按记录计价，仅在记录生成后结算。少于 5,000 条记录的数据集不按记录出售。
buy_dataset	dataset string	直接购买整个数据集，并获得 CSV 的永久下载链接，价格与银行卡买家支付的标价相同。

Agent 可以使用 x402 付款

query_locations 和 buy_dataset 使用 x402，即 HTTP 402 付款协议。持有 Base 上 USDC 的 Agent 无需账户、API 密钥或结账页面即可购买数据：

1. 不付款调用工具。服务端会返回确切价格和 x402 付款要求（Base 主网上的 USDC，通过 Coinbase CDP facilitator 结算）。
2. 使用 Agent 的钱包签署付款，然后在再次调用工具时附上付款信息。
3. 服务端会返回记录（query_locations）或永久下载链接（buy_dataset）。按记录查询仅在记录生成后结算，因此查询失败不会产生费用。

Agent 可以依赖以下定价规则：

• count_locations 免费，可在付款前报告筛选条件匹配的记录数及其费用。
• 每条记录的价格按数据集分别设定，大致为标价除以记录数后再乘以 2，因此从大型文件中提取少量记录只需几美分。你需要为请求的 limit 付费。
• 超过几百条记录时，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	单个完整数据集，包括实际的最后修改日期
/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。