LocationLists

Pesquise 725 conjuntos de dados de localização de empresas nos EUA (redes de concessionárias, contratados licenciados, cadeias de lojas), visualize linhas reais e compre CSVs. Servidor remoto em https://locationlists.com/mcp, sem autenticação.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP LocationLists

Conjuntos de dados CSV prontos para uso de localizações de empresas nos EUA — redes de concessionárias, empreiteiros licenciados, redes de varejo e restaurantes — pesquise, visualize linhas reais e compre no chat.

Este repositório contém o registro de listagem (server.json) e notas de configuração do cliente para o servidor MCP LocationLists hospedado. O servidor em si roda em locationlists.com; não há nada para instalar ou executar localmente.


Endpoint	`https://locationlists.com/mcp`
Transporte	HTTP Streamable, sem estado, respostas JSON
Autenticação	Nenhuma
Nome do registro	`io.github.kylehawke-stack/locationlists`
Perfil somente leitura	`https://locationlists.com/mcp/chatgpt` (somente pesquisa, conjunto de dados, amostra — sem preços ou checkout)

O que há no catálogo

Os números são lidos do catalog.json ao vivo (gerado em 2026-09-11):

725 conjuntos de dados mais 1 pacote, 14.248.853 localizações de empresas nos EUA no total
Categorias: Saúde, Varejo, Industrial, Organizações sem fins lucrativos, Equipamentos, Móveis, Café da manhã, Ferragens, Churrasqueiras, Colchões, Móveis para exteriores
Cada conjunto de dados é compilado a partir do localizador oficial, diretório de associações ou registro de licenças estaduais que o publica
Os preços são únicos, de US$ 9 a US$ 199 por conjunto de dados, conforme a contagem de registros; a entrega é feita por link de download enviado por e-mail após o pagamento via Stripe

Ferramentas

Ferramentas principais (disponíveis em /mcp; as três primeiras também estão em /mcp/chatgpt):

Ferramenta	Argumentos	O que faz
`search_datasets`	`query?` string, `category?` enum, `limit?` int (1–50, padrão 15)	Encontra conjuntos de dados por marca, linha de produtos, tipo de localização ou categoria. Retorna slug, nome, contagem de registros, cobertura e URL da página. Somente leitura.
`get_dataset`	`slug` string	Registro completo: campos com descrições, contagens de registros e estados, cobertura, cadência de atualização, a data real de última modificação do arquivo, perguntas frequentes, URL de amostra e URL da página.
`get_sample`	`slug` string, `rows?` int (≤10)	Até 10 linhas reais do arquivo ao vivo, distribuídas pelo conjunto de dados, como JSON além de texto CSV.
`get_quote`	`slugs` string[]	Preços por item e total para um ou mais conjuntos de dados; indica um pacote se ele cobrir várias marcas solicitadas por menos.
`create_checkout`	`slug` string, `email?` string	Abre uma sessão de checkout do Stripe para um conjunto de dados e retorna a URL de pagamento e o ID da sessão. Não cobra nada por si só.
`check_order`	`sessionId` string	Informa se uma sessão de checkout foi paga e, se sim, retorna o link de download permanente.

Ferramentas de pagamento por agente (x402, USDC na Base) para agentes que possuem carteira:

Ferramenta	Argumentos	O que faz
`query_locations`	`dataset` string, `state?`, `city?`, `county?`, `zip?`, `limit?` int (≤100)	Linhas de um conjunto de dados filtradas por valores exatos de coluna, precificadas por linha e liquidadas somente após a produção das linhas. Chame primeiro sem cabeçalho de pagamento para obter uma cotação. Conjuntos de dados com menos de 5.000 registros não são vendidos por linha.
`buy_dataset`	`dataset` string	Compre um conjunto de dados inteiro diretamente e receba o link de download permanente, pelo mesmo preço de tabela que um comprador com cartão paga.

As ferramentas carregam anotações readOnlyHint / destructiveHint. initialize retorna serverInfo.name = "LocationLists".

Configuração do 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"
    }
  }
}

O VS Code usa a chave servers em vez de mcpServers em .vscode/mcp.json; a entrada é igual no restante.

Claude.ai e ChatGPT

Claude.ai: Configurações → Conectores → Adicionar conector personalizado → URL https://locationlists.com/mcp, sem OAuth.
ChatGPT: Configurações → Conectores (modo desenvolvedor) → adicionar https://locationlists.com/mcp/chatgpt, sem autenticação. O perfil somente leitura é usado lá porque a compra de bens digitais no chat não é permitida no ChatGPT.

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

Um caminho rápido pelas ferramentas: 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 (sem necessidade de cliente MCP)

URL	O que é
`/llms.txt`	Mapa curado do site para assistentes (llmstxt.org)
`/llms-full.txt`	Todos os conjuntos de dados com campos, contagens, atualização e preço
`/catalog.json`	O mesmo catálogo em JSON
`/data/{slug}/dataset.json`	Um conjunto de dados completo, incluindo a data real de última modificação
`/data/{slug}/sample.csv`, `/data/{slug}/sample.json`	10 linhas reais, sem cadastro
`/data/{slug}/buy?src=<name>`	Redireciona para o checkout do Stripe para aquele conjunto de dados

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

Licença

Os arquivos neste repositório (README, server.json) são licenciados sob MIT — veja LICENSE. Os conjuntos de dados vendidos pelo servidor não são cobertos por essa licença; eles são regidos por https://locationlists.com/license.