PermitStack is an MCP server published by com.permit-stack, hosted at mcp.permit-stack.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 18 tools, including search_permits, get_permit, get_property_history, search_contractors, get_contractor_permits.
U.S. building permits, permit histories by address and contractors from city and county records.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Search U.S. building permits by location (city, state, ZIP code, or a lat/lng radius), category, status, property type, filing or issue date range, estimated project value, contractor name, or free text. Returns up to 25 permits per call with address, dates, category, status, estimated value, contractor and description, plus the total number of matches. Response fields: `total` is exact unless `total_capped` is true, in which case it is a lower bound; when `total_unknown` is true the count could not be computed and `total` is null. `account_window_clamped`, `account_window_days` and `account_window_from` are set when the connected account covers a limited date range, and the results then cover only that range. Category HVAC also matches MECHANICAL, and MECHANICAL also matches HVAC. date_after/date_before match whichever date a permit has (issued, else filed), for feeds that publish only one of the two. Results carry no property owner name, owner mailing address or permit applicant name fields.
| Parameter | Type | Description |
|---|---|---|
| q | string | Free-text search over description, address, and permit number |
| lat | number | Latitude for radius search (use with lng) |
| lng | number | Longitude for radius search (use with lat) |
| city | string | City name, e.g. 'Austin', 'Boston', 'Miami-Dade County' |
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| state | string | Two-letter US state code, e.g. 'TX', 'MA', 'FL' |
| status | string | Permit status, e.g. 'ISSUED', 'FINAL', 'EXPIRED', 'FILED' |
| category | string | Permit category (case-insensitive). Common values: SOLAR, ROOFING, HVAC, NEW_CONSTRUCTION, POOL, ELECTRICAL, PLUMBING, DEMOLITION, MECHANICAL, RENOVATION. |
| per_page | integer | Results per page (default 25, max 25) |
| zip_code | string | 5-digit ZIP code |
| max_value | number | Maximum estimated project value in dollars |
| min_value | number | Minimum estimated project value in dollars |
| date_after | string | ISO date (YYYY-MM-DD): only permits dated on or after this date, using the issue date, else the filing date |
| date_before | string | ISO date (YYYY-MM-DD): only permits dated on or before this date, using the issue date, else the filing date |
| filed_after | string | ISO date (YYYY-MM-DD): only permits filed on or after this date |
| filed_before | string | ISO date (YYYY-MM-DD): only permits filed on or before this date |
| issued_after | string | ISO date (YYYY-MM-DD): only permits issued on or after this date |
| jurisdiction | string | Jurisdiction name or partial name, e.g. 'Wake County', 'Tacoma' |
| radius_miles | number | Radius in miles for lat/lng search (max 50, default 5) |
| issued_before | string | ISO date (YYYY-MM-DD): only permits issued on or before this date |
| property_type | string | Property type, one of: residential, commercial, industrial, mixed_use, institutional, unknown (case-insensitive) |
| contractor_name | string | Filter by contractor name (partial match supported) |
{
"name": "search_permits",
"title": "Search building permits",
"description": "Search U.S. building permits by location (city, state, ZIP code, or a lat/lng radius), category, status, property type, filing or issue date range, estimated project value, contractor name, or free text. Returns up to 25 permits per call with address, dates, category, status, estimated value, contractor and description, plus the total number of matches. Response fields: `total` is exact unless `total_capped` is true, in which case it is a lower bound; when `total_unknown` is true the count could not be computed and `total` is null. `account_window_clamped`, `account_window_days` and `account_window_from` are set when the connected account covers a limited date range, and the results then cover only that range. Category HVAC also matches MECHANICAL, and MECHANICAL also matches HVAC. date_after/date_before match whichever date a permit has (issued, else filed), for feeds that publish only one of the two. Results carry no property owner name, owner mailing address or permit applicant name fields.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Free-text search over description, address, and permit number"
},
"lat": {
"type": "number",
"description": "Latitude for radius search (use with lng)"
},
"lng": {
"type": "number",
"description": "Longitude for radius search (use with lat)"
},
"city": {
"type": "string",
"description": "City name, e.g. 'Austin', 'Boston', 'Miami-Dade County'"
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"state": {
"type": "string",
"description": "Two-letter US state code, e.g. 'TX', 'MA', 'FL'"
},
"status": {
"type": "string",
"description": "Permit status, e.g. 'ISSUED', 'FINAL', 'EXPIRED', 'FILED'"
},
"category": {
"type": "string",
"description": "Permit category (case-insensitive). Common values: SOLAR, ROOFING, HVAC, NEW_CONSTRUCTION, POOL, ELECTRICAL, PLUMBING, DEMOLITION, MECHANICAL, RENOVATION."
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"zip_code": {
"type": "string",
"description": "5-digit ZIP code"
},
"max_value": {
"type": "number",
"description": "Maximum estimated project value in dollars"
},
"min_value": {
"type": "number",
"description": "Minimum estimated project value in dollars"
},
"date_after": {
"type": "string",
"description": "ISO date (YYYY-MM-DD): only permits dated on or after this date, using the issue date, else the filing date"
},
"date_before": {
"type": "string",
"description": "ISO date (YYYY-MM-DD): only permits dated on or before this date, using the issue date, else the filing date"
},
"filed_after": {
"type": "string",
"description": "ISO date (YYYY-MM-DD): only permits filed on or after this date"
},
"filed_before": {
"type": "string",
"description": "ISO date (YYYY-MM-DD): only permits filed on or before this date"
},
"issued_after": {
"type": "string",
"description": "ISO date (YYYY-MM-DD): only permits issued on or after this date"
},
"jurisdiction": {
"type": "string",
"description": "Jurisdiction name or partial name, e.g. 'Wake County', 'Tacoma'"
},
"radius_miles": {
"type": "number",
"description": "Radius in miles for lat/lng search (max 50, default 5)"
},
"issued_before": {
"type": "string",
"description": "ISO date (YYYY-MM-DD): only permits issued on or before this date"
},
"property_type": {
"type": "string",
"description": "Property type, one of: residential, commercial, industrial, mixed_use, institutional, unknown (case-insensitive)"
},
"contractor_name": {
"type": "string",
"description": "Filter by contractor name (partial match supported)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search building permits",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Look up a permit by the permit number assigned by the issuing jurisdiction, optionally narrowed by city and state. The number is matched exactly (ignoring case), and the same number can exist in several jurisdictions, so up to 5 matching permits are returned; give the city or state to tell them apart. If nothing matches exactly and a city or state was given, permits in that place whose number contains the text are returned instead, and `match` says "partial". When the connected account covers a limited date range, `account_window_from` is set and only permits from that date onward are searched. Results carry no property owner name, owner mailing address or permit applicant name fields.
| Parameter | Type | Description |
|---|---|---|
| city | string | City where the permit was issued (optional, narrows the match) |
| state | string | Two-letter state code (optional, narrows the match) |
| permit_number * | string | The permit number from the issuing jurisdiction |
{
"name": "get_permit",
"title": "Look up a permit by number",
"description": "Look up a permit by the permit number assigned by the issuing jurisdiction, optionally narrowed by city and state. The number is matched exactly (ignoring case), and the same number can exist in several jurisdictions, so up to 5 matching permits are returned; give the city or state to tell them apart. If nothing matches exactly and a city or state was given, permits in that place whose number contains the text are returned instead, and `match` says \"partial\". When the connected account covers a limited date range, `account_window_from` is set and only permits from that date onward are searched. Results carry no property owner name, owner mailing address or permit applicant name fields.",
"inputSchema": {
"type": "object",
"required": [
"permit_number"
],
"properties": {
"city": {
"type": "string",
"description": "City where the permit was issued (optional, narrows the match)"
},
"state": {
"type": "string",
"description": "Two-letter state code (optional, narrows the match)"
},
"permit_number": {
"type": "string",
"description": "The permit number from the issuing jurisdiction"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Look up a permit by number",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Permit history for one property, looked up by street address (house number and street name, e.g. '123 Main St'). Optional city, state and ZIP narrow the match when the same street address exists in several places. Returns a property profile (permit timeline, category breakdown, contractors) and up to 25 permit records per page, newest first; `has_more` says whether the next page has more. Covers all permit categories. When the connected account covers a limited date range, the profile and records cover only that range, `account_window_from` is set, and `_notes` says so: the result is then not the property's full permit history. Results carry no property owner name, owner mailing address or permit applicant name fields.
| Parameter | Type | Description |
|---|---|---|
| zip | string | Optional ZIP code (prefix-matched) |
| city | string | Optional city, to tell identical street addresses apart |
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| state | string | Optional two-letter state code |
| address * | string | Street address with house number, e.g. '123 Main St' (min 3 characters) |
| per_page | integer | Results per page (default 25, max 25) |
Search contractors by name, city, state or specialty. Returns up to 25 contractors per call with the contractor UUID, name, licence number and licence state, home city and state, total permit count, first and last permit dates, specialties and activity score (0-100), sorted by activity score (highest first). Project values are not included; get_contractor_permits lists a contractor's permits with their estimated values.
| Parameter | Type | Description |
|---|---|---|
| city | string | City where the contractor has worked |
| name | string | Contractor name (partial match) |
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| state | string | Two-letter state code |
| per_page | integer | Results per page (default 25, max 25) |
| specialty | string | Specialty/trade to filter by, e.g. 'solar', 'roofing', 'hvac' |
| min_permits | integer | Only contractors with at least this many permits |
List the permits pulled by one contractor, identified by the contractor UUID from search_contractors. Returns up to 25 permits per page with the contractor's work history fields (dates, categories, values). Results carry no property owner name, owner mailing address or permit applicant name fields.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| per_page | integer | Results per page (default 25, max 25) |
| contractor_id * | string | Contractor UUID from search_contractors results |
{
"name": "get_contractor_permits",
"title": "Contractor's permits",
"description": "List the permits pulled by one contractor, identified by the contractor UUID from search_contractors. Returns up to 25 permits per page with the contractor's work history fields (dates, categories, values). Results carry no property owner name, owner mailing address or permit applicant name fields.",
"inputSchema": {
"type": "object",
"required": [
"contractor_id"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"contractor_id": {
"type": "string",
"description": "Contractor UUID from search_contractors results"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Contractor's permits",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Describe PermitStack's coverage: total permits, jurisdictions (active, archive, frozen) and states. On a signed-in connection it also lists covered jurisdictions with their permit counts, county and `data_through` (the date of the newest permit held), filterable by state and by name, up to 25 per call, largest first. Without sign-in it returns the platform totals only.
| Parameter | Type | Description |
|---|---|---|
| name | string | Optional text matched against jurisdiction names, e.g. 'Austin' or 'County' |
| state | string | Optional two-letter state code to list only that state's jurisdictions |
{
"name": "get_coverage",
"title": "Data coverage",
"description": "Describe PermitStack's coverage: total permits, jurisdictions (active, archive, frozen) and states. On a signed-in connection it also lists covered jurisdictions with their permit counts, county and `data_through` (the date of the newest permit held), filterable by state and by name, up to 25 per call, largest first. Without sign-in it returns the platform totals only.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Optional text matched against jurisdiction names, e.g. 'Austin' or 'County'"
},
"state": {
"type": "string",
"description": "Optional two-letter state code to list only that state's jurisdictions"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Data coverage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search inspection logs by place, permit, type, result and date. Summaries and future scheduled inspections are excluded by default; upcoming and summaries opt in. Sources report data_through. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.
| Parameter | Type | Description |
|---|---|---|
| city | string | City name (matches the address city or the issuing jurisdiction) |
| page | integer | Page number, 1-based (default 1) |
| scope | string | permit (default): inspections of permitted work. existing / occupancy: occupancy inspections of existing buildings that no permit asked for; all. |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| state | string | 2-letter state code |
| trade | string | one of ["BUILDING","ELECTRICAL","PLUMBING","MECHANICAL","FIRE","OTHER"] |
| parcel | string | Parcel / APN / folio (formatting ignored) |
| result | string | PASS, FAIL, PARTIAL, CANCELLED, SCHEDULED or OTHER |
| address |
List inspections linked to a permit UUID. Future scheduled inspections are excluded by default unless result=SCHEDULED or upcoming opts in. An empty list means no linked inspection is held. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| result | string | one of ["PASS","FAIL","PARTIAL","CANCELLED","SCHEDULED","OTHER"] |
| per_page | integer | Results per page (default 25, max 25) |
| upcoming | string | Future-dated (still scheduled) inspections: exclude (the default, except with result=SCHEDULED), include, or only (soonest first). |
| permit_id * | string | |
| summaries | string | one of ["exclude","include","only"] |
Search agency findings by place, case number, status, category and date. record_kind defaults to violation; complaints are reports, not confirmed violations. Sources report data_through, coverage_window and count_unit. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.
| Parameter | Type | Description |
|---|---|---|
| lat | number | |
| lng | number | |
| city | string | City name (matches the address city or the issuing jurisdiction) |
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| state | string | 2-letter state code |
| parcel | string | Parcel / APN / folio / BBL (formatting ignored) |
| status | string | OPEN, CLOSED, COMPLIED, ABATED, CITED, DISMISSED or UNKNOWN |
| address | string | Street address, partial, case-insensitive |
Get a violation or complaint by UUID, including source status and related copies. A complaint is not a confirmed violation. Coverage and published fines vary by source.
| Parameter | Type | Description |
|---|---|---|
| violation_id * | string |
{
"name": "get_violation",
"title": "Code violation or complaint",
"description": "Get a violation or complaint by UUID, including source status and related copies. A complaint is not a confirmed violation. Coverage and published fines vary by source.",
"inputSchema": {
"type": "object",
"required": [
"violation_id"
],
"properties": {
"violation_id": {
"type": "string",
"format": "uuid",
"maxLength": 500
}
},
"additionalProperties": false
},
"annotations": {
"title": "Code violation or complaint",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search planning and zoning cases by place, type, status, dates and proposed size. A planning case does not guarantee construction. Sources report data_through. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.
| Parameter | Type | Description |
|---|---|---|
| lat | number | |
| lng | number | |
| city | string | City name (matches the address city or the issuing jurisdiction) |
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| state | string | 2-letter state code |
| parcel | string | Parcel / APN / folio (formatting ignored) |
| status | string | Normalised case status |
| address | string | Street address, partial, case-insensitive |
| per_page | integer |
Get a planning case by UUID with linked decisions and permits. A permit link matches site and time, not proof it was issued under this case; link_method and confidence describe the match. A planning case does not guarantee construction. Coverage varies.
| Parameter | Type | Description |
|---|---|---|
| case_id * | string |
{
"name": "get_pipeline_case",
"title": "Planning case details",
"description": "Get a planning case by UUID with linked decisions and permits. A permit link matches site and time, not proof it was issued under this case; link_method and confidence describe the match. A planning case does not guarantee construction. Coverage varies.",
"inputSchema": {
"type": "object",
"required": [
"case_id"
],
"properties": {
"case_id": {
"type": "string",
"format": "uuid",
"maxLength": 500
}
},
"additionalProperties": false
},
"annotations": {
"title": "Planning case details",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search council, planning commission and zoning board decisions by place, body, action and meeting date. RECOMMENDED_* is a recommendation, not a final decision. A decision does not guarantee construction. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.
| Parameter | Type | Description |
|---|---|---|
| body | string | Deciding body, partial ('Planning Commission', 'Zoning') |
| city | string | City name (matches the address city or the deciding jurisdiction) |
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| state | string | 2-letter state code |
| linked | boolean | true: only items linked to a planning case we hold |
| address | string | Street address named in the item, partial |
| outcome | string | Normalised action: APPROVED, DENIED, RECOMMENDED_APPROVAL, TABLED, ... |
| land_use | string |
Search certificates of occupancy or completion. Defaults exclude renewals; co_date_basis states what each date means. Completion certificates do not establish occupancy, and pending applications are not issued certificates. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.
| Parameter | Type | Description |
|---|---|---|
| lat | number | |
| lng | number | |
| city | string | City name (matches the address city or the issuing jurisdiction) |
| kind | string | 'occupancy' (default), 'completion' (certificates of completion: close-outs of work that creates no occupancy, e.g. roofs, pools), or 'all' |
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| state | string | 2-letter state code |
| parcel | string | Parcel / APN / folio / BBL (formatting ignored) |
| address | string |
Get an occupancy or completion certificate by UUID, including certificate_status and co_date_basis. A duplicate id resolves to its canonical record. Coverage varies; a completion certificate does not establish occupancy.
| Parameter | Type | Description |
|---|---|---|
| certificate_id * | string |
{
"name": "get_certificate",
"title": "Occupancy certificate details",
"description": "Get an occupancy or completion certificate by UUID, including certificate_status and co_date_basis. A duplicate id resolves to its canonical record. Coverage varies; a completion certificate does not establish occupancy.",
"inputSchema": {
"type": "object",
"required": [
"certificate_id"
],
"properties": {
"certificate_id": {
"type": "string",
"format": "uuid",
"maxLength": 500
}
},
"additionalProperties": false
},
"annotations": {
"title": "Occupancy certificate details",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Look up a license number in its issuing state across the public board rosters held, with matching contractors. Coverage and as_of dates vary by board. Access and locked_fields identify unavailable fields; a registration is not a license. No contact enrichment.
| Parameter | Type | Description |
|---|---|---|
| state * | string | 2-letter issuing state |
| license_number * | string | Licence number as issued (spaces, dashes and case are ignored) |
{
"name": "lookup_license",
"title": "Look up a contractor license",
"description": "Look up a license number in its issuing state across the public board rosters held, with matching contractors. Coverage and as_of dates vary by board. Access and locked_fields identify unavailable fields; a registration is not a license. No contact enrichment.",
"inputSchema": {
"type": "object",
"required": [
"license_number",
"state"
],
"properties": {
"state": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "2-letter issuing state"
},
"license_number": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "Licence number as issued (spaces, dashes and case are ignored)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Look up a contractor license",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List public board licenses linked to a contractor UUID by the API's exact matching rules. Coverage and as_of dates vary by board. Access and locked_fields identify unavailable fields; a registration is not a license. No contact enrichment.
| Parameter | Type | Description |
|---|---|---|
| contractor_id * | string |
{
"name": "get_contractor_licenses",
"title": "Contractor licenses",
"description": "List public board licenses linked to a contractor UUID by the API's exact matching rules. Coverage and as_of dates vary by board. Access and locked_fields identify unavailable fields; a registration is not a license. No contact enrichment.",
"inputSchema": {
"type": "object",
"required": [
"contractor_id"
],
"properties": {
"contractor_id": {
"type": "string",
"format": "uuid",
"maxLength": 500
}
},
"additionalProperties": false
},
"annotations": {
"title": "Contractor licenses",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List source and place coverage for inspections, violations, pipeline cases/decisions or certificates. Includes the API's measured freshness, completeness and caveats where available. Counts have source-specific meanings; complaints are separate from violations. Requires sign-in. Licensing has no coverage endpoint.
| Parameter | Type | Description |
|---|---|---|
| name | string | Optional place-name substring, filtered locally before pagination |
| page | integer | Page number, 1-based (default 1) |
| start | integer | Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`) |
| state | string | 2-letter state code |
| dataset * | string | Dataset whose coverage to list |
| per_page | integer | Results per page (default 25, max 25) |
| pipeline_dataset | string | Only for dataset=pipeline: cases, decisions or all (default) |
{
"name": "get_dataset_coverage",
"title": "Dataset coverage",
"description": "List source and place coverage for inspections, violations, pipeline cases/decisions or certificates. Includes the API's measured freshness, completeness and caveats where available. Counts have source-specific meanings; complaints are separate from violations. Requires sign-in. Licensing has no coverage endpoint.",
"inputSchema": {
"type": "object",
"required": [
"dataset"
],
"properties": {
"name": {
"type": "string",
"maxLength": 500,
"description": "Optional place-name substring, filtered locally before pagination"
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"state": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "2-letter state code"
},
"dataset": {
"enum": [
"inspections",
"violations",
"pipeline",
"certificates"
],
"type": "string",
"description": "Dataset whose coverage to list"
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"pipeline_dataset": {
"enum": [
"cases",
"decisions",
"all"
],
"type": "string",
"default": "all",
"description": "Only for dataset=pipeline: cases, decisions or all (default)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Dataset coverage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "get_property_history",
"title": "Property permit history",
"description": "Permit history for one property, looked up by street address (house number and street name, e.g. '123 Main St'). Optional city, state and ZIP narrow the match when the same street address exists in several places. Returns a property profile (permit timeline, category breakdown, contractors) and up to 25 permit records per page, newest first; `has_more` says whether the next page has more. Covers all permit categories. When the connected account covers a limited date range, the profile and records cover only that range, `account_window_from` is set, and `_notes` says so: the result is then not the property's full permit history. Results carry no property owner name, owner mailing address or permit applicant name fields.",
"inputSchema": {
"type": "object",
"required": [
"address"
],
"properties": {
"zip": {
"type": "string",
"description": "Optional ZIP code (prefix-matched)"
},
"city": {
"type": "string",
"description": "Optional city, to tell identical street addresses apart"
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"state": {
"type": "string",
"description": "Optional two-letter state code"
},
"address": {
"type": "string",
"description": "Street address with house number, e.g. '123 Main St' (min 3 characters)"
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Property permit history",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "search_contractors",
"title": "Search contractors",
"description": "Search contractors by name, city, state or specialty. Returns up to 25 contractors per call with the contractor UUID, name, licence number and licence state, home city and state, total permit count, first and last permit dates, specialties and activity score (0-100), sorted by activity score (highest first). Project values are not included; get_contractor_permits lists a contractor's permits with their estimated values.",
"inputSchema": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "City where the contractor has worked"
},
"name": {
"type": "string",
"description": "Contractor name (partial match)"
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"state": {
"type": "string",
"description": "Two-letter state code"
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"specialty": {
"type": "string",
"description": "Specialty/trade to filter by, e.g. 'solar', 'roofing', 'hvac'"
},
"min_permits": {
"type": "integer",
"minimum": 0,
"description": "Only contractors with at least this many permits"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search contractors",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| string |
| Street address, partial, case-insensitive |
| per_page | integer | Results per page (default 25, max 25) |
| upcoming | string | Future-dated (still scheduled) inspections: exclude (the default, except with result=SCHEDULED), include, or only (soonest first). |
| zip_code | string | 5-digit ZIP |
| permit_id | string | A permit id from /v1/permits |
| summaries | string | 'Last inspection' summaries copied from permit records (not inspection logs). Default exclude. |
| date_after | string | inspection_date on or after (undated inspections never match) |
| final_only | boolean | Only final / certificate-of-occupancy inspections |
| date_before | string | inspection_date on or before |
| permit_number | string | The permit number, as the city publishes it or as /v1/permits returns it |
| inspection_type | string | Normalised inspection type, e.g. FRAMING, ROUGH, FINAL |
| jurisdiction_id | string | A jurisdiction id from /v1/jurisdictions (narrows permit_number) |
{
"name": "search_inspections",
"title": "Search building inspections",
"description": "Search inspection logs by place, permit, type, result and date. Summaries and future scheduled inspections are excluded by default; upcoming and summaries opt in. Sources report data_through. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.",
"inputSchema": {
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 500,
"description": "City name (matches the address city or the issuing jurisdiction)"
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"scope": {
"enum": [
"permit",
"existing",
"occupancy",
"all"
],
"type": "string",
"default": "permit",
"maxLength": 500,
"description": "permit (default): inspections of permitted work. existing / occupancy: occupancy inspections of existing buildings that no permit asked for; all."
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"state": {
"type": "string",
"maxLength": 500,
"description": "2-letter state code"
},
"trade": {
"enum": [
"BUILDING",
"ELECTRICAL",
"PLUMBING",
"MECHANICAL",
"FIRE",
"OTHER"
],
"type": "string",
"maxLength": 500
},
"parcel": {
"type": "string",
"maxLength": 500,
"description": "Parcel / APN / folio (formatting ignored)"
},
"result": {
"enum": [
"PASS",
"FAIL",
"PARTIAL",
"CANCELLED",
"SCHEDULED",
"OTHER"
],
"type": "string",
"maxLength": 500,
"description": "PASS, FAIL, PARTIAL, CANCELLED, SCHEDULED or OTHER"
},
"address": {
"type": "string",
"maxLength": 500,
"description": "Street address, partial, case-insensitive"
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"upcoming": {
"enum": [
"exclude",
"include",
"only"
],
"type": "string",
"maxLength": 500,
"description": "Future-dated (still scheduled) inspections: exclude (the default, except with result=SCHEDULED), include, or only (soonest first)."
},
"zip_code": {
"type": "string",
"maxLength": 500,
"description": "5-digit ZIP"
},
"permit_id": {
"type": "string",
"format": "uuid",
"maxLength": 500,
"description": "A permit id from /v1/permits"
},
"summaries": {
"enum": [
"exclude",
"include",
"only"
],
"type": "string",
"default": "exclude",
"maxLength": 500,
"description": "'Last inspection' summaries copied from permit records (not inspection logs). Default exclude."
},
"date_after": {
"type": "string",
"format": "date",
"maxLength": 500,
"description": "inspection_date on or after (undated inspections never match)"
},
"final_only": {
"type": "boolean",
"default": false,
"description": "Only final / certificate-of-occupancy inspections"
},
"date_before": {
"type": "string",
"format": "date",
"maxLength": 500,
"description": "inspection_date on or before"
},
"permit_number": {
"type": "string",
"maxLength": 500,
"description": "The permit number, as the city publishes it or as /v1/permits returns it"
},
"inspection_type": {
"enum": [
"PRE_CONSTRUCTION",
"FOOTING",
"FOUNDATION",
"SLAB",
"UNDERGROUND",
"ROUGH",
"FRAMING",
"SHEATHING",
"INSULATION",
"DRYWALL",
"ROOFING",
"GAS",
"SERVICE",
"FINAL",
"CO",
"OTHER"
],
"type": "string",
"maxLength": 500,
"description": "Normalised inspection type, e.g. FRAMING, ROUGH, FINAL"
},
"jurisdiction_id": {
"type": "string",
"format": "uuid",
"maxLength": 500,
"description": "A jurisdiction id from /v1/jurisdictions (narrows permit_number)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search building inspections",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "get_permit_inspections",
"title": "Permit inspections",
"description": "List inspections linked to a permit UUID. Future scheduled inspections are excluded by default unless result=SCHEDULED or upcoming opts in. An empty list means no linked inspection is held. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.",
"inputSchema": {
"type": "object",
"required": [
"permit_id"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"result": {
"enum": [
"PASS",
"FAIL",
"PARTIAL",
"CANCELLED",
"SCHEDULED",
"OTHER"
],
"type": "string",
"maxLength": 500
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"upcoming": {
"enum": [
"exclude",
"include",
"only"
],
"type": "string",
"maxLength": 500,
"description": "Future-dated (still scheduled) inspections: exclude (the default, except with result=SCHEDULED), include, or only (soonest first)."
},
"permit_id": {
"type": "string",
"format": "uuid",
"maxLength": 500
},
"summaries": {
"enum": [
"exclude",
"include",
"only"
],
"type": "string",
"default": "exclude",
"maxLength": 500
}
},
"additionalProperties": false
},
"annotations": {
"title": "Permit inspections",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| category |
| string |
| Normalised category, e.g. HOUSING, UNSAFE, WORK_WITHOUT_PERMIT |
| per_page | integer | Results per page (default 25, max 25) |
| zip_code | string | 5-digit ZIP |
| open_only | boolean | Only OPEN records (a citation or judgment is not open) |
| date_after | string | record_date on or after (undated records never match) |
| case_number | string | The agency's case / complaint number |
| date_before | string | record_date on or before |
| record_kind | string | 'violation' (default): violations, citations and orders the agency found. 'complaint': reports it received, and cases with no evidence a violation was found. 'all': both. Complaints are never counted as violations. |
| radius_miles | number | Radius in miles around lat/lng (default 1) |
| jurisdiction_id | string | A jurisdiction id from /v1/jurisdictions |
| include_uncounted | boolean | Also return records stored but never counted: voided, withdrawn, rescinded or issued in error, and process steps |
{
"name": "search_violations",
"title": "Search code violations",
"description": "Search agency findings by place, case number, status, category and date. record_kind defaults to violation; complaints are reports, not confirmed violations. Sources report data_through, coverage_window and count_unit. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"city": {
"type": "string",
"maxLength": 500,
"description": "City name (matches the address city or the issuing jurisdiction)"
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"state": {
"type": "string",
"maxLength": 500,
"description": "2-letter state code"
},
"parcel": {
"type": "string",
"maxLength": 500,
"description": "Parcel / APN / folio / BBL (formatting ignored)"
},
"status": {
"enum": [
"OPEN",
"CLOSED",
"COMPLIED",
"ABATED",
"CITED",
"DISMISSED",
"UNKNOWN"
],
"type": "string",
"maxLength": 500,
"description": "OPEN, CLOSED, COMPLIED, ABATED, CITED, DISMISSED or UNKNOWN"
},
"address": {
"type": "string",
"maxLength": 500,
"description": "Street address, partial, case-insensitive"
},
"category": {
"enum": [
"STRUCTURAL",
"HOUSING",
"ZONING",
"PROPERTY_MAINTENANCE",
"NUISANCE",
"UNSAFE",
"VACANT",
"FIRE",
"SIGN",
"WORK_WITHOUT_PERMIT",
"ENVIRONMENTAL",
"OTHER"
],
"type": "string",
"maxLength": 500,
"description": "Normalised category, e.g. HOUSING, UNSAFE, WORK_WITHOUT_PERMIT"
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"zip_code": {
"type": "string",
"maxLength": 500,
"description": "5-digit ZIP"
},
"open_only": {
"type": "boolean",
"default": false,
"description": "Only OPEN records (a citation or judgment is not open)"
},
"date_after": {
"type": "string",
"format": "date",
"maxLength": 500,
"description": "record_date on or after (undated records never match)"
},
"case_number": {
"type": "string",
"maxLength": 500,
"description": "The agency's case / complaint number"
},
"date_before": {
"type": "string",
"format": "date",
"maxLength": 500,
"description": "record_date on or before"
},
"record_kind": {
"enum": [
"violation",
"complaint",
"all"
],
"type": "string",
"default": "violation",
"maxLength": 500,
"description": "'violation' (default): violations, citations and orders the agency found. 'complaint': reports it received, and cases with no evidence a violation was found. 'all': both. Complaints are never counted as violations."
},
"radius_miles": {
"type": "number",
"maximum": 50,
"description": "Radius in miles around lat/lng (default 1)",
"exclusiveMinimum": 0
},
"jurisdiction_id": {
"type": "string",
"format": "uuid",
"maxLength": 500,
"description": "A jurisdiction id from /v1/jurisdictions"
},
"include_uncounted": {
"type": "boolean",
"default": false,
"description": "Also return records stored but never counted: voided, withdrawn, rescinded or issued in error, and process steps"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search code violations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| Results per page (default 25, max 25) |
| zip_code | string | 5-digit ZIP |
| case_type | string | REZONING, SITE_PLAN, SUBDIVISION_PLAT, VARIANCE, CONDITIONAL_USE, ... |
| min_acres | number |
| min_units | integer | Dwelling units proposed, at least (the source's structured unit count) |
| case_number | string | The case number as published (formatting ignored) |
| filed_after | string |
| filed_before | string |
| radius_miles | number | Radius in miles around lat/lng (default 1) |
| decided_after | string |
| hearing_after | string | Hearing on or after (may be in the future) |
| decided_before | string |
| hearing_before | string |
| jurisdiction_id | string | A jurisdiction id from /v1/jurisdictions |
{
"name": "search_pipeline_cases",
"title": "Search planning cases",
"description": "Search planning and zoning cases by place, type, status, dates and proposed size. A planning case does not guarantee construction. Sources report data_through. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"city": {
"type": "string",
"maxLength": 500,
"description": "City name (matches the address city or the issuing jurisdiction)"
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"state": {
"type": "string",
"maxLength": 500,
"description": "2-letter state code"
},
"parcel": {
"type": "string",
"maxLength": 500,
"description": "Parcel / APN / folio (formatting ignored)"
},
"status": {
"enum": [
"FILED",
"UNDER_REVIEW",
"HEARING_SCHEDULED",
"APPROVED",
"APPROVED_WITH_CONDITIONS",
"DENIED",
"WITHDRAWN",
"TABLED",
"APPEALED",
"CLOSED",
"UNKNOWN"
],
"type": "string",
"maxLength": 500,
"description": "Normalised case status"
},
"address": {
"type": "string",
"maxLength": 500,
"description": "Street address, partial, case-insensitive"
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"zip_code": {
"type": "string",
"maxLength": 500,
"description": "5-digit ZIP"
},
"case_type": {
"enum": [
"REZONING",
"SITE_PLAN",
"SUBDIVISION_PLAT",
"VARIANCE",
"CONDITIONAL_USE",
"ANNEXATION",
"PUD",
"COMPREHENSIVE_PLAN",
"DEMOLITION_REVIEW",
"HISTORIC_REVIEW",
"OTHER"
],
"type": "string",
"maxLength": 500,
"description": "REZONING, SITE_PLAN, SUBDIVISION_PLAT, VARIANCE, CONDITIONAL_USE, ..."
},
"min_acres": {
"type": "number",
"minimum": 0
},
"min_units": {
"type": "integer",
"minimum": 0,
"description": "Dwelling units proposed, at least (the source's structured unit count)"
},
"case_number": {
"type": "string",
"maxLength": 500,
"description": "The case number as published (formatting ignored)"
},
"filed_after": {
"type": "string",
"format": "date",
"maxLength": 500
},
"filed_before": {
"type": "string",
"format": "date",
"maxLength": 500
},
"radius_miles": {
"type": "number",
"maximum": 50,
"description": "Radius in miles around lat/lng (default 1)",
"exclusiveMinimum": 0
},
"decided_after": {
"type": "string",
"format": "date",
"maxLength": 500
},
"hearing_after": {
"type": "string",
"format": "date",
"maxLength": 500,
"description": "Hearing on or after (may be in the future)"
},
"decided_before": {
"type": "string",
"format": "date",
"maxLength": 500
},
"hearing_before": {
"type": "string",
"format": "date",
"maxLength": 500
},
"jurisdiction_id": {
"type": "string",
"format": "uuid",
"maxLength": 500,
"description": "A jurisdiction id from /v1/jurisdictions"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search planning cases",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| 'only' (default): land-use items; 'all': every stored item |
| per_page | integer | Results per page (default 25, max 25) |
| case_number | string | A case number named in the item (formatting ignored) |
| matter_file | string | The clerk's file number |
| land_use_type | string | one of ["REZONING","SITE_PLAN","SUBDIVISION_PLAT","VARIANCE","CONDITIONAL_USE","ANNEXATION","PUD","COMPREHENSIVE_PLAN","DEMOLITION_REVIEW","HISTORIC_REVIEW","OTHER"] |
| meeting_after | string |
| meeting_before | string |
| jurisdiction_id | string |
{
"name": "search_pipeline_decisions",
"title": "Search planning decisions",
"description": "Search council, planning commission and zoning board decisions by place, body, action and meeting date. RECOMMENDED_* is a recommendation, not a final decision. A decision does not guarantee construction. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.",
"inputSchema": {
"type": "object",
"properties": {
"body": {
"type": "string",
"maxLength": 500,
"description": "Deciding body, partial ('Planning Commission', 'Zoning')"
},
"city": {
"type": "string",
"maxLength": 500,
"description": "City name (matches the address city or the deciding jurisdiction)"
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"state": {
"type": "string",
"maxLength": 500,
"description": "2-letter state code"
},
"linked": {
"type": "boolean",
"description": "true: only items linked to a planning case we hold"
},
"address": {
"type": "string",
"maxLength": 500,
"description": "Street address named in the item, partial"
},
"outcome": {
"enum": [
"APPROVED",
"APPROVED_WITH_CONDITIONS",
"DENIED",
"RECOMMENDED_APPROVAL",
"RECOMMENDED_DENIAL",
"TABLED",
"WITHDRAWN",
"REFERRED",
"FIRST_READING",
"RECEIVED",
"NO_ACTION",
"OTHER",
"UNKNOWN"
],
"type": "string",
"maxLength": 500,
"description": "Normalised action: APPROVED, DENIED, RECOMMENDED_APPROVAL, TABLED, ..."
},
"land_use": {
"enum": [
"only",
"all"
],
"type": "string",
"default": "only",
"maxLength": 500,
"description": "'only' (default): land-use items; 'all': every stored item"
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"case_number": {
"type": "string",
"maxLength": 500,
"description": "A case number named in the item (formatting ignored)"
},
"matter_file": {
"type": "string",
"maxLength": 500,
"description": "The clerk's file number"
},
"land_use_type": {
"enum": [
"REZONING",
"SITE_PLAN",
"SUBDIVISION_PLAT",
"VARIANCE",
"CONDITIONAL_USE",
"ANNEXATION",
"PUD",
"COMPREHENSIVE_PLAN",
"DEMOLITION_REVIEW",
"HISTORIC_REVIEW",
"OTHER"
],
"type": "string",
"maxLength": 500
},
"meeting_after": {
"type": "string",
"format": "date",
"maxLength": 500
},
"meeting_before": {
"type": "string",
"format": "date",
"maxLength": 500
},
"jurisdiction_id": {
"type": "string",
"format": "uuid",
"maxLength": 500
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search planning decisions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| Street address, partial, case-insensitive |
| co_type | string | 'change' = re-issued for an existing building's new owner, use or occupant load; 'revision' = a revised certificate. Neither certifies new units: their dwelling units are in units_existing, so min_units counts newly certified units. |
| per_page | integer | Results per page (default 25, max 25) |
| renewals | string | Temporary-certificate RENEWALS (NYC re-issues a TCO every 90 days). Default 'exclude': finals and first-time TCOs only. |
| zip_code | string | 5-digit ZIP |
| co_number | string |
| min_units | integer | Newly certified dwelling units on or above (units_existing is not counted) |
| issued_after | string | CO date on or after (undated certificates never match) |
| radius_miles | number | Radius in miles around lat/lng (default 1) |
| issued_before | string | CO date on or before |
| permit_number | string | The building permit the certificate was issued on |
| jurisdiction_id | string | A jurisdiction id from /v1/jurisdictions |
| occupancy_class | string | Building-code occupancy group as published, e.g. R-3, B |
| certificate_status | string | Default: issued + expired (both were issued). 'pending' = CO applications not yet issued. |
{
"name": "search_certificates",
"title": "Search occupancy certificates",
"description": "Search certificates of occupancy or completion. Defaults exclude renewals; co_date_basis states what each date means. Completion certificates do not establish occupancy, and pending applications are not issued certificates. Coverage varies by source and place; an empty result does not establish that no record exists. Up to 25 results per call. total_capped marks a lower bound; total_unknown means the total is unknown. Pagination guidance is in _notes.",
"inputSchema": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"city": {
"type": "string",
"maxLength": 500,
"description": "City name (matches the address city or the issuing jurisdiction)"
},
"kind": {
"enum": [
"occupancy",
"completion",
"all"
],
"type": "string",
"default": "occupancy",
"maxLength": 500,
"description": "'occupancy' (default), 'completion' (certificates of completion: close-outs of work that creates no occupancy, e.g. roofs, pools), or 'all'"
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number, 1-based (default 1)"
},
"start": {
"type": "integer",
"minimum": 1,
"description": "Instead of page: 1-based position of the first result to return, e.g. start=24 continues after result 23 (as named in `_notes`)"
},
"state": {
"type": "string",
"maxLength": 500,
"description": "2-letter state code"
},
"parcel": {
"type": "string",
"maxLength": 500,
"description": "Parcel / APN / folio / BBL (formatting ignored)"
},
"address": {
"type": "string",
"maxLength": 500,
"description": "Street address, partial, case-insensitive"
},
"co_type": {
"enum": [
"final",
"temporary",
"partial",
"unknown",
"change",
"revision"
],
"type": "string",
"maxLength": 500,
"description": "'change' = re-issued for an existing building's new owner, use or occupant load; 'revision' = a revised certificate. Neither certifies new units: their dwelling units are in units_existing, so min_units counts newly certified units."
},
"per_page": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1,
"description": "Results per page (default 25, max 25)"
},
"renewals": {
"enum": [
"exclude",
"include",
"only"
],
"type": "string",
"default": "exclude",
"maxLength": 500,
"description": "Temporary-certificate RENEWALS (NYC re-issues a TCO every 90 days). Default 'exclude': finals and first-time TCOs only."
},
"zip_code": {
"type": "string",
"maxLength": 500,
"description": "5-digit ZIP"
},
"co_number": {
"type": "string",
"maxLength": 500
},
"min_units": {
"type": "integer",
"minimum": 0,
"description": "Newly certified dwelling units on or above (units_existing is not counted)"
},
"issued_after": {
"type": "string",
"format": "date",
"maxLength": 500,
"description": "CO date on or after (undated certificates never match)"
},
"radius_miles": {
"type": "number",
"maximum": 50,
"description": "Radius in miles around lat/lng (default 1)",
"exclusiveMinimum": 0
},
"issued_before": {
"type": "string",
"format": "date",
"maxLength": 500,
"description": "CO date on or before"
},
"permit_number": {
"type": "string",
"maxLength": 500,
"description": "The building permit the certificate was issued on"
},
"jurisdiction_id": {
"type": "string",
"format": "uuid",
"maxLength": 500,
"description": "A jurisdiction id from /v1/jurisdictions"
},
"occupancy_class": {
"type": "string",
"maxLength": 500,
"description": "Building-code occupancy group as published, e.g. R-3, B"
},
"certificate_status": {
"enum": [
"issued",
"expired",
"pending",
"void",
"unknown",
"all"
],
"type": "string",
"maxLength": 500,
"description": "Default: issued + expired (both were issued). 'pending' = CO applications not yet issued."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search occupancy certificates",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}