{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "mcp.zip-codes.com",
    "site": "zip-codes.com",
    "addresses": [
      {
        "address": "198.71.60.119",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 8560,
          "name": "IONOS-AS - IONOS SE",
          "prefix": "198.71.48.0/20",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "198.71.60.119"
        ],
        "first_seen": "2026-11-21T12:06:01.857Z",
        "last_seen": "2026-11-22T17:13:02.951Z",
        "checks": 2
      }
    ],
    "hosting": [
      {
        "value": "Azure",
        "evidence": "Server header \"Microsoft-IIS/10.0\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "zip-codes",
      "version": "1.0.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "Microsoft-IIS/10.0"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "com.zip-codes",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/ZIP-Codes-API/zip-codes-mcp",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "18674",
    "server_name": "com.zip-codes/api",
    "url": "https://mcp.zip-codes.com/mcp",
    "host": "mcp.zip-codes.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T17:13:02.951Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "490703f957ed468052f80bef1e333735b5c0e39451a9ea301b137e3d8524fc2a",
    "first_listed_at": "2026-11-21T12:06:01.857Z",
    "created_at": "2026-11-21T07:15:06.502Z",
    "resolved_addresses": [
      "198.71.60.119"
    ]
  },
  "server": {
    "name": "com.zip-codes/api",
    "title": "Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics",
    "description": "Validate & geocode a US address: 14 years of demographics, districts & schools. Agents buy via MPP.",
    "version": "1.1.0",
    "registry_status": "active",
    "repository_url": "https://github.com/ZIP-Codes-API/zip-codes-mcp",
    "website_url": "https://www.zip-codes.com/api/mcp",
    "published_at": "2026-11-11T15:04:29.638Z",
    "updated_at": "2026-11-11T15:04:29.638Z",
    "first_seen": "2026-11-21T07:15:05.902Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "trades"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:28:06.926Z"
  },
  "operator": null,
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 328,
    "first_check_in_window": "2026-11-21T12:06:01.857Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "490703f957ed468052f80bef1e333735b5c0e39451a9ea301b137e3d8524fc2a",
    "tools": 12,
    "resources": 0,
    "prompts": 0,
    "first_seen": "2026-11-21T12:06:02.185Z",
    "tool_names": [
      "suggest_places",
      "zip_lookup",
      "zip_facts",
      "quick_zip",
      "city_name_rules",
      "buy_credits",
      "radius_search",
      "about_data",
      "distance",
      "validate_address",
      "county_reference",
      "metro_area_reference"
    ],
    "declared": {
      "tools": [
        {
          "name": "suggest_places",
          "title": "Place search (type-ahead)",
          "description": "Search for a place by partial name, misspelled name, or partial code — the resolver that turns what a person typed into something the other tools can look up. Fuzzy matching is built in: \"beverley hills\" finds Beverly Hills, \"san fransisco\" finds San Francisco, and a partial code like \"902\" finds the ZIP Codes starting with it. Matches US ZIP Codes, cities, USPS city names, counties, metropolitan areas, states, school districts, Canadian FSAs and Canadian postal codes, ranked, with the total number of matches. Reach for this FIRST when the place is vague, misspelled or partial, then pass the resolved code to zip_lookup, radius_search or distance. Restrict the kinds of place with types, or bias results towards a location with near. Coverage is broad rather than deep — it returns names and codes, not the full record.",
          "inputSchema": {
            "type": "object",
            "required": [
              "q"
            ],
            "properties": {
              "q": {
                "type": "string",
                "description": "What the user typed. At least one character, at most 200."
              },
              "near": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "Bias results towards somewhere. Accepts 'latitude,longitude', a 5-digit ZIP Code, a 3-character Canadian FSA, or a two-letter state or province abbreviation."
              },
              "limit": {
                "type": [
                  "integer",
                  "null"
                ],
                "default": null,
                "description": "How many results to return. Defaults to 10; free-tier and demo callers are capped at 15, paid keys reach 500. With a key the credit cost follows the requested limit (up to 15: 1 credit; 50: 2; 150: 3; 500: 5), whether or not anything matches; demo calls are not charged."
              },
              "state": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "Restrict to one US state or Canadian province, as a two-letter abbreviation such as CA, NY or ON."
              },
              "types": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "enum": [
                    "zip",
                    "place",
                    "county",
                    "cbsa",
                    "fsa",
                    "state",
                    "school_district",
                    "ca_postal",
                    "uspscity"
                  ],
                  "type": "string"
                },
                "default": null,
                "description": "Restrict to these kinds of place. Omit to search all of them."
              },
              "api_key": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "Your ZIP-Codes.com API key, only when you cannot send it as the X-Api-Key or Authorization: Bearer header (for example a key bought with buy_credits in this conversation). Leave it out to use the free tier. It is never shown back in a response."
              },
              "country": {
                "enum": [
                  "US",
                  "CA"
                ],
                "type": "string",
                "default": null,
                "description": "Restrict to one country. Omit to search both."
              }
            }
          },
          "annotations": {
            "title": "Place search (type-ahead)",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "zip_lookup",
          "title": "ZIP Code lookup",
          "description": "The full record for a postal code — the main location-intelligence tool. Takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair, and returns the city, state or province, county, whether it spans more than one county, area codes, elevation, metro area and postal details (metro.msa and metro.pmsa are legacy 1999 definitions; the current metro area, the CBSA, comes with census). A ZIP+4 also returns its delivery-segment street ranges, and coordinates reverse-geocode to the code containing the point. Optional enrichments add timezone, census geography, congressional and state legislative districts (for the current year or any TIGER/Line year served), school districts, demographics, Medicare geography and American Community Survey estimates for every release served, all in one schema per year; for Canadian codes, Statistics Canada geography and federal electoral districts (statcan). Use quick_zip instead when only the code and its place are needed — same inputs, about half the payload, no enrichments beyond timezone. Without an API key the core identity fields are returned and everything else is withheld, with each withheld path named.",
          "inputSchema": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "A US ZIP Code, ZIP+4, Canadian FSA, or Canadian postal code. For example 90210, 90210-1234, M5V, or M5V 2T6."
              },
              "api_key": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "Your ZIP-Codes.com API key, only when you cannot send it as the X-Api-Key or Authorization: Bearer header (for example a key bought with buy_credits in this conversation). Leave it out to use the free tier. It is never shown back in a response."
              },
              "include": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string",
                  "pattern": "^(timezone|census|cd|state_leg|school_district|demographics|medicare|statcan|acs_demographic|acs_social|acs_economic|acs_housing|statcan_(201[16]|2021)|(census|cd|state_leg)_(201\\d|202[0-6])|(acs_demographic|acs_social|acs_economic|acs_housing)_(201[1-9]|202[0-4]))$"
                },
                "default": null,
                "description": "Enrichments, spelled as the REST API's /v2/zip include flags. Each multiplies the credit cost: base times (1 + number of enrichments). census, cd (congressional district) and state_leg are US Census Bureau data; census_YYYY, cd_YYYY, state_leg_YYYY add boundaries as of a TIGER/Line year (the bare flag answers under `current`, other years under their own key). statcan is Canada only: Statistics Canada geography for a Canadian FSA or postal code, federal electoral districts included, under `statcan` (statcan_YYYY for a census year; census or cd on a Canadian code is answered as statcan). acs_PROFILE is the current American Community Survey release, acs_PROFILE_YYYY an earlier one; every ACS year has the SAME FIELD PATHS, so values compare across years directly. At most 16 ACS profile-years per call (one profile for one year is one); split a larger request into several calls. Accepted: timezone, census, cd, state_leg, school_district, demographics, medicare, statcan, acs_demographic, acs_social, acs_economic, acs_housing; statcan_YYYY for YYYY 2011, 2016, 2021; census_YYYY, cd_YYYY, state_leg_YYYY for YYYY 2010-2026; acs_demographic_YYYY, acs_social_YYYY, acs_economic_YYYY, acs_housing_YYYY for YYYY 2011-2024. A bare flag is its newest year."
              },
              "acs_years": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "integer",
                  "maximum": 2024,
                  "minimum": 2011
                },
                "default": null,
                "description": "Alias, kept for clients that learned it before include took year flags: ACS release years for the bare acs_ profiles in include (acs_social with acs_years [2015, 2024] is acs_social_2015 plus acs_social). Prefer the year flags in include. Every year has the SAME FIELD PATHS, and the answer comes back keyed by year. At most 16 profile-years per call. 2011 to 2024 (2024 is the current release)."
              }
            }
          },
          "annotations": {
            "title": "ZIP Code lookup",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "zip_facts",
          "title": "ZIP Code facts",
          "description": "Statistics about US ZIP Codes and Canadian postal codes: how many exist, how they break down by type, delivery point and carrier route totals, per-state tables, and ranked lists such as the ZIP Codes with the most carrier routes. Every figure is generated from a stored query against the source data, with the date it was measured. Costs nothing and needs no key.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          },
          "annotations": {
            "title": "ZIP Code facts",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "quick_zip",
          "title": "Quick ZIP / ZIP+4 / reverse geocode",
          "description": "The fast, small answer for a postal code. Takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair, and returns the code's city, state or province, county, and whether it spans more than one county. Given a ZIP+4 it also returns the street ranges making up that delivery segment; given coordinates it reverse-geocodes to the code containing the point. zip_lookup accepts exactly the same inputs and returns the same ZIP+4 detail — choose this one when the answer only needs to be the code and its place, because the payload is about half the size and only the timezone enrichment is available here. Use zip_lookup for census, demographic, district or American Community Survey enrichments.",
          "inputSchema": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "A US ZIP Code, ZIP+4, Canadian FSA, Canadian postal code, or a latitude,longitude pair. For example 90210, 90210-1234, M5V, M5V 2T6, or 34.10,-118.41."
              },
              "api_key": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "Your ZIP-Codes.com API key, only when you cannot send it as the X-Api-Key or Authorization: Bearer header (for example a key bought with buy_credits in this conversation). Leave it out to use the free tier. It is never shown back in a response."
              },
              "include": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {},
                "default": null,
                "description": "Enrichments to add. Only timezone is available on this tool; use zip_lookup for census, district, demographic and ACS enrichments."
              }
            }
          },
          "annotations": {
            "title": "Quick ZIP / ZIP+4 / reverse geocode",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "city_name_rules",
          "title": "City name rules",
          "description": "How USPS names a ZIP Code, and which of those names may be used on mail. Each ZIP Code has exactly one preferred city name plus alternates, and some alternates are NOT valid for addressing — for 08088 NJ, SHAMONG is valid while SHAMONG TOWNSHIP is not. Returns the rules, the counts and a worked example. Costs nothing and needs no key.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          },
          "annotations": {
            "title": "City name rules",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "buy_credits",
          "title": "Buy credits",
          "description": "Buy a credit pack with a wallet that pays MPP (Machine Payments Protocol) challenges, such as Stripe Link. The credits go on the account or prepaid card of the API key you send. Without a key, the purchase makes a prepaid card: a new API key holding the credits, in the result's api_key; pass it as api_key on later calls, and keep it (it is shown again only while the card is unused, for 24 hours). Name the pack by pack, price_usd or credits (the packs: https://api.zip-codes.com/pricing.json). The first call answers Payment Required (-32042) with a challenge for that pack and charges nothing; a wallet that pays it sends the same call again with its credential and gets the purchase back: its purchase_id, the credits added and a receipt. The same payment sent again is never charged twice. A payment still clearing reads processing, with no credits yet: send the same call again later. Without a wallet, ask your human to buy at https://www.zip-codes.com/api/pricing. By paying you accept the Terms of Service: https://www.zip-codes.com/api/tos",
          "inputSchema": {
            "type": "object",
            "properties": {
              "pack": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "The pack name from pricing.json, any case, for example Mini."
              },
              "api_key": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "Your ZIP-Codes.com API key, only when you cannot send it as the X-Api-Key or Authorization: Bearer header (for example a key bought with buy_credits in this conversation). Leave it out to use the free tier. It is never shown back in a response."
              },
              "credits": {
                "type": [
                  "integer",
                  "null"
                ],
                "default": null,
                "description": "The pack's credits, for example 6250."
              },
              "price_usd": {
                "type": [
                  "number",
                  "null"
                ],
                "default": null,
                "description": "The pack's price in US dollars, for example 5."
              }
            }
          },
          "annotations": {
            "title": "Buy credits",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "radius_search",
          "title": "Radius search",
          "description": "Find every US ZIP Code and Canadian postal area within a radius of a centre point, with the distance to each. The centre takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair; a ZIP+4 searches from its parent ZIP, and coordinates are used as the point itself, so the centre comes back with no code. Centroid mode measures centre to centre and reaches 500 miles; spatial mode intersects real boundaries, reports how much of each area falls inside, and reaches 250 miles. Set a minimum radius to search a ring rather than a circle. summary.total_count is the number of matches returned; when the list is cut, summary.total_available is the number in the radius and a notice says so. ACS statistics always cover the whole radius. They are aggregates of the ZIP Codes' estimates: est and pct only, with no margin of error or Census column; for one ZIP Code's estimate with its margin of error, use zip_lookup. timezone and ACS come back with the search itself; only census and district data need zip_lookup per ZIP. Without an API key the count and a sample of matches are returned and the rest is withheld; free-tier keys are capped at 100 miles centroid and 50 spatial.",
          "inputSchema": {
            "type": "object",
            "required": [
              "code",
              "max"
            ],
            "properties": {
              "max": {
                "type": "string",
                "description": "Radius in miles, as a number or a string. Up to 500 in centroid mode or 250 in spatial mode; exceeding the cap is an error rather than being reduced. May also be 'auto' to pick a radius from local population density, or 'auto-commute' to use commuting patterns where available."
              },
              "min": {
                "type": [
                  "number",
                  "null"
                ],
                "default": null,
                "description": "Minimum radius in miles, to exclude the middle and search a ring. Must be less than max. Defaults to 0."
              },
              "code": {
                "type": "string",
                "description": "Centre point: a US ZIP Code, ZIP+4, Canadian FSA or postal code, or a latitude,longitude pair."
              },
              "mode": {
                "enum": [
                  "centroid",
                  "spatial"
                ],
                "type": "string",
                "default": null,
                "description": "How to measure. centroid measures centre to centre and is the default when omitted; spatial intersects actual boundaries and adds how much of each area lies inside, at a lower maximum radius."
              },
              "limit": {
                "type": [
                  "integer",
                  "null"
                ],
                "default": null,
                "description": "Maximum number of matches to return, up to 100, which is also the default. A larger value is reduced to 100 and the result says so in notices. When the list is cut, summary.total_available is the number of matches in the radius (summary.total_count is the number returned) and a RESULTS_CAPPED notice says so; to see matches beyond the first 100, narrow the radius or raise `min` to step outwards in bands."
              },
              "api_key": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "Your ZIP-Codes.com API key, only when you cannot send it as the X-Api-Key or Authorization: Bearer header (for example a key bought with buy_credits in this conversation). Leave it out to use the free tier. It is never shown back in a response."
              },
              "include": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string",
                  "pattern": "^(timezone|acs_demographic|acs_social|acs_economic|acs_housing|(acs_demographic|acs_social|acs_economic|acs_housing)_(201[1-9]|202[0-4]))$"
                },
                "default": null,
                "description": "Enrichments, spelled as the REST API's /v2/radius include flags; each multiplies the credit cost. timezone lands on each match. acs_PROFILE (current release) and acs_PROFILE_YYYY return aggregate statistics across the whole result set, with the same field paths every year. Census and district enrichments are not available here; use zip_lookup. At most 16 ACS profile-years per call (one profile for one year is one); split a larger request into several calls. Accepted: timezone, acs_demographic, acs_social, acs_economic, acs_housing; acs_demographic_YYYY, acs_social_YYYY, acs_economic_YYYY, acs_housing_YYYY for YYYY 2011-2024. A bare flag is its newest year."
              },
              "acs_years": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "integer",
                  "maximum": 2024,
                  "minimum": 2011
                },
                "default": null,
                "description": "Alias, kept for clients that learned it before include took year flags: ACS release years for the bare acs_ profiles in include (acs_social with acs_years [2015] is acs_social_2015). Prefer the year flags in include. At most 16 profile-years per call. 2011 to 2024 (2024 is the current release)."
              }
            }
          },
          "annotations": {
            "title": "Radius search",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "about_data",
          "title": "About this data",
          "description": "Where this server's data comes from: for each dataset the authority behind it, the edition served where the source publishes editions (TIGER/Line, ACS, ZCTA), how often a new release is taken, and a ready-made citation string. Costs nothing and needs no key.",
          "inputSchema": {
            "type": "object",
            "properties": {}
          },
          "annotations": {
            "title": "About this data",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "distance",
          "title": "Distance between two places",
          "description": "Distance between two places, in miles and kilometres, plus the compass bearing from the first to the second. Each end takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair, and the two ends can be different kinds — a US ZIP to a Canadian postal code works, and so does a code to a coordinate. Time zone for both ends is included. This is a straight-line distance, not a driving route. Without an API key the distance itself is returned and the geography behind it is withheld.",
          "inputSchema": {
            "type": "object",
            "required": [
              "from",
              "to"
            ],
            "properties": {
              "to": {
                "type": "string",
                "description": "Destination, in any of the same forms as the origin."
              },
              "from": {
                "type": "string",
                "description": "Origin: a ZIP Code, ZIP+4, Canadian FSA or postal code, or latitude,longitude. For example 90210, M5V 2T6, or 34.10,-118.41."
              },
              "api_key": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "Your ZIP-Codes.com API key, only when you cannot send it as the X-Api-Key or Authorization: Bearer header (for example a key bought with buy_credits in this conversation). Leave it out to use the free tier. It is never shown back in a response."
              }
            }
          },
          "annotations": {
            "title": "Distance between two places",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "validate_address",
          "title": "Validate a US address",
          "description": "Validate and standardise a US street address and return its ZIP+4. US ONLY — unlike the postal-code tools, this does not cover Canada. Send the address on one line in mailing order: number and street, then any unit (APT 4, STE 900, #9), then city, state and ZIP. It tolerates ordinary slips (a misspelling, a missing ZIP, state or directional), but it is not a puzzle to solve: a unit placed after the city or ZIP (\"Pensacola FL #9\") is ambiguous, a unit or a floor. Send what the user gave you, in proper order, once. If it does not match, report that; do not keep trying rewrites. Returns the address in USPS standard form split into its parts, the 5-digit ZIP and the +4 add-on, a confidence level of high, medium or low (low: the +4 may be withheld), and the county, carrier route, congressional district and census block group for the match, all for one credit. `include` appends more, one credit each: coordinates, the census geographies the address sits inside, its congressional and state legislative districts (now or as of any TIGER/Line year served), its school district, its time zone, and American Community Survey profiles for its census tract. The congressional district already in `details` is USPS's own code for the record; the `cd` append is the mapped district, with its number, name and the congress it belongs to. Always read `notices`. ZIP_CORRECTED means the match is in a different ZIP than the one supplied. SECONDARY_NEEDED means the building has multiple units and an apartment or suite number should be requested. SECONDARY_NOT_VERIFIED means a supplied unit could not be confirmed against known ranges. PARTIAL_MATCH means some details are unverified. A failed match returns success false, sometimes with no notice explaining why, so check success rather than assuming the data block is populated. Without an API key the standardised address is returned with the +4 masked.",
          "inputSchema": {
            "type": "object",
            "required": [
              "address"
            ],
            "properties": {
              "address": {
                "type": "string",
                "description": "The address on one line. A city and state, or a ZIP Code, helps but neither is required — '1600 Pennsylvania Ave NW, Washington DC' and '1600 Pennsylvania Ave NW 20500' both resolve. Between 9 and 300 characters once spacing is normalised."
              },
              "api_key": {
                "type": [
                  "string",
                  "null"
                ],
                "default": null,
                "description": "Your ZIP-Codes.com API key, only when you cannot send it as the X-Api-Key or Authorization: Bearer header (for example a key bought with buy_credits in this conversation). Leave it out to use the free tier. It is never shown back in a response."
              },
              "include": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "string",
                  "pattern": "^(coordinates|census|cd|state_leg|school_district|timezone|acs_tract_demographic|acs_tract_social|acs_tract_economic|acs_tract_housing|(census|cd|state_leg)_(201\\d|202[0-6])|(acs_tract_demographic|acs_tract_social|acs_tract_economic|acs_tract_housing)_(201[1-9]|202[0-4]))$"
                },
                "default": null,
                "description": "Data to append to the match, spelled exactly as the REST API's /v2/address include flags, each costing one extra credit. 'coordinates' adds the latitude and longitude. 'census' adds the county, county subdivision, place, tract, block group, ZCTA and CBSA the address falls in; 'cd' adds its congressional district; 'state_leg' adds its upper and lower state legislative districts; 'school_district' adds its school district; 'timezone' adds the time zone at the matched point. census_YYYY, cd_YYYY and state_leg_YYYY add those boundaries as of a TIGER/Line year (the bare flag is the newest year, answered under `current`; other years under their own key). The 'acs_tract_*' values add an American Community Survey 5-year profile for the address's census tract: four profiles (demographic, social, economic, housing), unsuffixed for the current release or acs_tract_PROFILE_YYYY for an earlier one, in one schema, so a tract can be compared across years. At most 16 ACS profile-years per call (one profile for one year is one); split a larger request into several calls. Accepted: coordinates, census, cd, state_leg, school_district, timezone, acs_tract_demographic, acs_tract_social, acs_tract_economic, acs_tract_housing; census_YYYY, cd_YYYY, state_leg_YYYY for YYYY 2010-2026; acs_tract_demographic_YYYY, acs_tract_social_YYYY, acs_tract_economic_YYYY, acs_tract_housing_YYYY for YYYY 2011-2024. A bare flag is its newest year."
              }
            }
          },
          "annotations": {
            "title": "Validate a US address",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "county_reference",
          "title": "County reference",
          "description": "US counties and county equivalents — all 3,235 of them — with their Census and USPS names, which disagree for over a hundred, plus ANSI code, legal type, land and water area, and USPS delivery footprint. Filter by state to get every county in that state: without a filter only the first 25 are returned, and they are FIPS-ordered, so an unfiltered call answers with Alabama rather than with whatever was asked about. Costs nothing and needs no key.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": [
                  "integer",
                  "null"
                ],
                "default": null,
                "description": "Cap the number of counties returned. Defaults to 25 when no state is given, or to all of them when one is."
              },
              "state": {
                "enum": [
                  "AK",
                  "AL",
                  "AR",
                  "AS",
                  "AZ",
                  "CA",
                  "CO",
                  "CT",
                  "DC",
                  "DE",
                  "FL",
                  "GA",
                  "GU",
                  "HI",
                  "IA",
                  "ID",
                  "IL",
                  "IN",
                  "KS",
                  "KY",
                  "LA",
                  "MA",
                  "MD",
                  "ME",
                  "MI",
                  "MN",
                  "MO",
                  "MP",
                  "MS",
                  "MT",
                  "NC",
                  "ND",
                  "NE",
                  "NH",
                  "NJ",
                  "NM",
                  "NV",
                  "NY",
                  "OH",
                  "OK",
                  "OR",
                  "PA",
                  "PR",
                  "RI",
                  "SC",
                  "SD",
                  "TN",
                  "TX",
                  "UT",
                  "VA",
                  "VI",
                  "VT",
                  "WA",
                  "WI",
                  "WV",
                  "WY"
                ],
                "type": "string",
                "default": null,
                "description": "Two-letter US state or territory code. Returns EVERY county in that state, so no limit is needed — Texas is the largest at 254. Omit to browse all states."
              }
            }
          },
          "annotations": {
            "title": "County reference",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "metro_area_reference",
          "title": "Metro area reference",
          "description": "US metropolitan and micropolitan statistical areas (CBSAs) — all 935. Of those only 393 are metropolitan; the rest are micropolitan and are NOT metro areas, so do not treat a CBSA count as a metro count. Each carries its divisions, parent combined area, land area and delivery footprint, plus the CMS Medicare labor market area, which is a DIFFERENT geography that shares the same code space. Filter by state to get every area in that state: without a filter only the first 25 are returned, alphabetically, so an unfiltered call answers with Aberdeen. Costs nothing and needs no key.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": [
                  "integer",
                  "null"
                ],
                "default": null,
                "description": "Cap the number of areas returned. Defaults to 25 when no state is given, or to all areas in the state when one is."
              },
              "state": {
                "enum": [
                  "AK",
                  "AL",
                  "AR",
                  "AS",
                  "AZ",
                  "CA",
                  "CO",
                  "CT",
                  "DC",
                  "DE",
                  "FL",
                  "GA",
                  "GU",
                  "HI",
                  "IA",
                  "ID",
                  "IL",
                  "IN",
                  "KS",
                  "KY",
                  "LA",
                  "MA",
                  "MD",
                  "ME",
                  "MI",
                  "MN",
                  "MO",
                  "MP",
                  "MS",
                  "MT",
                  "NC",
                  "ND",
                  "NE",
                  "NH",
                  "NJ",
                  "NM",
                  "NV",
                  "NY",
                  "OH",
                  "OK",
                  "OR",
                  "PA",
                  "PR",
                  "RI",
                  "SC",
                  "SD",
                  "TN",
                  "TX",
                  "UT",
                  "VA",
                  "VI",
                  "VT",
                  "WA",
                  "WI",
                  "WV",
                  "WY"
                ],
                "type": "string",
                "default": null,
                "description": "Two-letter US state or territory code. Returns every area that includes that state — an area can span several, so it is matched against the area's whole state list. Omit to browse all states."
              }
            }
          },
          "annotations": {
            "title": "Metro area reference",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": []
    },
    "instructions": "zip-codes.com: US and Canadian postal and census geography, demographics and ACS data for an address, ZIP, ZIP+4, Canadian FSA or postal code, or latitude/longitude.\n\n**Withheld is not missing.** Without an API key some values are withheld: text reads `*` to `*****`, numbers and true/false read `null`. Those are not the real values: never report one as the answer or as \"no data\"; say an API key returns it. Only a response carrying `meta.demo` has withheld values; in production it means no key reached us: a configuration error, not an answer. Demo ZIPs and addresses answer in full without a key; test with others.\n\n**Choosing a tool.** `zip_lookup` for everything attached to a code; `validate_address` for a US street address; `radius_search` for codes near one; `distance` between two places; `suggest_places` to resolve a vague or misspelled name first. Enrichments are opt-in and each adds credits: ask only for what you need. Free, no key, no REST equivalent: `about_data` (sources: cite it, don't assume currency), `zip_facts` (counts), `city_name_rules`, `county_reference`, `metro_area_reference`.\n\n**Free tier.** Every tool answers without a key with real, current data, not a sample: use shown values as keyed ones. Keyed JSON shape; a cut list has a `*_truncated` marker and its full count in `summary`; `meta.demo.withheld_count` counts them. With a key nothing is withheld, and `null` means no data exists. Never guess a withheld value or take it from another source. A free key gives 2,500 credits a day: <https://www.zip-codes.com/api/signup>. `buy_credits` pays via Stripe MPP (e.g. Link); with no key it mints a prepaid card (key in `api_key`). No wallet: ask your human.\n\n**One place per call.** With a key, follow-up calls are fine (a lookup per radius match) within your credits and per-minute limit (60 free, 300 to 600 on plans or packs). Without one, keep to a few calls per question. Long lists: the REST API's batch endpoints (plan or purchased credits; not exposed here): `POST /v2/{zip,quick-zip,radius,distance}/batch` (100 items), `/v2/address/batch` (250); no suggest batch. Bodies: <https://api.zip-codes.com/llms.txt>.\n\n**USPS and the ground.** ZIP Codes follow mail routes, not political lines. USPS's assignments (a ZIP's `state`, `county`, `multi_county` from its ZIP+4 counties; an address's `details.county`, `details.congressional_district`) are what USPS-based systems show, set by local post offices and sometimes wrong; USPS's county need not cover most of the ZIP. `census`, `cd`, `state_leg`, `school_district`, `timezone` intersect the ZIP's area with official boundaries. When they disagree, report both. `pct_of_zip` and `pct_of_area` are shares of area, not of addresses or people; a ZIP can cross any line, state lines too; a small `pct_of_zip` may hold few or no addresses.\n\n**Boundary years.** Bare `census`, `cd`, `state_leg`, or the newest TIGER/Line year (`cd_2026` today), answer under `current`; `census_2015`, `cd_2020` etc. give any year from 2010. Across years compare `districts` (legal boundaries), not an address's `primary`: newest-year `primary` is USPS's ZIP+4 assignment.\n\n**ACS.** Four profiles, 2011 to 2024, identical field paths in every year and level (ZIP areas, tracts): compare directly. Each field but radius aggregates carries its Census table and column. `pct` is Census's percent column: a share of its total, the count on a total row, null where Census gives none (per capita income). Unemployment and poverty rates are in `pct`, vacancy rates in `est` (the other null). A radius `coverage_pct` under 100 is normal: point ZIPs (PO Box, unique) have no area; their residents count in surrounding ZIPs.\n\n**The data.** Rebuilt monthly from USPS. ZIP+4s and delivery points move between ZIPs, so a ZIP's counties and multi-county status can change monthly; boundaries follow carrier routes. ZIPs absent from Census ZCTA files (PO Box, single-organization) are here.\n\nDocs <https://www.zip-codes.com/api/> · OpenAPI <http"
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}