Catastro GPS

Catastro GPS MCP server

Official cadastral parcels for AI agents from 29 European countries (including the Basque Country and Navarre foral cadastres), with one API key: by cadastral reference in 27, by coordinates in all 29. In Croatia (ARKOD agricultural parcels), Sweden (agricultural blocks) and Scotland (by coordinates) the source is not a full cadastre.

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.

• 29 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](https://www.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

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.

| HR | Croatia | no | ARKOD agricultural parcels only | no | No open cadastr