Api Endpoint

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.

Open interactive test console

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": {}
      }
    }
  }
}