# hyperionxmota/cook-county-property-mcp [Health: Active]

**Category:** 🏠 Real Estate  
**Repository:** https://github.com/hyperionxmota/cook-county-property-mcp  
**GitHub Stars:** 0  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/hyperionxmota-cook-county-property-mcp

## Description
Cook County / Chicago property records — parcels, recorded sales, building permits, tax assessments, and comparable sales by street address or PIN. Hosted remote MCP, pay-per-call via x402 (USDC on Base/Solana).

## Tools
Capabilities this server exposes over MCP:

- **get_free_sample** — FREE ($0, unlimited, no payment, no wallet): a fixed, representative
example of every response shape this server returns for Cook County /
Chicago property data — address search, parcel, dossier (recorded sales,
building permits, assessment history) and comparable sales. Call this
FIRST to validate the data structure before anything else. For REAL
verified data at $0, call get_cook_county_property_dossier with one of
the always-free example PINs 09253060510000, 09253140190000,
09253050270000.
- **search_chicago_property_by_address** — ALWAYS FREE, unlimited, no wallet and no signup. Resolve a Cook County
/ Chicago street address (full or partial) to its parcel PIN(s) — ranked
candidates with address, city, ZIP, a match score and a match_quality
flag. A trailing city/state/ZIP is fine ('1 E 113th St, Chicago, IL
60628'). CHECK match_quality: 'exact' is certain, 'likely' shares the
house number, and 'weak' means NO candidate matched the house number —
do not rely on a weak hit. Call this FIRST when you have an address but
not a PIN, then pass a returned pin to get_cook_county_parcel /
get_cook_county_property_dossier / find_chicago_comparable_sales.
Coverage: Cook County, Illinois — Chicago plus 100+ suburbs including
Evanston, Oak Park, Cicero and Skokie.
- **get_cook_county_parcel** — FREE for your first 100 calls each day — no wallet, no signup, just
call it ($0.01 per call via x402/USDC only after that daily allowance,
which resets at 00:00 UTC). Cook County, IL parcel record for a 10- or
14-digit PIN. Returns: pin, prop_address, prop_city, prop_zip, class,
township_name, nbhd_code, municipality, ward, police_district,
census_tract_geoid, school_elementary_district,
school_secondary_district, walk_score_cmap, airport_noise_dnl, lat, lon,
tax_year. The cheap single-property lookup — use
get_cook_county_property_dossier for sales, permits and assessments.
- **get_cook_county_property_dossier** — FREE for your first 100 calls each day — no wallet, no signup, just
call it ($0.03 per call via x402/USDC only after that daily allowance,
which resets at 00:00 UTC). Full Cook County / Chicago property dossier
for a PIN: parcel basics, recorded sales & deed history, building
permits, property-tax assessment history, and neighborhood / ward /
school / walkability context — the one-call due-diligence record.
Permits are LINKED to the PIN here (the raw permit open-data has no PIN;
links are derived by address + geo match), so this is a finished record
you cannot reproduce with raw open-data queries. Note assessment values
are ASSESSED values (~10% of market for most residential classes), not
market prices — see assessment_note in the response.
- **find_chicago_comparable_sales** — FREE for your first 100 calls each day — no wallet, no signup, just
call it ($0.10 per call via x402/USDC only after that daily allowance,
which resets at 00:00 UTC). Recent arm's-length comparable sales (comps)
in the same Cook County assessor neighborhood and property class as the
given PIN, each with its distance in metres from the subject, plus an
implied low/median/high price range — a derived, lightweight automated
valuation (AVM) you won't get from a raw open-data query. Thin markets
widen automatically and the response reports which matching rung was
used. Comps are NOT normalized for building size or age.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "cook-county-property-mcp": {
    "url": "https://api.ingest0r.com/mcp"
  }
}
```

## Documentation

## What hyperionxmota/cook-county-property-mcp MCP server does

hyperionxmota/cook-county-property-mcp MCP server exposes public property data for Cook County, Illinois, including Chicago and more than 100 suburbs. Its records cover roughly 1.9 million parcels and are refreshed nightly from Cook County Assessor, Cook County Recorder of Deeds, and City of Chicago Socrata datasets.

The service is designed to return joined, property-focused answers rather than isolated open-data rows. A dossier can combine parcel attributes, recorded sales and deed history, building permits, tax assessment history, and neighborhood context. The data is property-keyed and does not include owner or occupant personal data.

## How it works

Start with `search_chicago_property_by_address` when you have an address but no PIN. It returns ranked parcel candidates with address details, a match score, and a `match_quality` value. Treat `exact` as a confident match, `likely` as a shared-house-number match, and `weak` as unsuitable for relying on the result.

Pass a selected 10- or 14-digit PIN to the parcel, dossier, or comparable-sales tools. `get_cook_county_parcel` provides a focused record, while the dossier assembles related sales, permits, assessments, and geographic context. Permit-to-PIN relationships are derived from address and geographic matching because the underlying permit data does not contain PINs.

## Setup and configuration

The hyperionxmota/cook-county-property-mcp MCP server is hosted remotely at `https://api.ingest0r.com/mcp` using streamable HTTP, so there is no local package to install. Add the endpoint to an MCP-compatible client. No signup or API key is required.

Free access includes the sample tool and address search without a wallet. The parcel, dossier, and comparable-sales routes provide the first 100 calls per day at no charge; after that allowance, they return x402 payment terms. Paid calls cost $0.01 for a parcel, $0.03 for a dossier, and $0.10 for comparable sales, payable in USDC on Base or Solana. The daily allowance resets at 00:00 UTC.

## Tools and capabilities

- `get_free_sample`: Returns fixed examples covering address search, parcel data, dossiers, and comparable sales. Use it to inspect response shapes before making other requests.
- `search_chicago_property_by_address`: Resolves full or partial Cook County addresses to ranked PIN candidates.
- `get_cook_county_parcel`: Returns parcel location, classification, township, municipal, district, school, walkability, airport-noise, coordinate, and tax-year fields.
- `get_cook_county_property_dossier`: Returns a consolidated property record with sales, deeds, permits, assessments, and local context.
- `find_chicago_comparable_sales`: Finds recent arm's-length sales in the same assessor neighborhood and property class, then reports distances and an implied low, median, and high range.

## Limitations and notes

Comparable sales are not normalized for building size or age. Thin markets cause the matching criteria to widen, and the response identifies which matching rung was used. Assessment figures are assessed values, not market prices; for most residential classes they are approximately 10% of market value, and the response includes an assessment note.

The address-to-PIN workflow depends on match quality, so weak candidates should not be used for downstream research. The comparable-sales output is a lightweight derived valuation, not a formal appraisal. Calls beyond the free daily allowance require x402-compatible USDC payment.

_Full upstream README: https://allmcps.com/mcp/hyperionxmota-cook-county-property-mcp/readme_