catastro-gps-mcp 2.2.0 → 2.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.2.2 (2026-11-16)
4
+
5
+ - One version everywhere: npm, the official registry and `serverInfo.version` of the remote server all report 2.2.2. The registry entry 2.2.1 pointed at npm 2.2.0, so `tools/list` and the registry disagreed.
6
+
7
+ - Remote server at `https://mcp.parcelgps.com/mcp` (Streamable HTTP, stateless): nothing to install. Each request runs on the caller's own key, taken from `Authorization: Bearer`, `X-API-Key` or `?api_key=` for clients that only take a URL; never on a server key. `server.json` declares it under `remotes`.
8
+ - Without a key the remote server still answers `initialize` and `tools/list`, so directories and connector setups can show the tools; any tool call without a key gets 401 with the link to a free key.
9
+ - The remote server calls the API as `catastro-gps-mcp-remote/<version>`, so its traffic is counted apart from the npm server.
10
+ - `build/sse.js` is gone: the remote server replaces the SSE transport, which was never deployed.
11
+
3
12
  ## 2.2.0 (2026-10-23)
4
13
 
5
14
  - New `get_parcel_sigpac`: every SIGPAC enclosure of a Spanish parcel (ES, PV, NA) from `GET /v1/parcels/{ref}/sigpac`: SIGPAC parcel key, `match`, `land_use_code`, `land_use` in `lang`, `crop_code`, `use_class`, `area_ha`, `irrigation_pct`, `mean_slope_pct`, `altitude_m`, `pasture_eligibility_pct`, `cap_region` (null when SIGPAC does not apply them), `incidents`, attribution and licence, outline with `include_geometry`. `SIG_001` (SIGPAC down) is explained as retryable and not charged.
package/README.md CHANGED
@@ -2,21 +2,54 @@
2
2
 
3
3
  <!-- mcp-name: com.parcelgps/catastro-gps -->
4
4
 
5
- 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.
5
+ 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`.
6
6
 
7
7
  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.
8
8
 
9
- - **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.
9
+ - **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.
10
10
  - **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.
11
11
  - **Address search in 27 countries.** `"Calle Gran Via 31, Madrid"`, `"8 boulevard du Port, Amiens"` or `"Damrak 1, 1012 LG Amsterdam"` become ranked parcels.
12
12
  - **Buildings, not only plots.** `get_units` lists every dwelling, shop and garage of a Spanish building with floor, door, area and participation coefficient.
13
13
  - **Your quota in every answer.** Each result carries the monthly quota left, the prepaid balance and the per-minute headroom.
14
- - **Free tier for good.** 250 calls a month at no cost, no card. Failed lookups are not charged.
14
+ - **Free tier for good.** 25 calls a month at no cost, no card. Failed lookups are not charged.
15
15
 
16
16
  Get a key at **[parcelgps.com/developers](https://www.parcelgps.com/developers)**.
17
17
 
18
18
  ## Install
19
19
 
20
+ ### Remote server, nothing to install
21
+
22
+ The server runs at **`https://mcp.parcelgps.com/mcp`** (Streamable HTTP). Every tool call runs on your own key, so it
23
+ counts against your own quota. Listing the tools needs no key.
24
+
25
+ **Claude Code**
26
+
27
+ ```bash
28
+ claude mcp add --transport http parcel-gps https://mcp.parcelgps.com/mcp --header "Authorization: Bearer pk_live_your_key_here"
29
+ ```
30
+
31
+ **Cursor, VS Code, Windsurf** (`mcp.json`)
32
+
33
+ ```json
34
+ {
35
+ "mcpServers": {
36
+ "parcel-gps": {
37
+ "url": "https://mcp.parcelgps.com/mcp",
38
+ "headers": { "Authorization": "Bearer pk_live_your_key_here" }
39
+ }
40
+ }
41
+ }
42
+ ```
43
+
44
+ **Claude.ai and ChatGPT custom connectors**, or any client that only takes a URL: put the key in the URL and keep
45
+ that URL private.
46
+
47
+ ```
48
+ https://mcp.parcelgps.com/mcp?api_key=pk_live_your_key_here
49
+ ```
50
+
51
+ The key is also accepted in an `X-API-Key` header.
52
+
20
53
  ### Claude Desktop
21
54
 
22
55
  ```json
@@ -45,7 +78,7 @@ Use the same `npx -y catastro-gps-mcp` command with `CATASTROGPS_API_KEY` in the
45
78
 
46
79
  | Tool | What it does | Countries |
47
80
  |------|--------------|-----------|
48
- | `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 and HR: coordinates only) |
81
+ | `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) |
49
82
  | `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 |
50
83
  | `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 |
51
84
  | `resolve_reference` | Free, no quota: is this text a reference, coordinates or a place name, and of which country | All |
@@ -103,9 +136,9 @@ What each code answers today (measured against production on 1 October 2026). "P
103
136
  | `LV` | Latvia | with `country: LV` | yes | yes | |
104
137
  | `GR` | Greece | with `country: GR` | yes | yes | |
105
138
  | `PT` | Portugal | yes | partial | partial | The cadastre does not cover Lisbon, Porto or Coimbra; the DGT source is often down |
106
- | `IE` | Ireland | with `country: IE` (SP_ID) | partial | partial | |
139
+ | `IE` | Ireland | with `country: IE` (SP_ID) | registered land | partial | Unregistered land answers `CNV_COVERAGE` (Tailte Éireann, CC BY 4.0) |
107
140
  | `UK` | United Kingdom | no | Scotland only | Scotland only | England, Wales and Northern Ireland not yet |
108
- | `HR` | Croatia | no | ARKOD agricultural parcels only | no | No open cadastre; not Zagreb or Rijeka |
141
+ | `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 |
109
142
  | `SE` | Sweden | agricultural blocks | agricultural blocks | no | Not property units |
110
143
 
111
144
  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.
@@ -166,7 +199,7 @@ The same key works for this server, the REST API and the SDKs ([`catastrogps`](h
166
199
 
167
200
  | Plan | Price | Calls / month |
168
201
  |------|-------|---------------|
169
- | Free | €0, forever | 250 |
202
+ | Free | €0, forever | 25 |
170
203
  | Developer | €19 / month | 5,000 |
171
204
  | Startup | €49 / month | 15,000 |
172
205
  | Growth | €99 / month | 50,000 |
@@ -191,6 +224,7 @@ npm test
191
224
  npm run test:coverage
192
225
  npm run build
193
226
  CATASTROGPS_API_KEY=pk_live_xxx node build/index.js
227
+ node build/http.js
194
228
  ```
195
229
 
196
230
  ## License
@@ -18,6 +18,7 @@ export declare class CatastroGPSClient {
18
18
  private readonly apiKey;
19
19
  private readonly baseUrl;
20
20
  private readonly timeout;
21
+ private readonly userAgent;
21
22
  lastQuota?: Quota;
22
23
  constructor(config: ServerConfig);
23
24
  private buildUrl;
@@ -84,11 +84,13 @@ export class CatastroGPSClient {
84
84
  apiKey;
85
85
  baseUrl;
86
86
  timeout;
87
+ userAgent;
87
88
  lastQuota;
88
89
  constructor(config) {
89
90
  this.apiKey = config.apiKey;
90
91
  this.baseUrl = config.apiUrl.replace(/\/$/, "");
91
92
  this.timeout = config.timeout;
93
+ this.userAgent = config.userAgent ?? USER_AGENT;
92
94
  }
93
95
  buildUrl(path, params) {
94
96
  const url = new URL(`${this.baseUrl}${path}`);
@@ -105,7 +107,7 @@ export class CatastroGPSClient {
105
107
  const headers = {
106
108
  "X-API-Key": this.apiKey,
107
109
  Accept: "application/json",
108
- "User-Agent": USER_AGENT,
110
+ "User-Agent": this.userAgent,
109
111
  };
110
112
  if (body !== undefined) {
111
113
  headers["Content-Type"] = "application/json";
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=http.d.ts.map
package/build/http.js ADDED
@@ -0,0 +1,15 @@
1
+ #!/usr/bin/env node
2
+ import { createServer as createHttpServer } from "node:http";
3
+ import { loadEndpointConfig } from "./server.js";
4
+ import { createRemoteHandler, MCP_PATH } from "./remote.js";
5
+ const DEFAULT_PORT = 3001;
6
+ const log = (msg) => console.error(`[catastro-gps-mcp] ${msg}`);
7
+ function main() {
8
+ const port = parseInt(process.env.MCP_PORT || process.env.PORT || "", 10) || DEFAULT_PORT;
9
+ const httpServer = createHttpServer(createRemoteHandler(loadEndpointConfig(), log));
10
+ httpServer.listen(port, () => {
11
+ log(`Streamable HTTP server listening on :${port}${MCP_PATH}`);
12
+ });
13
+ }
14
+ main();
15
+ //# sourceMappingURL=http.js.map
@@ -0,0 +1,12 @@
1
+ import type { IncomingHttpHeaders, IncomingMessage, ServerResponse } from "node:http";
2
+ import { type EndpointConfig } from "./server.js";
3
+ export declare const MCP_PATH = "/mcp";
4
+ export declare const DEVELOPERS_URL = "https://www.parcelgps.com/developers";
5
+ export declare const MAX_BODY_BYTES: number;
6
+ type Log = (msg: string) => void;
7
+ export declare function apiKeyFromRequest(headers: IncomingHttpHeaders, url: URL): string | undefined;
8
+ export declare function callsATool(body: unknown): boolean;
9
+ export declare function describeRpc(body: unknown): string;
10
+ export declare function createRemoteHandler(endpoint: EndpointConfig, log?: Log): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
11
+ export {};
12
+ //# sourceMappingURL=remote.d.ts.map
@@ -0,0 +1,132 @@
1
+ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
2
+ import { createServer, sessionConfig } from "./server.js";
3
+ import { REMOTE_USER_AGENT, SERVER_NAME, SERVER_VERSION } from "./version.js";
4
+ export const MCP_PATH = "/mcp";
5
+ export const DEVELOPERS_URL = "https://www.parcelgps.com/developers";
6
+ export const MAX_BODY_BYTES = 1024 * 1024;
7
+ const BEARER_PREFIX = /^bearer\s+/i;
8
+ const JSONRPC_PARSE_ERROR = -32700;
9
+ const JSONRPC_SERVER_ERROR = -32000;
10
+ export function apiKeyFromRequest(headers, url) {
11
+ const authorization = headers.authorization?.trim();
12
+ if (authorization && BEARER_PREFIX.test(authorization)) {
13
+ return authorization.replace(BEARER_PREFIX, "").trim() || undefined;
14
+ }
15
+ const header = headers["x-api-key"];
16
+ const fromHeader = (Array.isArray(header) ? header[0] : header)?.trim();
17
+ if (fromHeader)
18
+ return fromHeader;
19
+ return url.searchParams.get("api_key")?.trim() || undefined;
20
+ }
21
+ export function callsATool(body) {
22
+ const messages = (Array.isArray(body) ? body : [body]);
23
+ return messages.some((m) => m?.method === "tools/call");
24
+ }
25
+ export function describeRpc(body) {
26
+ const messages = (Array.isArray(body) ? body : [body]);
27
+ return messages
28
+ .map((m) => {
29
+ if (m?.method === "tools/call")
30
+ return `tools/call:${m.params?.name ?? "?"}`;
31
+ if (m?.method === "initialize") {
32
+ const client = m.params?.clientInfo;
33
+ return `initialize:${client?.name ?? "?"}/${client?.version ?? "?"}`;
34
+ }
35
+ return m?.method ?? "response";
36
+ })
37
+ .join(",");
38
+ }
39
+ function sendJson(res, status, body, headers = {}) {
40
+ res.writeHead(status, { "Content-Type": "application/json", ...headers });
41
+ res.end(JSON.stringify(body));
42
+ }
43
+ function rpcError(res, status, code, message) {
44
+ sendJson(res, status, { jsonrpc: "2.0", error: { code, message }, id: null });
45
+ }
46
+ async function readJsonBody(req) {
47
+ const chunks = [];
48
+ let size = 0;
49
+ for await (const chunk of req) {
50
+ size += chunk.length;
51
+ if (size > MAX_BODY_BYTES)
52
+ throw new RangeError("body too large");
53
+ chunks.push(chunk);
54
+ }
55
+ return JSON.parse(Buffer.concat(chunks).toString("utf8"));
56
+ }
57
+ function setCors(res) {
58
+ res.setHeader("Access-Control-Allow-Origin", "*");
59
+ res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
60
+ res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, X-API-Key, Mcp-Session-Id, Mcp-Protocol-Version, Last-Event-ID");
61
+ res.setHeader("Access-Control-Expose-Headers", "Mcp-Session-Id");
62
+ }
63
+ function discoveryConfig(endpoint, body) {
64
+ return callsATool(body) ? null : { ...endpoint, apiKey: "" };
65
+ }
66
+ async function handleMcpPost(req, res, endpoint, url, log) {
67
+ const startedAt = Date.now();
68
+ let body;
69
+ try {
70
+ body = await readJsonBody(req);
71
+ }
72
+ catch (error) {
73
+ const tooLarge = error instanceof RangeError;
74
+ rpcError(res, tooLarge ? 413 : 400, JSONRPC_PARSE_ERROR, tooLarge ? "Request body too large" : "Invalid JSON");
75
+ return;
76
+ }
77
+ const rpc = describeRpc(body);
78
+ const config = sessionConfig(endpoint, apiKeyFromRequest(req.headers, url)) ?? discoveryConfig(endpoint, body);
79
+ if (!config) {
80
+ rpcError(res, 401, JSONRPC_SERVER_ERROR, `Your own Parcel GPS API key is required: send "Authorization: Bearer <key>" or add ?api_key=<key> ` +
81
+ `to the URL. Free key (25 calls/month): ${DEVELOPERS_URL}`);
82
+ log(`POST ${MCP_PATH} ${rpc} 401 ${Date.now() - startedAt}ms`);
83
+ return;
84
+ }
85
+ const server = createServer({ ...config, userAgent: REMOTE_USER_AGENT });
86
+ const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, enableJsonResponse: true });
87
+ res.on("close", () => {
88
+ void transport.close();
89
+ void server.close();
90
+ log(`POST ${MCP_PATH} ${rpc} ${res.statusCode} ${Date.now() - startedAt}ms`);
91
+ });
92
+ await server.connect(transport);
93
+ await transport.handleRequest(req, res, body);
94
+ }
95
+ export function createRemoteHandler(endpoint, log = () => { }) {
96
+ return async (req, res) => {
97
+ setCors(res);
98
+ const url = new URL(req.url || "/", "http://localhost");
99
+ if (req.method === "OPTIONS") {
100
+ res.writeHead(204);
101
+ res.end();
102
+ return;
103
+ }
104
+ if (url.pathname === "/health") {
105
+ sendJson(res, 200, { status: "ok", server: SERVER_NAME, version: SERVER_VERSION });
106
+ return;
107
+ }
108
+ if (url.pathname === "/" && req.method === "GET") {
109
+ res.writeHead(302, { Location: DEVELOPERS_URL });
110
+ res.end();
111
+ return;
112
+ }
113
+ if (url.pathname !== MCP_PATH) {
114
+ sendJson(res, 404, { error: "Not found" });
115
+ return;
116
+ }
117
+ if (req.method !== "POST") {
118
+ res.setHeader("Allow", "POST, OPTIONS");
119
+ rpcError(res, 405, JSONRPC_SERVER_ERROR, "Method not allowed: this server is stateless, use POST");
120
+ return;
121
+ }
122
+ try {
123
+ await handleMcpPost(req, res, endpoint, url, log);
124
+ }
125
+ catch (error) {
126
+ log(`POST ${MCP_PATH} failed: ${error instanceof Error ? error.message : String(error)}`);
127
+ if (!res.headersSent)
128
+ rpcError(res, 500, JSONRPC_SERVER_ERROR, "Internal server error");
129
+ }
130
+ };
131
+ }
132
+ //# sourceMappingURL=remote.js.map
package/build/server.js CHANGED
@@ -62,7 +62,7 @@ export function loadConfig() {
62
62
  const apiKey = process.env.CATASTROGPS_API_KEY;
63
63
  if (!apiKey) {
64
64
  console.error("[catastro-gps-mcp] ERROR: CATASTROGPS_API_KEY environment variable is required.\n" +
65
- "Get a free key (250 calls/month, failed lookups are free) at https://www.parcelgps.com/developers");
65
+ "Get a free key (25 calls/month, failed lookups are free) at https://www.parcelgps.com/developers");
66
66
  process.exit(1);
67
67
  }
68
68
  return { apiKey, ...loadEndpointConfig() };
@@ -5,8 +5,8 @@ export function registerGetBoundaries(server, client) {
5
5
  server.registerTool("get_boundaries", {
6
6
  title: "Get Parcel Boundaries",
7
7
  description: "Get the outline of a cadastral parcel as GeoJSON and/or a [lat, lng] ring, plus its " +
8
- "centroid and area, for mapping and GIS work. Accepts references from the same 30 " +
9
- "codes as get_parcel (every covered country except the United Kingdom, which is coordinates only).",
8
+ "centroid and area, for mapping and GIS work. Accepts references from the same 31 " +
9
+ "codes as get_parcel except the United Kingdom, which is coordinates only.",
10
10
  inputSchema: {
11
11
  reference: z.string().min(1).describe("Official cadastral reference"),
12
12
  country: z
@@ -1,16 +1,19 @@
1
1
  import { z } from "zod";
2
- import { COUNTRY_CODES_TEXT, CROP_LANGUAGES, SUPPORTED_COUNTRIES } from "../types/index.js";
2
+ import { COORDINATES_ONLY_MESSAGES, COUNTRY_CODES_TEXT, CROP_LANGUAGES, SUPPORTED_COUNTRIES, } from "../types/index.js";
3
3
  import { compact, errorResult, handleToolError, jsonResult } from "./shared.js";
4
4
  export function registerGetParcel(server, client) {
5
5
  server.registerTool("get_parcel", {
6
6
  title: "Get Parcel",
7
- description: "Look up a cadastral parcel in 29 European countries (including the Basque Country and Navarre " +
8
- "foral cadastres) by its official cadastral reference or by WGS84 coordinates. Returns the " +
7
+ description: "Look up a parcel in the official cadastre of 27 European countries (including the Basque Country and " +
8
+ "Navarre foral cadastres), by its official cadastral reference or by WGS84 coordinates, plus partial " +
9
+ "coverage in the United Kingdom (Scotland, coordinates only) and Sweden (agricultural blocks). Returns the " +
9
10
  "reference, location, address, municipality, area, land use and the parcel outline when " +
10
11
  "the official source provides them. The country is detected from the reference format or " +
11
12
  "the point when omitted. Where the parcel has crop or land-use parts it also returns their count " +
12
13
  "and a crop summary (crop and share of the area); the full list with outlines is " +
13
- "get_parcel_subparcels. United Kingdom: coordinates only. Codes: " + COUNTRY_CODES_TEXT + ".",
14
+ "get_parcel_subparcels. Croatia: cadastral municipality code + parcel number (334553-6250/3) or " +
15
+ "'6250/3 k.o. Zabok'. Ireland: registered land only. Every result names its official source and licence " +
16
+ "in the source field. Codes: " + COUNTRY_CODES_TEXT + ".",
14
17
  inputSchema: {
15
18
  reference: z
16
19
  .string()
@@ -29,7 +32,7 @@ export function registerGetParcel(server, client) {
29
32
  try {
30
33
  if (reference) {
31
34
  if (country === "UK") {
32
- return errorResult("MCP_002", "United Kingdom parcels can only be looked up by coordinates.");
35
+ return errorResult("MCP_002", COORDINATES_ONLY_MESSAGES[country]);
33
36
  }
34
37
  const { data: d, quota } = await client.getParcelByReference(reference, country, lang);
35
38
  return jsonResult(compact({
@@ -3,9 +3,9 @@ const log = (msg) => console.error(`[catastro-gps-mcp] ${msg}`);
3
3
  const PRICING_URL = "https://www.parcelgps.com/developers";
4
4
  const TOP_UP_URL = "https://parcelgps.com/app/developer";
5
5
  const FRIENDLY_MESSAGES = {
6
- KEY_AUTH_001: "Invalid API key format. Check CATASTROGPS_API_KEY.",
7
- KEY_AUTH_002: "Unknown API key. Check CATASTROGPS_API_KEY.",
8
- KEY_AUTH_003: "Invalid API key. Check CATASTROGPS_API_KEY.",
6
+ KEY_AUTH_001: "Invalid API key format. Check CATASTROGPS_API_KEY or the key of your remote connector.",
7
+ KEY_AUTH_002: "Unknown API key. Check CATASTROGPS_API_KEY or the key of your remote connector.",
8
+ KEY_AUTH_003: "Invalid API key. Check CATASTROGPS_API_KEY or the key of your remote connector.",
9
9
  KEY_AUTH_004: `Monthly quota used up. Upgrade at ${PRICING_URL} or turn on prepaid overage and top up at ${TOP_UP_URL}`,
10
10
  KEY_AUTH_005: "The API could not verify your organization. Try again later.",
11
11
  KEY_RATE_001: "Too many requests. Slow down and retry.",
@@ -3,6 +3,7 @@ export type CountryCode = (typeof SUPPORTED_COUNTRIES)[number];
3
3
  export declare const COORDINATES_ONLY_COUNTRIES: readonly ["UK"];
4
4
  export declare const REFERENCE_COUNTRIES: readonly ["ES", "PV", "NA", "PT", "FR", "IT", "DE", "AT", "CH", "LI", "BE", "NL", "LU", "PL", "CZ", "SK", "SI", "HR", "BG", "GR", "CY", "DK", "SE", "NO", "FI", "IS", "EE", "LV", "LT", "IE"];
5
5
  export type ReferenceCountryCode = (typeof REFERENCE_COUNTRIES)[number];
6
+ export declare const COORDINATES_ONLY_MESSAGES: Record<(typeof COORDINATES_ONLY_COUNTRIES)[number], string>;
6
7
  export declare const ENRICHMENT_COUNTRIES: readonly ["ES", "PV", "NA", "PT", "FR", "IT", "DE"];
7
8
  export type EnrichmentCountryCode = (typeof ENRICHMENT_COUNTRIES)[number];
8
9
  export declare const VALUE_HISTORY_COUNTRIES: readonly ["ES", "PV", "NA", "PT", "FR", "IT", "DE", "AT"];
@@ -565,5 +566,6 @@ export interface ServerConfig {
565
566
  apiKey: string;
566
567
  apiUrl: string;
567
568
  timeout: number;
569
+ userAgent?: string;
568
570
  }
569
571
  //# sourceMappingURL=index.d.ts.map
@@ -10,6 +10,9 @@ export const REFERENCE_COUNTRIES = [
10
10
  "BE", "NL", "LU", "PL", "CZ", "SK", "SI", "HR", "BG", "GR",
11
11
  "CY", "DK", "SE", "NO", "FI", "IS", "EE", "LV", "LT", "IE",
12
12
  ];
13
+ export const COORDINATES_ONLY_MESSAGES = {
14
+ UK: "United Kingdom parcels can only be looked up by coordinates, and only in Scotland.",
15
+ };
13
16
  export const ENRICHMENT_COUNTRIES = ["ES", "PV", "NA", "PT", "FR", "IT", "DE"];
14
17
  export const VALUE_HISTORY_COUNTRIES = ["ES", "PV", "NA", "PT", "FR", "IT", "DE", "AT"];
15
18
  export const SITE_ANALYSIS_COUNTRIES = [
@@ -1,4 +1,5 @@
1
1
  export declare const SERVER_NAME = "catastro-gps-mcp";
2
- export declare const SERVER_VERSION = "2.2.0";
3
- export declare const USER_AGENT = "catastro-gps-mcp/2.2.0";
2
+ export declare const SERVER_VERSION = "2.2.2";
3
+ export declare const USER_AGENT = "catastro-gps-mcp/2.2.2";
4
+ export declare const REMOTE_USER_AGENT = "catastro-gps-mcp-remote/2.2.2";
4
5
  //# sourceMappingURL=version.d.ts.map
package/build/version.js CHANGED
@@ -1,4 +1,5 @@
1
1
  export const SERVER_NAME = "catastro-gps-mcp";
2
- export const SERVER_VERSION = "2.2.0";
2
+ export const SERVER_VERSION = "2.2.2";
3
3
  export const USER_AGENT = `${SERVER_NAME}/${SERVER_VERSION}`;
4
+ export const REMOTE_USER_AGENT = `${SERVER_NAME}-remote/${SERVER_VERSION}`;
4
5
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "catastro-gps-mcp",
3
- "version": "2.2.0",
3
+ "version": "2.2.2",
4
4
  "mcpName": "com.parcelgps/catastro-gps",
5
- "description": "MCP server for cadastral parcels from 29 European countries (including the Basque Country and Navarre foral cadastres): reference, coordinates, address search in 27 countries, dwellings of Spanish buildings, geometry, terrain, climate, ground motion, solar, agriculture, market, score and comparison",
5
+ "description": "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 of Spanish buildings, geometry, terrain, climate, ground motion, solar, agriculture, market, score and comparison",
6
6
  "author": "The Hidden Panda <soporte@catastrogps.es>",
7
7
  "license": "MIT",
8
8
  "type": "module",
@@ -21,7 +21,7 @@
21
21
  "build": "tsc",
22
22
  "dev": "tsc --watch",
23
23
  "start": "node build/index.js",
24
- "start:sse": "node build/sse.js",
24
+ "start:http": "node build/http.js",
25
25
  "test": "vitest run",
26
26
  "test:watch": "vitest",
27
27
  "lint": "tsc --noEmit",
package/server.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
3
  "name": "com.parcelgps/catastro-gps",
4
4
  "title": "Catastro GPS",
5
- "description": "Cadastral parcels from 29 European countries, by reference in 27 and by coordinates in all 29",
5
+ "description": "Official cadastral parcels of 27 European countries by reference and coordinates, partial in UK, SE",
6
6
  "websiteUrl": "https://www.catastrogps.es/developers",
7
7
  "repository": {
8
8
  "url": "https://github.com/TheHiddenPandaDev/catastro_gps_mcp",
@@ -24,20 +24,20 @@
24
24
  ]
25
25
  }
26
26
  ],
27
- "version": "2.2.0",
27
+ "version": "2.2.2",
28
28
  "packages": [
29
29
  {
30
30
  "registryType": "npm",
31
31
  "registryBaseUrl": "https://registry.npmjs.org",
32
32
  "identifier": "catastro-gps-mcp",
33
- "version": "2.2.0",
33
+ "version": "2.2.2",
34
34
  "transport": {
35
35
  "type": "stdio"
36
36
  },
37
37
  "environmentVariables": [
38
38
  {
39
39
  "name": "CATASTROGPS_API_KEY",
40
- "description": "Catastro GPS API key. Free tier: 250 calls/month; failed lookups are free at https://www.catastrogps.es/developers",
40
+ "description": "Catastro GPS API key. Free tier: 25 calls/month; failed lookups are free at https://www.catastrogps.es/developers",
41
41
  "isRequired": true,
42
42
  "isSecret": true,
43
43
  "format": "string"
@@ -58,5 +58,20 @@
58
58
  }
59
59
  ]
60
60
  }
61
+ ],
62
+ "remotes": [
63
+ {
64
+ "type": "streamable-http",
65
+ "url": "https://mcp.parcelgps.com/mcp",
66
+ "headers": [
67
+ {
68
+ "name": "Authorization",
69
+ "description": "Bearer followed by your Parcel GPS API key. Free tier: 25 calls/month at https://www.parcelgps.com/developers",
70
+ "isRequired": true,
71
+ "isSecret": true,
72
+ "format": "string"
73
+ }
74
+ ]
75
+ }
61
76
  ]
62
77
  }