Use with AI assistants

Use LocationLists from ChatGPT or Claude, no setup needed

Ask for the list you need in plain English. Your assistant opens a LocationLists link, shows you the count, sample rows and the price, and you buy only what you approve. Pay by card, no account needed.

The link is https://locationlists.com/find?q= followed by the question in plain words. Nothing to install, nothing to sign up for.

Using ChatGPT or Claude? Tell it to answer from locationlists.com/find — no account, no connector.

How assistants ask

No connector needed. Any AI assistant can answer from this site with a web link, no connector, no account: open https://locationlists.com/find with the question as query parameters.

If a question needs filtering, distance, drive time, combining lists or a price, open a /find link: either put the question itself in q=, or build the structured link. The answer does not need an API, a connector or an account.

Simplest, the question itself: https://locationlists.com/find?q=<the question in plain words>

Or set the parts yourself: https://locationlists.com/find?dataset=<slug>&state=<ST>&city=<city>&county=<county>&zip=<zip>&near=<place or zip>&radius=<miles>&drive=<minutes>&where=<column>:<op>:<value>&total=<rows>

Leave out what the question does not need. Use radius for straight-line miles or drive for minutes of driving (5 to 60), not both; near can name several places separated by | to reach from any of them. To ask about several lists at once, use datasets with two or more names, or category with a kind of business. To compare two lists, add relate=nearest and the other list with b. in front of its parameters. To count by area, use areas=county (or zip, state, metro). To keep only places whose county, ZIP code, metro area or state meets a Census figure, add area_where (for example county:population>1000000); with areas, per=100000 gives counts per 100,000 residents.

Optional: connect for repeat use or wallet payments

No setup needed for a one-off question: open https://locationlists.com/find with the question as query parameters. Connecting is optional.

Copy this and paste it into ChatGPT or Claude:

Read https://locationlists.com/skill.md and follow the instructions to connect LocationLists.

Your assistant will walk you through setup and show you prices before you pay.

For developers

Optional: let your agent pay from a wallet

Without a connector, every question below is one link: https://locationlists.com/find?dataset=dental-practice-list&city=Austin&state=TX (relating two lists: https://locationlists.com/find?dataset=closed-bank-branches-us&state=OH&relate=nearest&k=1&b.dataset=bank-branches-us&b.state=OH).

2798 datasets. 17.7 million US and Canadian business locations — manufacturer dealer networks, state-licensed trade contractors, retail and restaurant chains, healthcare practices, and firms drawn from federal credential registries. Every one is compiled from the official locator, license register or government file that publishes it, and refreshed on a schedule. Your agent can query any of them and pay per row in USDC — no card, no account, no human at the keyboard.

Claude Desktop: install the extension

Claude holds no keys and cannot sign a payment, so the wallet lives in a tool it calls. Download the extension, double-click it, and give it a funded Base wallet plus two spending caps. Then just ask Claude a question about where businesses are.

Download the extension

MIT licensed · source on GitHub

Connect your client

Without a connector, the same count, preview and price come from a link: https://locationlists.com/find?dataset=dental-practice-list&city=Austin&state=TX (relating two lists: https://locationlists.com/find?dataset=closed-bank-branches-us&state=OH&relate=nearest&k=1&b.dataset=bank-branches-us&b.state=OH).

The server lives at https://locationlists.com/mcp — Streamable HTTP, no key, no signup.

Claude Code

Run this once in a terminal:

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

Cursor

Add to Cursor opens Cursor with the server filled in. Or add it by hand under MCP settings:

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

VS Code

Install in VS Code adds it to your MCP servers. Or add it to .vscode/mcp.json:

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

Claude Desktop

Free tools work as a custom connector pointed at the URL below. To pay, install the wallet extension above — Claude cannot sign a payment on its own.

https://locationlists.com/mcp

Developers: plain HTTP, no MCP

POST the same arguments as query_locations to the endpoint below. An unpaid call returns HTTP 402 with the exact price in a PAYMENT-REQUIRED header; retry with the signed payment in PAYMENT-SIGNATURE and the rows come back with a PAYMENT-RESPONSE receipt. Spec at /openapi.json.

POST https://locationlists.com/api/x402/query
Content-Type: application/json

{"dataset":"dental-practice-list","state":"TX","city":"Austin","limit":10}

How the payment works

Without a connector, the link's answer has a card Buy link instead: https://locationlists.com/find?dataset=dental-practice-list&city=Austin&state=TX (relating two lists: https://locationlists.com/find?dataset=closed-bank-branches-us&state=OH&relate=nearest&k=1&b.dataset=bank-branches-us&b.state=OH).

1

Your agent asks for data it does not have

It calls query_locations on our MCP server at locationlists.com/mcp. No key, no signup, nothing to register first.

2

We answer with the price

The tool result carries x402 payment terms: the amount in USDC, the network, and the address to pay. Priced per row from the dataset, so a county-sized query is cents. Plain HTTP clients get the same terms as an HTTP 402.

3

Your agent signs and retries

It signs an EIP-3009 authorization and repeats the call with the payment in _meta["x402/payment"] (or a PAYMENT-SIGNATURE header over HTTP). Gasless — the facilitator broadcasts and pays the gas, so your wallet needs USDC and nothing else.

4

We settle, then serve

Money moves only after the query succeeds. A failed call, or one that matches nothing, costs you nothing — the authorization is simply never settled.

Any MCP client

Without a connector, each free tool's answer is a link: https://locationlists.com/find?dataset=dental-practice-list&city=Austin&state=TX (relating two lists: https://locationlists.com/find?dataset=closed-bank-branches-us&state=OH&relate=nearest&k=1&b.dataset=bank-branches-us&b.state=OH).

The server is plain MCP over HTTP. Point any client at it and read the 402:

POST https://locationlists.com/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"query_locations",
           "arguments":{"dataset":"generac-dealers","state":"CO","limit":20}}}

The free tools — search_datasets, relate_locations, count_by_area, cotenancy, get_dataset, count_locations, get_sample, request_list, send_feedback, email_quote, get_quote, create_checkout, check_order, create_query_checkout — need no payment at all, so an agent can decide whether a dataset is worth buying before it spends anything. Start with count_locations: it says how many rows match a filter and exactly what fetching them would cost. Paid: query_locations, buy_dataset.

When this beats gathering it yourself

An agent with a browser can read a brand’s dealer locator, and for who is near me it should. A locator returns what is close to one point, capped per search. Three kinds of question that breaks:

For anything smaller than that, honestly, read the locator. We would rather you bought the right thing than the expensive thing.

Buying the whole file

Without a connector, a link's answer shows when the whole file is cheaper: https://locationlists.com/find?dataset=dental-practice-list&city=Austin&state=TX (relating two lists: https://locationlists.com/find?dataset=closed-bank-branches-us&state=OH&relate=nearest&k=1&b.dataset=bank-branches-us&b.state=OH).

Metered queries are for slices. If you want an entire dataset, that is a one-time purchase from $9 to $199 by record count, delivered as a CSV — and per row it is far cheaper than querying. Datasets under 5,000 records are only sold whole; the query tool will tell your agent so and hand back the link.