Use with AI assistants
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.
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.
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.
Add LocationLists to your assistant yourself:
Then ask for the list you need, for example “find dental practices in Austin, Texas”.
Claude Code:
claude mcp add --transport http locationlists https://locationlists.com/mcp
No MCP client? POST https://locationlists.com/api/x402/query returns HTTP 402 with the price, and rows once paid by x402 (USDC on Base). /llms.txt · /skill.md · /openapi.json
For developers
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 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 extensionMIT licensed · source on GitHub
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.
Run this once in a terminal:
claude mcp add --transport http locationlists https://locationlists.com/mcp
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"}}}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"}}}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
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}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).
It calls query_locations on our MCP server at locationlists.com/mcp. No key, no signup, nothing to register first.
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.
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.
Money moves only after the query succeeds. A failed call, or one that matches nothing, costs you nothing — the authorization is simply never settled.
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.
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.
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.