
No connector needed: any AI assistant can answer a location question by opening
No connector needed: any AI assistant can answer a location question by opening https://locationlists.com/find?q=<the question in plain words>. MCP server for repeat use: search, preview and buy lists of US business locations.
·
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.
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.
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.
| Endpoint | https://locationlists.com/mcp |
| Transport | Streamable HTTP, stateless, JSON responses |
| Auth | None |
| Payments | Stripe Checkout (people) or x402, USDC on Base (agents) |
| Registry name | io.github.kylehawke-stack/locationlists |
| Read-only profile | https://locationlists.com/mcp/chatgpt (search, dataset, sample, count only; no checkout) |
Figures are read from the live catalog.json (generated 2026-09-16):
All nine tools are on /mcp. Tools carry readOnlyHint / destructiveHint / openWorldHint annotations. initialize returns serverInfo.name = "LocationLists".
Free tools:
| Tool | Arguments | What it does |
|---|---|---|
search_datasets | query? 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_dataset | slug string | Full 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_sample | slug string, rows? int (≤10) | Up to 10 real rows from the live file, spread across the dataset, as JSON plus CSV text. |
count_locations | dataset string, state?, city?, county?, zip?, where? array | How many rows match a filter on geography and any other column (e.g. revenue_amt gt 2000000), and what fetching them would cost. |
get_quote | slugs 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):
| Tool | Arguments | What it does |
|---|---|---|
create_checkout | slug string, email? string | Opens a Stripe Checkout session for one dataset and returns the payment URL and session id. Does not charge anything by itself. |
check_order | sessionId string | Reports whether a Checkout session is paid and, if so, returns the permanent download link. |
Agent payments (x402, USDC on Base):
| Tool | Arguments | What it does |
|---|---|---|
query_locations | dataset 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_dataset | dataset string | Buy a whole dataset outright and get a permanent download link for the CSV, at the same list price a card buyer pays. |
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:
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.limit you request.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.
claude mcp add --transport http locationlists https://locationlists.com/mcp~/.cursor/mcp.json){
"mcpServers": {
"locationlists": {
"url": "https://locationlists.com/mcp"
}
}
}.vscode/mcp.json){
"servers": {
"locationlists": {
"type": "http",
"url": "https://locationlists.com/mcp"
}
}
}https://locationlists.com/mcp, no OAuth.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.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}.
| URL | What |
|---|---|
/llms.txt | Curated map of the site for assistants (llmstxt.org) |
/llms-full.txt | Every dataset with fields, counts, refresh and price |
/catalog.json | The same catalog as JSON |
/data/{slug}/dataset.json | One dataset in full, including the real last-modified date |
/data/{slug}/sample.csv, /data/{slug}/sample.json | 10 real rows, no signup |
/data/{slug}/buy?src=<name> | Redirects to Stripe Checkout for that dataset |
Example: bobcat-dealers/dataset.json, bobcat-dealers/sample.csv.
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.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add locationlists --transport http https://locationlists.com/mcp{
"mcpServers": {
"locationlists": {
"url": "https://locationlists.com/mcp"
}
}
}code --add-mcp '{"name":"locationlists","url":"https://locationlists.com/mcp"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/locationlists-mcp-server to learn what the "LocationLists MCP server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http locationlists https://locationlists.com/mcp| Name | What it does |
|---|---|
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, w |
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. Mod |
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 |
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 |
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 |
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 wer |
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 |
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 |
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 word |
price_my_list | For a user who HAS a list of business locations and wants to sell it on LocationLists. Nothing is stored and nothing is charged. Give what the list is (one sentence), about how many rows, and the figu |
sell_list | Put the user's list of business locations up for sale on LocationLists. They keep 80% of each sale; we host, check out, deliver and pay out. No account. The steps, each one call: (1) call with the use |
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 for |
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 en |
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 perma |
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) o |
create_query_checkout | For buyers paying by card: 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/ |
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:20000 |
buy_dataset | Buy an entire dataset outright and get a permanent download link for the CSV. Pays once, at the same list price a human pays by card — no account and no checkout page.\n\nPrefer this over repeated que |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/locationlists-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "locationlists-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.