LocationLists
No connector needed: any AI assistant can answer a location question by opening https://locationlists.com/find?q=<the question in plain words> — counts, a preview, a price and a card checkout link. Connect the MCP for repeat use or wallet payments. Ready-to-use lists of US business locations: 1,084 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.
Offering
- Provider
- locationlists.com
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- mcp
- Category
- Location And Travel
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://locationlists.com/mcp- MIME type
- application/json
- First seen
- 2026-10-16T02:07:22.607Z
- Last seen
- Tags
- business locations, store locations, dealer locations, nonprofit data, B2B leads
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.21 USDC
Atomic price: 210000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "210000",
"payTo": "0x1771e6d558F4dA1b9cfA0C64226cAaf9a0971292"
}
]Observed health
- Status
- Healthy
- Latest latency
- 1104 ms
- Average latency
- 601 ms
- HTTP status
- 200
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"type": "mcp",
"example": {
"city": "Richmond",
"limit": 25,
"where": [
{
"op": "gt",
"field": "revenue_amt",
"value": 2000000
}
],
"dataset": "nonprofits-va",
"order_by": {
"field": "revenue_amt"
}
},
"toolName": "query_locations",
"transport": "streamable-http",
"description": "Rows from US business location datasets, filtered on any column (radius around a place, city, revenue, employees, dealer tier…) with numeric comparisons and sorting. One dataset, or several / a whole category (e.g. every retail chain near LA) combined into one answer: duplicates removed, one payment, one file. Priced per row.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"$comment": "Field descriptions: https://locationlists.com/openapi.json",
"properties": {
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"near": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"zip": {
"type": "string"
},
"place": {
"type": "string"
},
"radius_miles": {
"type": "number",
"maximum": 500,
"exclusiveMinimum": 0
},
"drive_minutes": {
"type": "integer",
"maximum": 60,
"minimum": 5
}
},
"additionalProperties": false
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"state": {
"type": "string"
},
"total": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"where": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"op"
],
"properties": {
"op": {
"enum": [
"eq",
"ne",
"gt",
"gte",
"lt",
"lte",
"in",
"contains",
"starts_with",
"is_blank",
"not_blank"
],
"type": "string"
},
"field": {
"type": "string"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "array",
"items": {
"type": [
"string",
"number"
]
}
}
]
}
},
"additionalProperties": false
},
"maxItems": 12
},
"county": {
"type": "string"
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"relate": {
"type": "object",
"additionalProperties": {}
},
"dataset": {
"type": "string"
},
"exclude": {
"type": "array",
"items": {
"type": "string"
}
},
"areas_in": {
"type": "object",
"required": [
"by",
"ids"
],
"properties": {
"by": {
"enum": [
"county",
"zip",
"state",
"metro"
],
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 200,
"minItems": 1
}
},
"additionalProperties": false
},
"category": {
"type": "string"
},
"datasets": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 150,
"minItems": 1
},
"order_by": {
"type": "object",
"required": [
"field"
],
"properties": {
"field": {
"type": "string"
},
"direction": {
"enum": [
"asc",
"desc"
],
"type": "string"
}
},
"additionalProperties": false
},
"area_where": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6
},
"area_columns": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6
}
},
"additionalProperties": false
}
}Output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"toolName",
"inputSchema"
],
"properties": {
"type": {
"type": "string",
"const": "mcp"
},
"example": {
"type": "object"
},
"toolName": {
"type": "string"
},
"transport": {
"enum": [
"streamable-http",
"sse"
],
"type": "string"
},
"description": {
"type": "string"
},
"inputSchema": {
"type": "object"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {}
}
}
}
}