# gaff-check [Health: Active]

**Category:** 🏠 Real Estate  
**Repository:** https://github.com/iarfhlaith/gaff-check  
**GitHub Stars:** 8  
**npm Downloads (last month):** 229  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gaff-check

## Description
Irish property due diligence for AI agents: planning, sold prices, radon, zoning, flood, BER.

## Tools
Capabilities this server exposes over MCP:

- **resolve_location** — Resolve a free-text Irish address or place name to geographic coordinates (WGS84 lat/lng), returning ranked candidate matches.

Use this first when the user gives an address, street, townland, or place name in Ireland, to confirm the correct location before calling other gaff-check tools — every candidate echoes its full resolved name so you (and the user) can sanity-check the match. If you already have exact lat/lng coordinates, you do not need this tool.

Geocoding uses OpenStreetMap Nominatim and is best-effort: rural addresses and new estates may match poorly, and Eircodes only resolve where OSM mappers happen to have added them (there is no licensed Eircode lookup — if the user has only an Eircode, ask for the address or an approximate location instead). The confidence score ranks candidates within one query; it is not an absolute probability. Coordinates are WGS84 decimal degrees.
- **planning_applications** — Find Irish planning applications near a location, from the National Planning Application Database (all 31 local authorities, coverage back to ~2010, updated on varying cadences).

Use this for property due diligence: pending or recent developments near a home (apartment blocks, roads, masts), extensions and attic conversions on the same street (precedents for what gets approved), and refusals that hint at site constraints. Returns per application: reference number, local authority, development description, address, status, decision with dates, distance in metres from the query point, and a link to the local authority's planning file where available.

Provide either lat/lng (WGS84) or a free-text address (geocoded via OpenStreetMap; the resolved location is echoed back — verify it matches before drawing conclusions). Dates are ISO YYYY-MM-DD. The 'decided'/'pending' filter is based on whether a decision date is recorded; raw status strings vary by local authority and are returned verbatim. Coordinates of some older applications are approximate, and update lag differs by authority — absence of results is not evidence that nothing is planned.
- **sold_prices** — Look up actual sold prices of residential properties in Ireland from the official Property Price Register (PSRA), which records declared prices from stamp-duty filings since January 2010.

Use this to see what properties actually sold for near a property of interest: filter by county (required — the register is organised by county), a free-text address fragment (e.g. a street or estate name), an Eircode routing key (first 3 characters, e.g. 'D06' — only present on more recent records), a date range, and/or a price range. Returns per sale: date, declared price in EUR, address as recorded, Eircode where recorded, new vs second-hand, and flags for not-full-market-price and VAT-exclusive sales. Results are newest first.

Know the data's limits: addresses are free text typed from stamp-duty returns — spelling varies, many records lack Eircodes, and address matching is substring-based, so try street name alone before street + number. There is no floor area, so price-per-square-metre cannot be derived. Prices on new builds are often VAT-exclusive (flagged), and declared-price errors exist in the register. This tool reports records, not valuations. If the user has no county, ask them (or infer it from the address) before calling.
- **radon_risk** — Get the EPA's radon risk classification for the area containing a location in Ireland.

Radon is a naturally occurring radioactive gas and the second biggest cause of lung cancer in Ireland after smoking. Use this during property due diligence to learn the area's banding from the EPA Radon Risk Map: the result echoes the EPA's own wording ("About 1 in N homes in this area is likely to have high radon levels", where N is 5, 10 or 20 — lower N means higher risk) plus a high_radon_area flag (true for the 1-in-5 and 1-in-10 bands, the ≥10% threshold Ireland uses to designate High Radon Areas, which carry legal testing duties for workplaces).

This is an area-level prediction from measurement and geological data — it is NOT a measurement of any specific home. The EPA's standing advice ships in every response: any home anywhere can have high radon regardless of banding, the only way to know is to test, and testing is cheap (~€50). Provide lat/lng (WGS84) or a free-text address (geocoded; resolved location echoed back).
- **zoning** — Get the generalised land-use zoning for a location in Ireland, from the Myplan.ie composite of all current local authority development plans.

Use this in property due diligence to learn what the land is zoned for — residential, agricultural, open space, industrial, mixed use, etc. Zoning tells you what could be built there (or next door), whether a site has development potential, and whether a use is likely permissible. Returns the generalised zone type (standardised across authorities, e.g. 'Existing residential'), the local authority's own original zone label and objective text, the development plan name with its validity dates, and a link to plan documents where available.

Provide lat/lng (WGS84) or a free-text address (geocoded; resolved location echoed back). Important: generalised zoning is a standardised simplification that complements but does NOT replace the statutory development plan — zone boundaries are generalised, and specific objectives, conditions and designations (protected structures, flood zones, SACs) live in the written plan. Verify anything decision-critical against the local authority's plan via the link. Points on unzoned land (much of rural Ireland outside town plans) return no records; that means no zoning objective is mapped, not that development is impossible.
- **flood_risk** — Check mapped flood context for a location in Ireland: groundwater flood probability (high/medium/low), maximum historic groundwater flooding, and observed winter 2015/2016 surface-water flooding, from Geological Survey Ireland's 1:20,000 mapping.

Use this in property due diligence. For each layer you get: whether the point itself lies inside a mapped extent (at_point), how many extents fall within the search radius, and the distance in metres to the nearest one. Groundwater flooding (turloughs, high water tables) is a distinct hazard from river or coastal flooding and matters especially in karst limestone areas of the west and midlands.

CRITICAL LIMITATION — this tool does NOT check river (fluvial) or coastal flood models. The OPW's national flood extent datasets are licensed CC-BY-NC-ND, which forbids serving derived query results, so results include unchecked entries for them pointing to the OPW's official viewer (floodinfo.ie) where the user can view all flood maps for the location. A property can be at serious river or coastal flood risk while showing nothing in this tool's results.

Never interpret empty results as "no flood risk": mapping is not exhaustive, pluvial (rain) flooding is not mapped at all, and the fluvial/coastal layers are not queried. Absence of a mapped extent means exactly that and no more. Provide lat/lng (WGS84) or a free-text address (geocoded; resolved location echoed back). Insurance decisions use different, private data — this tool says nothing about insurability.
- **ber_context** — Get Building Energy Rating (BER) context for an area of Ireland: the distribution of BER grades (A1 best … G worst) among certified dwellings in a county or Dublin postal district, optionally narrowed to a construction era, plus current SEAI retrofit grant amounts.

Use this to answer "what energy rating is typical for a house of this age around here?" and "what upgrade grants exist?" during property due diligence. Data is CSO statistics aggregated from BER certificates published since 2009 — e.g. 1978-1999 houses in Co. Galway cluster around C/D, while 2015+ builds are overwhelmingly A-rated. Areas accepted: the 26 counties, the cities (Dublin/Cork/Galway/Limerick/Waterford), or Dublin postal districts ('Dublin 9', 'D6W'). Construction periods: 1700-1977, 1978-1999, 2000-2004, 2005-2009, 2010-2014, 2015-2019, 2020-2024, 2025-2029.

THIS TOOL CANNOT TELL YOU A SPECIFIC HOME'S BER — never present the area distribution as the property's rating. A home's actual BER is on its certificate: the seller/agent must provide it, or it can be looked up on SEAI's public register (link included in every response) with the BER number or MPRN. Note also the statistics' bias: only dwellings that needed a certificate (sold, rented, grant-aided, or new since 2009) are counted, so old housing stock that never transacted is under-represented and its true typical rating is likely worse than shown. Grant amounts are a static reference with a last-verified date — confirm on seai.ie before financial decisions.
- **recorded_crime_context** — Get recorded-crime context for the Garda sub-district containing an Irish location, using official CSO counts and current Garda administrative boundaries.

Use this for factual questions such as "what categories of crime have been recorded in this wider Garda area?" or to supply category-specific values for a choropleth. It returns annual counts, a pooled annual average, rates per 1,000 Census 2022 residents with approximate 95% Poisson intervals, and optionally the latest four-quarter Garda Division trend. Provide WGS84 lat/lng or a free-text address. Offence groups use official broad codes 03–16; omit them to return all published local groups.

This is NOT a street-level crime heatmap or a property safety assessment. CSO station data applies to the entire Garda sub-district polygon: incidents have no published coordinates and may have happened anywhere within it. Never infer a hotspot near the address, spread incidents evenly across the polygon, combine categories into a score, or label the property/area safe or unsafe. Homicide (01) and sexual offences (02) are not published at this local resolution and are explicitly reported as unchecked. Resident-based rates are weak in city centres, airports, retail and nightlife areas with large non-resident populations; enforcement activity also affects some categories. Recorded incidents use PULSE report dates, can be revised, and are not a measure of all crime experienced. Fraud has a 2023 break and a narrower public-reported series from 2024.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "gaff-check": {
    "command": "npx",
    "args": ["-y","gaff-check"]
  }
}
```

## Documentation

## What gaff-check MCP server does

The gaff-check MCP server combines public Irish property datasets for address-level and area-level due diligence. It can locate an address and return nearby planning applications, registered sale prices, radon risk, generalised land-use zoning, mapped flood information, BER statistics with retrofit grant references, and recorded-crime context for the relevant Garda area.

The service is intended to provide records and clearly labelled derived context for an AI assistant. It is not a valuation tool, a commercial property-listing scraper, or a website. The available sources include the National Planning Application Database, the Property Price Register, EPA radon mapping, Myplan zoning, GSI flood mapping, CSO BER statistics, SEAI grant references, and CSO and Garda-area crime data.

## How it works

An MCP-compatible client starts the local process and sends tool requests over standard input and output. A typical conversation begins with `resolve_location`, followed by one or more checks for the same property or nearby area. The assistant can use the returned source, licence, data vintage, and caveat metadata when explaining results.

The eight implemented tools are `resolve_location`, `planning_applications`, `sold_prices`, `radon_risk`, `zoning`, `flood_risk`, `ber_context`, and `recorded_crime_context`. Planning and sales checks use distances or nearby records where applicable. Crime results describe published category counts and qualified rates for administrative areas, not incidents at a specific address or a safety score.

## Setup and configuration

The gaff-check MCP server is published to npm and runs with Node.js 20 or later. For a client using stdio, the launch command is `npx -y gaff-check`; no API keys or separate package installation are required. Running that command directly in a terminal will wait for an MCP client and may appear to hang.

Claude Code can register it with `claude mcp add --transport stdio --scope user gaff-check -- npx -y gaff-check`. Codex uses `codex mcp add gaff-check -- npx -y gaff-check`. Claude Desktop can add an `mcpServers` entry with `npx` as the command and `-y`, `gaff-check` as its arguments.

For local development, clone the repository, run `npm install`, and build with `npm run build`. The project includes configuration files for Claude Code and Codex. Fixture-based tests run with `npm test`; live end-to-end tests require `RUN_E2E=1 npm run test:e2e`.

## Tools and capabilities

- Resolve an Irish address through OpenStreetMap Nominatim.
- Search nearby planning applications and their decisions.
- Retrieve declared sale prices from official Property Price Register data.
- Check EPA radon-risk areas and Myplan zoning.
- Report mapped groundwater or historic flooding from GSI data.
- Add local BER context and relevant SEAI grant references.
- Return published recorded-crime categories for the containing Garda sub-district and wider division trends.

## Limitations and notes

The gaff-check MCP server does not provide a valuation or certainty about whether to buy. Commercial listing sites are not scraped. Flood results do not include OPW river and coastal models that require a licence; the output points users to floodinfo.ie for further checking.

Eircodes cannot be converted directly to coordinates through a free official lookup in this project. Supply an address or approximate location as well. Crime data is aggregated to administrative areas, and some categories, including homicide and sexual offences, are not published at sub-district level. Returned data remains subject to the licences of its underlying public datasets.

_Full upstream README: https://allmcps.com/mcp/gaff-check/readme_