Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.
PopNx MCPMCP servers for people who use AI · explained in plain words

LocationLists

by kylehawke-stackversion 1.2.0i★ 0iRuns in the cloud
Registry nameio.github.kylehawke-stack/locationlists

How to install

Overview

Description from the maker (original English)

US business location data: search, sample, count, query rows or buy CSVs (Stripe or x402 USDC).

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs in the cloud
  • Transport: Streamable HTTP
  • Category: Online shops & payments

Install

Pick the AI app you use, then copy the settings.

Passed 4/4 checks · What you ask goes through the maker’s server (locationlists.com)

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1+ Add2https://…3Add4
  2. Click “+ Add” → “Add custom connector” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameLocationLists
    Remote MCP server URL · Addresshttps://locationlists.com/mcp

    Leave Authentication as Claude detected it, then click Add

  3. Turn it on in a chat

    +ConnectorsLocationLists

  4. Try it

    Use LocationLists and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using LocationLists or shows a LocationLists tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT on business plans only

ChatGPT Business, Enterprise or Edu on the web, added by a workspace admin or owner · On Free, Plus or Pro: your ChatGPT plan cannot connect MCP yet

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameLocationLists
    Connection · Addresshttps://locationlists.com/mcp
  3. Pick LocationLists in a chat

    Start a new chat and pick LocationLists from your plugins before typing

  4. Try it

    Use LocationLists and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using LocationLists or shows a LocationLists tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http locationlists https://locationlists.com/mcp
  3. Type /mcp in Claude Code

    You should see LocationLists listed as connected

  4. Try it

    Use LocationLists and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using LocationLists or shows a LocationLists tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use LocationLists and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using LocationLists or shows a LocationLists tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use LocationLists and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using LocationLists or shows a LocationLists tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://locationlists.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use LocationLists💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

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 (mcp.json)

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

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
No licence stated
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
1.2.0
Published to registryi
Sep 14, 2026
Code last changedi
Sep 16, 2026
Maker
kylehawke-stack
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 9, 2026. The maker wrote them, not us; we show them as plain text.

  • search_datasets

    Find LocationLists datasets by brand, kind of business or industry (e.g. 'bobcat', 'restaurants', 'bank branches', 'dental practices', 'hardware stores'). Returns EVERY matching dataset, best first, with slug, name, business type, industry, record count, coverage, whether it can

  • relate_locations

    Free. How one set of places relates to another, by straight-line distance. The base set is the usual dataset / datasets / category plus filters; relate.anchor is the other set, given the same way. Modes: nearest (each base row's k<=3 nearest anchors with miles), count_within (ran

  • count_by_area

    Free, counts only. Counts places per county / zip / state / metro for 1 to 4 labeled sets (each a dataset, datasets or category plus filters), and compares them: has (areas with at least one of every listed set) and lacks (areas with none of any listed set). E.g. counties that ha

  • cotenancy

    Free, counts only. How two sets of places sit together: the share of set a within radius_miles of set b and of b within radius_miles of a, how many places overlap, and the county / zip / state / metro areas that have both, only a, or only b (top 10 of each named). Each set is a d

  • get_dataset

    Full record for one dataset: fields with descriptions, record and state counts, coverage measured on the rows (a list in 14 states says "partial U.S.: 14 states"; coverageDetail lists the states, rows per state and the states with none), whether it can be searched by distance, ad

  • count_locations

    Free. How many rows of one dataset match a filter — on geography AND any other column (e.g. nonprofits with revenue_amt gt 2000000, dealers with dealerClass eq 'Elite'). Also reports how many rows were excluded only because a tested column was blank, so a thin column is not mista

  • get_sample

    Free. Real rows from the live file, as JSON plus CSV text. Show these to the user so they can judge the fields and quality. Without filters: up to 10 rows spread across the whole dataset. With filters (the same ones count_locations takes: city, state, county, zip, metro, `where`

  • request_list

    Ask LocationLists to add a list we do not have yet. Use it when search_datasets finds nothing that fits, or the user wants a brand, place or kind of business we do not publish. BEFORE calling: ask the user whether to send the request, and ask for their email so we can tell them w

  • send_feedback

    Send a message to the LocationLists team: wrong or missing data in a dataset, something that did not work, a pricing question, an idea, or anything else. Ask the user before sending and use their words. Ask for their email so the team can reply, and pass it only if they gave it;

  • email_quote

    Free. Emails the user a plain-English quote for exactly this request: how many rows match, the card price, a few of the matches and a card checkout link, so they can pay later, from any device, or forward it to whoever holds the card. Takes the same arguments as count_locations:

  • get_quote

    Line-item prices and total for a list of dataset slugs, each with how it is sold (soldBy: file, row, or both) — the same rule create_checkout, buy_dataset, create_query_checkout and query_locations enforce, so a quote never offers a route checkout refuses. A list sold by the row

  • create_checkout

    Opens a Stripe Checkout session for one dataset and returns the payment URL plus the session id. Give the URL to the user to pay (card, Apple Pay, Google Pay). After payment Stripe emails them a permanent download link; use check_order with the session id to confirm and fetch it.

  • check_order

    Given a Stripe Checkout session id (cs_…), reports whether it is paid and, if so, returns the permanent download link for the CSV. Works for whole files, filtered rows and combined (several-dataset) orders. Any download link takes ?shape=hubspot or ?shape=salesforce for CRM-ready

  • create_query_checkout

    For buyers paying by card (no wallet needed): opens a Stripe Checkout for just the rows of one dataset that match a filter, and returns the payment URL to give the user. Takes the same filters as count_locations (state/city/county/zip, `where` on any column, `near`, `order_by`) a

  • query_locations

    Return matching rows from one dataset, filtered on ANY of its columns — state/city/county/zip shortcuts plus `where` conditions with numeric comparisons (e.g. [{field:"revenue_amt",op:"gt",value:2000000}]), sorted with `order_by` and paged with `offset`. `near` ({place:"Topeka, K

  • buy_dataset

    Buy an ENTIRE dataset outright and get a permanent download link for the CSV. Pays once in USDC on Base, at the same list price a human pays by card — no account and no checkout page.\n\nPrefer this over repeated query_locations calls whenever you want most of a file. Metered que

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 11, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account kylehawke-stack, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 2 months ago

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 230 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 16 tool descriptions and found no hidden instructions to the AI

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in with Google to post

User reviews

No reviews yet

Sign in with Google to write a review

Compared with others in Online shops & paymentsi

  • More stars than 0% of the other 2714 servers in this category
  • Published to the registry more recently than 33% of the other 2714 servers in this category
  • Basic checks equal to or better than 100% of the other 2714 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is LocationLists safe?

It passed 4 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 2 months ago, and the latest version (1.2.0) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT Business and above.

What can I use instead?

In the same category: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spree Commerce developer docs for AI agents

Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.

by spreeWidely used★ 15.8K Stars for the whole repoUpdated 12 days ago

Runs in the cloud

Stripe MCP

Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.

by stripeWidely used★ 2.1KUpdated 13 months ago

Runs in the cloud✓ stripe.com

Sessy — Amazon SES observability

Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.

by marckohlbruggeGrowing★ 945Updated 3 months ago

Runs in the cloud

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

LocationLists MCP server

No connector needed: any AI assistant can answer a location question by opening https://locationlists.com/find?q= — counts, a preview, a price and a card checkout link. Connect the MCP for repeat use or wallet payments.

Answer from a link (no connector)

Open the link. No account, no key, no setup. The answer comes back with how many locations match, a few real rows, the price and a checkout link.

  • 100 retail stores within 25 miles of Los Angeles: https://locationlists.com/find?category=retail&near=Los+Angeles+CA&radius=25&total=100
  • Dental practices in Richmond, VA: https://locationlists.com/find?dataset=dental-practice-list&city=Richmond&state=VA
  • STIHL dealers within a 30-minute drive of zip 23219: https://locationlists.com/find?dataset=stihl-dealers&near=23219&drive=30

Or set no parameters at all and put the question itself in q=, in plain words.

Everything below is for repeat use and wallet payments.

Listed on Smithery · Glama · Official MCP Registry · x402scan

Business location data for AI agents. Search, sample, count and buy ready-to-use lists of US business locations: 966 datasets compiled from each brand's official store locator or the public register that publishes the data.

Filter by city, state, zip, a radius around any place, or any column in the file. Buy a full CSV by card, or let an agent pay per row or buy the whole file in USDC on Base via x402, with no account or API key. A failed or empty query costs nothing.

This repository holds the registry listing (server.json) and client setup notes for the hosted LocationLists MCP server. The server runs at locationlists.com; there is nothing to install or run locally.

Endpointhttps://locationlists.com/mcp
TransportStreamable HTTP, stateless, JSON responses
AuthNone
PaymentsStripe Checkout (people) or x402, USDC on Base (agents)
Registry nameio.github.kylehawke-stack/locationlists
Read-only profilehttps://locationlists.com/mcp/chatgpt (search, dataset, sample, count only; no checkout)

What is in the catalog

Figures are read from the live catalog.json (generated 2026-09-16):

  • 966 datasets plus 2 bundles, 15,184,612 US business locations in total (overlapping slices counted once)
  • Categories: Breakfast, Equipment, Financial, Furniture, Government, Grills, Hardware, Healthcare, Industrial, Mattresses, Nonprofits, Other Transactions, Outdoor Furniture, Retail
  • Each dataset is compiled from the official locator, association directory or public register that publishes it
  • One-time prices from $9 to $1,299 per dataset, by record count

Tools

All nine tools are on /mcp. Tools carry readOnlyHint / destructiveHint / openWorldHint annotations. initialize returns serverInfo.name = "LocationLists".

Free tools:

ToolArgumentsWhat it does
search_datasetsquery? string, category? enum, limit? int (≤50)Find datasets by brand, product line, location type or category. Returns slug, name, record count, coverage and page URL.
get_datasetslug stringFull record: fields with descriptions, record and state counts, coverage, refresh cadence, the real last-modified date of the file, FAQs, sample URL and page URL.
get_sampleslug string, rows? int (≤10)Up to 10 real rows from the live file, spread across the dataset, as JSON plus CSV text.
count_locationsdataset string, state?, city?, county?, zip?, where? arrayHow many rows match a filter on geography and any other column (e.g. revenue_amt gt 2000000), and what fetching them would cost.
get_quoteslugs string[]Line-item prices and total for one or more datasets; points out a bundle if it covers several requested brands for less.

Card checkout (Stripe):

ToolArgumentsWhat it does
create_checkoutslug string, email? stringOpens a Stripe Checkout session for one dataset and returns the payment URL and session id. Does not charge anything by itself.
check_ordersessionId stringReports whether a Checkout session is paid and, if so, returns the permanent download link.

Agent payments (x402, USDC on Base):

ToolArgumentsWhat it does
query_locationsdataset string, state?, city?, county?, zip?, where? array, order_by? object, offset? int, limit? int (≤100)Rows from one dataset filtered on any column, sorted and paged. Priced per row and settled only after the rows are produced. Datasets under 5,000 records are not sold by the row.
buy_datasetdataset stringBuy a whole dataset outright and get a permanent download link for the CSV, at the same list price a card buyer pays.

Agents can pay with x402

query_locations and buy_dataset use x402, the HTTP 402 payment protocol. An agent that holds USDC on Base can buy data with no account, API key or checkout page:

  1. Call the tool without payment. The server answers with the exact price and x402 payment requirements (USDC on Base mainnet, settled through the Coinbase CDP facilitator).
  2. Sign the payment with the agent's wallet and call the tool again with the payment attached.
  3. The server returns the rows (query_locations) or the permanent download link (buy_dataset). Per-row queries settle only after the rows are produced, so a failed query costs nothing.

Pricing rules the agent can rely on:

  • count_locations is free and reports how many rows a filter matches and what they would cost, before any payment.
  • Per-row prices are set per dataset at roughly twice the list price spread over its record count, so a small slice of a large file costs cents. You pay for the limit you request.
  • Past a few hundred rows, buy_dataset is cheaper than assembling the file row by row, and it is complete.

Clients without a wallet can use get_quote → create_checkout → check_order and pay by card instead.

Client setup

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 and ChatGPT
  • Claude.ai: Settings → Connectors → Add custom connector → URL https://locationlists.com/mcp, no OAuth.
  • ChatGPT: Settings → Connectors (developer mode) → add https://locationlists.com/mcp/chatgpt, no auth. The read-only profile is used there because in-chat purchase of digital goods is not permitted in ChatGPT.
Any MCP client, by hand
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"}}}'

A quick path through the tools: 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}.

Plain HTTP endpoints (no MCP client needed)

URLWhat
/llms.txtCurated map of the site for assistants (llmstxt.org)
/llms-full.txtEvery dataset with fields, counts, refresh and price
/catalog.jsonThe same catalog as JSON
/data/{slug}/dataset.jsonOne dataset in full, including the real last-modified date
/data/{slug}/sample.csv, /data/{slug}/sample.json10 real rows, no signup
/data/{slug}/buy?src= Redirects to Stripe Checkout for that dataset

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

Links

License

The files in this repository (README, server.json) are MIT licensed; see LICENSE. The datasets sold through the server are not covered by that license; they are governed by https://locationlists.com/license.