list_estaite_submarkets

Description

Lists every active submarket in the index. Returns up to 200 records, ordered alphabetically by submarket_name. Use this for browsing or building a UI picker — never use it as a lookup step before querying metrics. For name → id resolution use search_estaite_submarkets.

Inputs

Name	Type	Required	Description
state	string (2-letter)	no	US state code, e.g. "CA". Filters on the submarket’s CBSA state.
cbsa_name	string	no	Partial CBSA name match, e.g. "Dallas" matches "Dallas-Fort Worth-Arlington, TX".
cbsa_code	string	no	Reserved for future use; currently accepted but ignored. To filter by metro today, use cbsa_name.

All filters are optional. With no filters, you get the first 200 submarkets alphabetically (so the result will skew toward names early in the alphabet — pair with a state or CBSA filter to scope to what you actually want).

Response

{
  "attribution": "Data via Estaite Submarket Index",
  "powered_by": "Estaite.com",
  "filters_applied": { "state": "CA" },
  "data": [
    {
      "id": 1,
      "name": "Carmel Valley",
      "zipcodes": "92130,92129",
      "cbsa": "San Diego-Chula Vista-Carlsbad, CA",
      "state": "CA"
    }
  ]
}

Fields

Field	Type	Description
attribution	string	Required attribution text. Echo verbatim.
powered_by	string	Always "Estaite.com".
filters_applied	object	Echo of the filters that were honored. Omitted entirely when no filters were passed.
data[].id	number	Canonical submarket id used by the rest of the API.
data[].name	string	Submarket name.
data[].zipcodes	string	Comma-separated ZIPs aggregated into the submarket.
data[].cbsa	string	CBSA / metro name the submarket belongs to.
data[].state	string	2-letter US state code.

Errors

This tool does not throw domain-specific errors. Generic upstream failures (database, auth, rate limit) bubble up as the standard MCP error envelope.

Notes

• The 200-row cap is firm. For broader exploration use multiple filtered calls instead of paginating.
• Results are alphabetical by submarket name, not ranked by activity or rent.