LocationLists

Servidor MCP de LocationLists

Conjuntos de datos CSV listos para usar de ubicaciones de negocios en EE. UU. — redes de distribuidores, contratistas licenciados, cadenas minoristas y de restaurantes — busca, previsualiza filas reales y compra en el chat.

Este repositorio contiene el listado del registro (server.json) y notas de configuración del cliente para el servidor MCP alojado LocationLists. El servidor en sí se ejecuta en locationlists.com; no hay nada que instalar o ejecutar localmente.

Endpoint	https://locationlists.com/mcp
Transporte	HTTP sin estado, respuestas JSON
Autenticación	Ninguna
Nombre del registro	io.github.kylehawke-stack/locationlists
Perfil de solo lectura	https://locationlists.com/mcp/chatgpt (solo búsqueda, conjunto de datos y muestra — sin precios ni pago)

Qué hay en el catálogo

Las cifras se leen del catalog.json en vivo (generado el 2026-09-11):

• 725 conjuntos de datos más 1 paquete, 14,248,853 ubicaciones de negocios en EE. UU. en total
• Categorías: Salud, Minorista, Industrial, Organizaciones sin fines de lucro, Equipos, Muebles, Desayuno, Ferretería, Parrillas, Colchones, Muebles de exterior
• Cada conjunto de datos se compila a partir del localizador oficial, directorio de asociaciones o registro de licencias estatal que lo publica
• Los precios son de pago único, de $9 a $199 por conjunto de datos según el número de registros; la entrega es un enlace de descarga por correo electrónico después del pago con Stripe

Herramientas

Herramientas principales (disponibles en /mcp; las tres primeras también están en /mcp/chatgpt):

Herramienta	Argumentos	Qué hace
search_datasets	query? cadena, category? enumeración, limit? entero (1–50, predeterminado 15)	Encuentra conjuntos de datos por marca, línea de productos, tipo de ubicación o categoría. Devuelve slug, nombre, número de registros, cobertura y URL de la página. Solo lectura.
get_dataset	slug cadena	Registro completo: campos con descripciones, recuentos de registros y estados, cobertura, cadencia de actualización, la fecha real de última modificación del archivo, preguntas frecuentes, URL de muestra y URL de la página.
get_sample	slug cadena, rows? entero (≤10)	Hasta 10 filas reales del archivo en vivo, distribuidas en todo el conjunto de datos, como JSON más texto CSV.
get_quote	slugs cadena[]	Precios por artículo y total para uno o más conjuntos de datos; señala un paquete si cubre varias marcas solicitadas por menos.
create_checkout	slug cadena, email? cadena	Abre una sesión de Stripe Checkout para un conjunto de datos y devuelve la URL de pago y el ID de sesión. No cobra nada por sí mismo.
check_order	sessionId cadena	Informa si una sesión de Checkout está pagada y, si es así, devuelve el enlace de descarga permanente.

Herramientas de pago para agentes (x402, USDC en Base) para agentes que tienen una billetera:

Herramienta	Argumentos	Qué hace
query_locations	dataset cadena, state?, city?, county?, zip?, limit? entero (≤100)	Filas de un conjunto de datos filtradas por valores exactos de columna, con precio por fila y liquidación solo después de que se produzcan las filas. Llama primero sin encabezado de pago para obtener una cotización. Los conjuntos de datos con menos de 5,000 registros no se venden por fila.
buy_dataset	dataset cadena	Compra un conjunto de datos completo directamente y obtén el enlace de descarga permanente, al mismo precio de lista que paga un comprador con tarjeta.

Las herramientas llevan anotaciones readOnlyHint / destructiveHint. initialize devuelve serverInfo.name = "LocationLists".

Configuración del cliente

Claude Code

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

Cursor / VS Code (mcp.json)

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

VS Code usa la clave servers en lugar de mcpServers en .vscode/mcp.json; la entrada es por lo demás la misma.

Claude.ai y ChatGPT

• Claude.ai: Configuración → Conectores → Agregar conector personalizado → URL https://locationlists.com/mcp, sin OAuth.
• ChatGPT: Configuración → Conectores (modo desarrollador) → agregar https://locationlists.com/mcp/chatgpt, sin autenticación. El perfil de solo lectura se usa allí porque la compra de bienes digitales en el chat no está permitida en ChatGPT.

Cualquier cliente MCP, manualmente

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"}}}'

Un camino rápido a través de las herramientas: search_datasets {query:"bobcat"} → get_sample {slug:"bobcat-dealers"} → get_quote {slugs:["bobcat-dealers"]} → create_checkout {slug:"bobcat-dealers"} → check_order {sessionId}.

Endpoints HTTP simples (sin necesidad de cliente MCP)

URL	Qué
/llms.txt	Mapa curado del sitio para asistentes (llmstxt.org)
/llms-full.txt	Cada conjunto de datos con campos, recuentos, actualización y precio
/catalog.json	El mismo catálogo como JSON
/data/{slug}/dataset.json	Un conjunto de datos completo, incluida la fecha real de última modificación
/data/{slug}/sample.csv, /data/{slug}/sample.json	10 filas reales, sin registro
/data/{slug}/buy?src=<name>	Redirige a Stripe Checkout para ese conjunto de datos

Ejemplo: bobcat-dealers/dataset.json, bobcat-dealers/sample.csv.

Enlaces

• Sitio: https://locationlists.com
• Política de privacidad: https://locationlists.com/privacy
• Licencia de datos y términos: https://locationlists.com/license
• Contacto: kyle@locationlists.com

Licencia

Los archivos en este repositorio (README, server.json) tienen licencia MIT — consulta LICENSE. Los conjuntos de datos vendidos a través del servidor no están cubiertos por esa licencia; se rigen por https://locationlists.com/license.