LocationLists
io.github.kylehawke-stack/locationlists · v1.2.0 · MCP 2025-11-25
US business location data: search, sample, count, query rows or buy CSVs (Stripe or x402 USDC).
Reachability
reachable
checked 2026-09-20 05:33 UTC
Registry status active
Tools pinned 16
745982ccded2
Tools last changed
2026-09-18
Repo last push 2026-09-16
GitHub stars 0
Provenance
Registry namespace io.github.kylehawke-stack
(GitHub-account verified by the official registry)
Repository
github.com/kylehawke-stack/locationlists-mcp
Website
https://locationlists.com
Remote endpoints
https://locationlists.com/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-09-18 05:33 | tools changed | 0 added, 0 removed, 8 changed |
| 2026-09-16 05:33 | tools changed | 1 added, 0 removed, 2 changed |
| 2026-09-15 05:31 | tools changed | 7 added, 0 removed, 5 changed |
| 2026-09-14 05:31 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-09-12 05:30 | first capture | 8 tools pinned |
Pinned tool definitions (16)
| Tool | Description |
|---|---|
| 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,... |
| 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... |
| 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... |
| 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... |
| get_dataset | Full record for one dataset: fields with descriptions, record and state counts, coverage, whether it can be searched by distance, advertised refresh cadence AND the real last-modified date of the file, FAQs, sample URL and the dataset's... |
| 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... |
| 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... |
| 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,... |
| 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... |
| 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.... |
| get_quote | Line-item prices and total for a list of dataset slugs. If a bundle covers several requested brands for less, it says so. |
| 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... |
| 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. |
| 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,... |
| 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... |
| 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... |
Get alerted when this changes.
Email the moment io.github.kylehawke-stack/locationlists drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.github.kylehawke-stack/locationlists)
Maintain this server? Add the badge to your README. It links your users to this live status page.