npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

catastro-gps-mcp

v2.2.2

Published

MCP server for cadastral parcels from the full official cadastre of 27 European countries (including the Basque Country and Navarre foral cadastres), plus Scotland and Swedish farm blocks: reference, coordinates, address search in 27 countries, dwellings

Readme

Catastro GPS MCP server

Official cadastral parcels for AI agents from the full cadastre of 27 European countries (including the Basque Country and Navarre foral cadastres), with one API key, by cadastral reference and by coordinates. Partial coverage in 2 more: the United Kingdom (Scotland only, by coordinates) and Sweden (agricultural blocks). Every parcel names its official source and licence in source.

Ask your agent for a parcel by its cadastral reference, by a point on the map or by a postal address. It gets back the reference, location, area, land use and the parcel outline; it can list every dwelling of a Spanish building, read relief, protected areas, climate normals and satellite ground motion, estimate solar and agricultural potential, read aggregated market prices, and score and compare parcels.

  • 27 full cadastres plus 2 partial countries, one call shape. ES, PT, FR, IT, DE, PL, NL, CH... and the two Spanish foral cadastres (PV, NA) that the central Catastro does not serve.
  • The country is optional. It is detected from the reference format or from the point. When bare digits fit several countries the API says so (CNV_AMBIGUOUS) and resolve_reference tells you which ones, for free.
  • Address search in 27 countries. "Calle Gran Via 31, Madrid", "8 boulevard du Port, Amiens" or "Damrak 1, 1012 LG Amsterdam" become ranked parcels.
  • Buildings, not only plots. get_units lists every dwelling, shop and garage of a Spanish building with floor, door, area and participation coefficient.
  • Your quota in every answer. Each result carries the monthly quota left, the prepaid balance and the per-minute headroom.
  • Free tier for good. 25 calls a month at no cost, no card. Failed lookups are not charged.

Get a key at parcelgps.com/developers.

Install

Remote server, nothing to install

The server runs at https://mcp.parcelgps.com/mcp (Streamable HTTP). Every tool call runs on your own key, so it counts against your own quota. Listing the tools needs no key.

Claude Code

claude mcp add --transport http parcel-gps https://mcp.parcelgps.com/mcp --header "Authorization: Bearer pk_live_your_key_here"

Cursor, VS Code, Windsurf (mcp.json)

{
  "mcpServers": {
    "parcel-gps": {
      "url": "https://mcp.parcelgps.com/mcp",
      "headers": { "Authorization": "Bearer pk_live_your_key_here" }
    }
  }
}

Claude.ai and ChatGPT custom connectors, or any client that only takes a URL: put the key in the URL and keep that URL private.

https://mcp.parcelgps.com/mcp?api_key=pk_live_your_key_here

The key is also accepted in an X-API-Key header.

Claude Desktop

{
  "mcpServers": {
    "catastro-gps": {
      "command": "npx",
      "args": ["-y", "catastro-gps-mcp"],
      "env": { "CATASTROGPS_API_KEY": "pk_live_your_key_here" }
    }
  }
}

Claude Code

claude mcp add catastro-gps --env CATASTROGPS_API_KEY=pk_live_your_key_here -- npx -y catastro-gps-mcp

Cursor, Windsurf, VS Code and other MCP clients

Use the same npx -y catastro-gps-mcp command with CATASTROGPS_API_KEY in the environment.

Tools

| Tool | What it does | Countries | |------|--------------|-----------| | get_parcel | Parcel by cadastral reference or WGS84 coordinates: reference, location, address, municipality, area, land use, outline, number of crop subparcels and a crop summary (lang for crop names) | All 29 countries, Basque Country and Navarre included (UK: Scotland, coordinates only) | | search_address | Postal address in free text to ranked parcels, with confidence and whether the number and municipality match | ES (with PV and NA entrances) and FR, IT, DE, AT, NL, BE, PL, CH, CZ, DK, NO, FI, EE, LV, LT, SI, SK, BG, GR, CY, LU, LI, IS, IE, UK, PT | | get_units | Every unit (dwelling, shop, garage, storage) of a Spanish building: stair, floor, door, use, area, participation, year. Paginated, 200 per page | ES, PV, NA | | resolve_reference | Free, no quota: is this text a reference, coordinates or a place name, and of which country | All | | get_parcel_subparcels | Every crop or land-use part of the parcel: crop code, crop name in 10 languages, original label, area, land-use class, source and (optionally) outline. A source failure is SUB_001, not charged | ES (with Bizkaia, Álava, Navarre, Gipuzkoa), AT, DE, CZ, NL, FR, PT, SE, CH, FI, BE, IE, SI, EE, GR | | get_parcel_sigpac | Every SIGPAC enclosure (recinto) of a Spanish parcel: land-use code and name in 10 languages, area in ha, irrigation coefficient, slope, altitude, CAP pasture eligibility and region, incidents and (optionally) outline. Cite "Fuente: FEGA — SIGPAC". A SIGPAC failure is SIG_001, not charged | ES, PV, NA | | get_crop_catalog | Free, no quota: every crop code with its name in the chosen language and its land-use class | All crop catalogues | | get_neighbors | Parcels that touch or surround the parcel (up to 60) with reference and centre point | ES from the cadastre; elsewhere from our own copy (supported: false when not) | | list_provinces, list_municipalities, list_streets | Spanish cadastre provinces, municipalities (with INE code) and streets of a municipality | ES (common territory) | | get_boundaries | Parcel outline as GeoJSON / [lat, lng] ring, centroid and area | 30 codes (all but UK) | | get_terrain | Relief over the parcel outline (Copernicus DEM GLO-30), Natura 2000 / protected areas (EEA) and ERA5-Land climate normals with the recent change | Every reference country but HR; outside ES, PV, NA, PT, FR, IT, DE pass latitude/longitude | | get_ground_motion | Ground motion measured by satellite (Copernicus EGMS, 2020-2024): subsidence or uplift in mm/year, fastest-sinking cell, east-west motion, yearly displacement; says so when there are no radar reflectors | Same as get_terrain | | get_solar_potential | PVGIS photovoltaic estimate: kWp, kWh/year, savings, payback, CO2, tilt | ES, PV, NA, PT, FR, IT, DE | | get_agriculture | Land use, main crop, NDVI and a reference crop price (SIGPAC detail in Spain) | ES, PV, NA, PT, FR, IT, DE | | get_market_data | Rural land prices, paid API plans only. Never individual sales or housing figures | ES, PV, NA: rural parcels only, small agricultural buildings allowed (crop_prices, zone_prices.rural); anything else answers MKT_001, not charged | | get_investment_score | Score 0-100 with a rating and qualitative factor levels (high / medium / low / not available) | ES, PV, NA, PT, FR, IT, DE | | get_value_history | Area and land-use snapshots of the parcel over time | ES, PV, NA, PT, FR, IT, DE, AT | | compare_parcels | Two or three parcels side by side: location, solar, agriculture, score | ES, PT, FR, IT, DE (not PV or NA) |

Quota, prepaid balance and limits

  • Only successful answers with data spend quota: a not found, a validation error, CNV_COVERAGE, CNV_AMBIGUOUS, a 5xx and an answer without data (available: false) are free. resolve_reference and get_crop_catalog never spend; get_parcel_subparcels and get_parcel_sigpac are free when the parcel has none.
  • Each successful call costs 1 unit, except get_units (one unit per unit served in the page, minimum 1) and compare_parcels (one per parcel found).
  • Every result carries a quota object read from that same response: remaining, limit, resets_at, plan, and when they apply prepaid_overage, prepaid_balance_eur, overage_units_left, per_minute_remaining, and on get_units with a contract per-finca cap finca_cap / finca_cap_used.
  • When the monthly quota runs out the API does not cut you off if you have prepaid balance: each extra unit is paid from it (top up at parcelgps.com/app/developer). With the quota used up and no balance the call fails with KEY_AUTH_004 (HTTP 429, never 402) and the error says whether to top up or upgrade, and when the quota resets.
  • A separate per-minute limit depends on the plan (Free 10, Developer 60, Startup 120, Growth 300 calls per minute; a global per-IP guard also applies). Going over it answers KEY_RATE_002 with the seconds to wait.

What the market, score and history tools can and cannot tell

  • get_market_data is for paid API plans only (a Free-plan key gets KEY_PLAN_001, not charged) and only prices rural land: agricultural parcels in Spain (Basque Country and Navarre included), small agricultural buildings (sheds, farm stores, ponds, greenhouses) allowed; the figure is the land price, buildings are not valued. It returns crop_prices (price per hectare for each crop group of the parcel, with the number of sales behind it) and zone_prices.rural (the province farmland price per hectare). Housing, industrial or any other non-agricultural property is not supported and answers MKT_001 with nothing charged; so does rural land without a price and any other country.
  • get_investment_score combines what the API can gather for the parcel: solar potential and agricultural use everywhere it answers, market prices only in France, Italy and Germany (NRW). Accessibility and risk are not computed yet and come back as not_available, so the score is relative to the factors that were available. You get the score, the rating and qualitative factor levels, never the weights.
  • get_value_history starts the first time anyone looks the parcel up through Catastro GPS (at most one snapshot every 30 days). A parcel nobody has queried returns an empty list. It records area and land use; the official cadastral value is not recorded yet, so cadastral_value_eur is always null and change_pct is the change in area.
  • compare_parcels fills area, land use and municipality only for Spanish parcels; for Portugal, France, Italy and Germany it returns the location, solar, agriculture and score. It does not include market prices. A parcel that is not found comes back with an error and the others are still compared.

Coverage

What each code answers today (measured against production on 1 October 2026). "Partial" means the official source does not cover the whole territory.

| Code | Country / region | By reference | By coordinates | Address search | Notes | |------|------------------|---|---|---|-------| | ES | Spain (central Catastro) | yes | yes | yes | Buildings and dwellings with get_units | | PV | Basque Country (Araba, Bizkaia, Gipuzkoa) | yes | yes | with country: ES | Foral cadastres; get_units without participation coefficient | | NA | Navarre | yes | yes | with country: ES | Foral cadastre; get_units | | FR | France | yes | yes | yes | | | IT | Italy | yes | yes | yes | | | DE | Germany | partial | partial | partial | 15 of 16 Lander: not Bavaria | | AT | Austria | yes | yes | yes | | | NL | Netherlands | yes | yes | yes | | | BE | Belgium | yes | yes (slow source) | yes | | | PL | Poland | yes | yes | yes | TERYT parcel IDs | | CH | Switzerland | yes | partial | yes | Not in cantons that publish no parcels (e.g. Vaud) | | CZ DK NO FI EE | Czechia, Denmark, Norway, Finland, Estonia | yes | yes | yes | | | LT SI SK BG | Lithuania, Slovenia, Slovakia, Bulgaria | yes | yes | yes | | | LU LI IS | Luxembourg, Liechtenstein, Iceland | yes | yes | yes | | | CY | Cyprus | yes | yes | yes, low confidence | Few house numbers mapped | | LV | Latvia | with country: LV | yes | yes | | | GR | Greece | with country: GR | yes | yes | | | PT | Portugal | yes | partial | partial | The cadastre does not cover Lisbon, Porto or Coimbra; the DGT source is often down | | IE | Ireland | with country: IE (SP_ID) | registered land | partial | Unregistered land answers CNV_COVERAGE (Tailte Éireann, CC BY 4.0) | | UK | United Kingdom | no | Scotland only | Scotland only | England, Wales and Northern Ireland not yet | | HR | Croatia | yes (334553-6250/3 or 6250/3 k.o. Zabok) | yes | no | Full DGU cadastre (Otvorena dozvola); a bare parcel number lists its cadastral municipalities | | SE | Sweden | agricultural blocks | agricultural blocks | no | Not property units |

Hungary, Romania and the rest of Europe are not covered: a reference or point there answers CNV_COVERAGE. Data comes from each country's official cadastre or INSPIRE service (Spain from our copy of the Catastro), so availability follows theirs; when one is down the server answers SERVICE_UNAVAILABLE, which is free.

Official registry documents (Spanish nota simple, Italian visura, Portuguese certidão permanente and others) can be ordered at catastrogps.es. They are not exposed through the API or this server yet.

Examples

Ask your agent:

Find the cadastral parcel at Calle Mallorca 213, Barcelona, and give me its area and outline.

List every flat of the building at Avenida Jose Rodriguez de la Borbolla 10, Dos Hermanas, with floor, door and area.

Is the ground sinking under parcel 30024A16000286? Is it inside a Natura 2000 site?

What is the parcel at 52.2297, 21.0122? What's its area?

Look up the Polish parcel 146510_8.0502.1/3 and tell me its area.

Compare the solar potential of these two rural parcels in Navarre and Portugal.

Compare these three parcels in Spain, France and Italy and tell me which has the best investment score.

What do land prices look like around the French parcel 75056000AB0001?

What a get_parcel call returns (shortened; values are illustrative):

{
  "reference": "9872023VH5797S0001WX",
  "country": "ES",
  "latitude": 40.4165,
  "longitude": -3.7038,
  "address": "CL MAYOR 1",
  "municipality": "MADRID",
  "region": "MADRID",
  "area_m2": 512,
  "land_use": "Residencial",
  "outline_lat_lng": [[40.41662, -3.70391], [40.41671, -3.70362], "..."],
  "google_maps_url": "https://maps.google.com/?q=40.4165,-3.7038"
}

Every call goes to the English v1 REST API (https://api.parcelgps.com/v1/...), so nested blocks such as agriculture, relief or ground_motion use the same English camelCase field names as the API docs.

Errors come back as a code plus a sentence the agent can act on, for example:

CNV_COVERAGE: That reference or point is in a country that is not covered yet.
SERVICE_UNAVAILABLE: The official cadastre for this country is not responding. Try again in a few minutes.
KEY_AUTH_004: Monthly quota used up and prepaid balance empty: top up at https://parcelgps.com/app/developer (or upgrade at https://www.parcelgps.com/developers).

Pricing

The same key works for this server, the REST API and the SDKs (catastrogps on npm and PyPI).

| Plan | Price | Calls / month | |------|-------|---------------| | Free | €0, forever | 25 | | Developer | €19 / month | 5,000 | | Startup | €49 / month | 15,000 | | Growth | €99 / month | 50,000 | | Enterprise | Contact us | Custom |

Details and sign-up: parcelgps.com/developers.

Configuration

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | CATASTROGPS_API_KEY | Yes | | Your API key | | CATASTROGPS_TIMEOUT | No | 20000 | Request timeout in ms. Official cadastres can be slow | | CATASTROGPS_API_URL | No | https://api.parcelgps.com | API base URL |

Development

npm install
npm run lint
npm test
npm run test:coverage
npm run build
CATASTROGPS_API_KEY=pk_live_xxx node build/index.js
node build/http.js

License

MIT