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 +9 -0
- package/README.md +41 -7
- package/build/client/catastrogps-api.d.ts +1 -0
- package/build/client/catastrogps-api.js +3 -1
- package/build/http.d.ts +3 -0
- package/build/http.js +15 -0
- package/build/remote.d.ts +12 -0
- package/build/remote.js +132 -0
- package/build/server.js +1 -1
- package/build/tools/get-boundaries.js +2 -2
- package/build/tools/get-parcel.js +8 -5
- package/build/tools/shared.js +3 -3
- package/build/types/index.d.ts +2 -0
- package/build/types/index.js +3 -0
- package/build/version.d.ts +3 -2
- package/build/version.js +2 -1
- package/package.json +3 -3
- package/server.json +19 -4
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 **
|
|
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
|
-
- **
|
|
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.**
|
|
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
|
|
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) |
|
|
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 |
|
|
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 |
|
|
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
|
|
@@ -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":
|
|
110
|
+
"User-Agent": this.userAgent,
|
|
109
111
|
};
|
|
110
112
|
if (body !== undefined) {
|
|
111
113
|
headers["Content-Type"] = "application/json";
|
package/build/http.d.ts
ADDED
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
|
package/build/remote.js
ADDED
|
@@ -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 (
|
|
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
|
|
9
|
-
"codes as get_parcel
|
|
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
|
|
8
|
-
"foral cadastres) by its official cadastral reference or by WGS84 coordinates
|
|
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.
|
|
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",
|
|
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({
|
package/build/tools/shared.js
CHANGED
|
@@ -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.",
|
package/build/types/index.d.ts
CHANGED
|
@@ -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
|
package/build/types/index.js
CHANGED
|
@@ -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 = [
|
package/build/version.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export declare const SERVER_NAME = "catastro-gps-mcp";
|
|
2
|
-
export declare const SERVER_VERSION = "2.2.
|
|
3
|
-
export declare const USER_AGENT = "catastro-gps-mcp/2.2.
|
|
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.
|
|
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.
|
|
3
|
+
"version": "2.2.2",
|
|
4
4
|
"mcpName": "com.parcelgps/catastro-gps",
|
|
5
|
-
"description": "MCP server for cadastral parcels from
|
|
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:
|
|
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": "
|
|
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.
|
|
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.
|
|
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:
|
|
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
|
}
|