MCP server

LocationLists

io.github.kylehawke-stack/locationlists

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

16

Token cost

About 57,413 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.locationlists]
url = "https://locationlists.com/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add locationlists https://locationlists.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"locationlists","server_url":"https://locationlists.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"locationlists","server_url":"https://locationlists.com/mcp"}

Tools

• buy_dataset Moves money · ~230 tokens
  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 queries are priced per
• check_order ~175 tokens
  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 column names (every
• cotenancy ~5493 tokens
  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 dataset, datasets or
• count_by_area ~9460 tokens
  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 have set a but no set
• count_locations ~6586 tokens
  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 mistaken for a small answ
• create_checkout Moves money · ~201 tokens
  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. Does not charge any
• create_query_checkout Moves money · ~6458 tokens
  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`) and up to 10,000 rows
• email_quote ~5943 tokens
  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: dataset, or datasets
• get_dataset ~200 tokens
  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, advertised refresh cad
• get_quote ~586 tokens
  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 only (an Overture Ma
• get_sample ~6450 tokens
  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` on any column, areas
• query_locations ~6722 tokens
  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, KS"}, a zip, or lat+l
• relate_locations ~7458 tokens
  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 (rank base rows by how m
• request_list ~476 tokens
  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 when the list is read
• search_datasets ~649 tokens
  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 be searched by dista
• send_feedback Sends messages · ~326 tokens
  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; never guess or inven

Browse

• GitHub tools
• Stripe tools
• Spreadsheets
• Email
• CRM
• Payments

Related MCP servers

• Leadmarina
  Verified local-business leads: search any niche + city, query your library, export to your CRM.
• Worklittle Jobs
  Find jobs near you. Search over 4 million openings by role, place, pay, visa and more.
• 1820.ch – Telefonbuch Schweiz
  Swiss phone directory: search people and businesses, reverse number lookup, business categories.
• UK company & compliance data
  Companies House, Gazette notices, sanctions screening, LEIs and UK legislation.
• Zenserp MCP by usefulapi
  Search Google, images, news, maps, shopping, YouTube, jobs, hotels, flights and trends with Zenserp.
• Mostly Right
  Search, sample and query open reproducible datasets published as immutable Parquet with schemas.
• Nordax AI Entity Network
  Search and verify 360K+ business entities with trust scores and W3C credentials.
• Bezal — Local Business Intelligence for AI Agents
  Search 7,000+ local service businesses across America by category, location, or keyword.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.kylehawke-stack/locationlists.svg)](https://aptlynx.net/servers/io.github.kylehawke-stack/locationlists)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents