parseapi-mcp 1.3.0 → 1.5.0

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/README.md CHANGED
@@ -80,6 +80,15 @@ Example tool arguments:
80
80
  | `time` | `{"timezone":"America/New_York","at":"2026-09-05T09:00:00","to":"Asia/Tokyo"}` |
81
81
  | `time` | `{"lat":40.71,"lon":-74.01}` |
82
82
  | `date` | `{"date":"03/04/2026","format":"dmy"}` |
83
+ | `elevation` | `{"lat":35.2271,"lon":-80.8431}` |
84
+ | `elevation` | `{"points":"35.2271,-80.8431|40.7128,-74.006"}` |
85
+ | `elevation` | `{"path":"35.2271,-80.8431|35.5951,-82.5515","samples":100}` |
86
+
87
+ Elevation accepts exactly one of `lat` and `lon`, `points`, or `path` with `samples`. A point list supports up to 512 coordinates as `lat,lon` pairs separated by `|`, or `enc:` followed by a Google encoded polyline, with at most 12000 characters. The `points` response array preserves input order and duplicate coordinates. Each sample includes meters, feet and grid resolution in meters. Unknown samples stay null. A list uses one pooled request, with JSON POST selected automatically for long URLs.
88
+
89
+ A path uses the same string formats with 2-512 vertices and a required integer `samples` count from 2 to 512. The response `points` include both endpoints, spaced uniformly by cumulative great-circle distance along the path. Each segment follows the shortest arc. A segment with antipodal endpoints is rejected because it does not define a unique arc. A path uses one pooled request. `samples` is invalid with a single coordinate or a point list.
90
+
91
+ Australian `postal` lookup returns core `localities` with suburb choices (`city`, `state`, `state_name`). Null or an omitted field means unknown, while `[]` means the reviewed reference has no eligible choices. A single choice can coexist with `city: null`. Ask for the user's suburb choice and preserve manual entry. These are geographic choices, not mailing-address verification. AU Postal tool results include a separate source notice after the JSON. [G-NAF source, adaptations and licence](https://parseapi.com/legal/attribution#postal-au).
83
92
 
84
93
  Address lookup returns standardized components and registration status for the US and France. Its `deep` object is currently empty. Company lookup returns validity, registration status and business details when available. `address_search` also accepts `postal` and `ip` to narrow or rank matches. French search needs `country: "FR"` and either `postal` or `city`.
85
94
 
@@ -118,7 +127,7 @@ The estimate allows up to three attempts per ordinary lookup and one per Email D
118
127
  For a compact tool catalog, set `PARSEAPI_MCP_MODE=compact` on the MCP process:
119
128
 
120
129
  ```bash
121
- PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@1.3.0
130
+ PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@1.5.0
122
131
  ```
123
132
 
124
133
  Set `PARSEAPI_KEY` in the process environment for lookups. Compact mode advertises three tools, `discover`, `preflight` and `lookup`. After discovering an operation, pass its exact name and arguments:
@@ -372,8 +372,9 @@ function registerPreflight(server, client, transport) {
372
372
  }
373
373
 
374
374
  // src/registry.ts
375
- var VERSION = "1.3.0";
375
+ var VERSION = "1.5.0";
376
376
  var API_VERSION = "2.0.0";
377
+ var AU_POSTAL_NOTICE = "Incorporates or developed using G-NAF \xA9 Geoscape Australia licensed by the Commonwealth of Australia under the Open Geo-coded National Address File (G-NAF) End User Licence Agreement. Geographic choices are not mailing-address verification. Source, adaptations and licence: https://parseapi.com/legal/attribution#postal-au";
377
378
  var deep = z3.boolean().optional().describe("Include the nested deep object when available. Pricing depends on the operation.");
378
379
  var lat = z3.number().min(-90).max(90).describe("Latitude in decimal degrees");
379
380
  var lon = z3.number().min(-180).max(180).describe("Longitude in decimal degrees");
@@ -446,7 +447,12 @@ function buildServer(key, transport, options = {}) {
446
447
  signal,
447
448
  ...localized && typeof requested === "string" ? { lang: requested } : {}
448
449
  };
449
- return ok(await fn(parse, args, request));
450
+ const data = await fn(parse, args, request);
451
+ const result = ok(data);
452
+ if (["postal", "postal_nearby", "postal_distance"].includes(name) && data && typeof data === "object" && "country" in data && data.country === "AU") {
453
+ result.content.push({ type: "text", text: AU_POSTAL_NOTICE });
454
+ }
455
+ return result;
450
456
  } catch (err) {
451
457
  return toErrorResult(err);
452
458
  }
@@ -628,7 +634,7 @@ function buildServer(key, transport, options = {}) {
628
634
  );
629
635
  tool(
630
636
  "postal",
631
- "Resolve a postal code to its place, coordinates and timezone. Deep adds area, population with its reporting period, tax references, neighbors and metro associations on paid plans. property_tax is a nullable area statistic with annual_median, currency and period: median annual tax payable on owner-occupied homes, adjusted to the final year of the period. It is not a rate or property bill. Unsupported, missing and censored estimates are null. Tax rates are percentages and alternative geographic references, not additive.",
637
+ "Resolve a postal code to its place, coordinates and timezone. Australian core localities lists suburb choices with city, state and state_name. Null or missing means unknown, and [] means no eligible choices in the reviewed reference. A single choice can coexist with city null, so do not infer a city or a user selection. These are geographic choices, not mailing-address verification. Deep adds area, population with its reporting period, tax references, neighbors and metro associations on paid plans. property_tax is a nullable area statistic with annual_median, currency and period: median annual tax payable on owner-occupied homes, adjusted to the final year of the period. It is not a rate or property bill. Unsupported, missing and censored estimates are null. Tax rates are percentages and alternative geographic references, not additive.",
632
638
  {
633
639
  code: z3.string().describe("Postal or ZIP code, e.g. SW1A 1AA, 28202"),
634
640
  country: countryOpt,
@@ -700,9 +706,27 @@ function buildServer(key, transport, options = {}) {
700
706
  );
701
707
  tool(
702
708
  "elevation",
703
- "Elevation in meters at coordinates.",
704
- { lat, lon },
705
- (c, a, request) => c.elevation(a.lat, a.lon, request)
709
+ "Elevation in meters and feet with grid resolution in meters. Choose lat and lon for one sample, points for supplied coordinates in order, or path with samples for evenly spaced great-circle samples including both endpoints. Lists and paths use one pooled request. Unknown elevations stay null.",
710
+ {
711
+ lat: lat.optional(),
712
+ lon: lon.optional(),
713
+ points: z3.string().min(1).max(12e3).optional().describe("lat,lon pairs separated by |, or enc: followed by a Google polyline. At most 512 points and 12000 characters. Omit lat and lon."),
714
+ path: z3.string().min(1).max(12e3).optional().describe("Path with 2-512 vertices as lat,lon pairs separated by |, or enc: followed by a Google polyline. At most 12000 characters. Segments follow the shortest great-circle arc. Segments with antipodal endpoints are invalid. Requires samples. Omit lat, lon and points."),
715
+ samples: z3.number().int().min(2).max(512).optional().describe("Number of evenly spaced samples along the path, including both endpoints. Required with path and invalid without it.")
716
+ },
717
+ (c, a, request) => {
718
+ if (a.path !== void 0) {
719
+ return c.elevation.path(a.path, a.samples, request);
720
+ }
721
+ if (a.points !== void 0) {
722
+ return c.elevation.points(a.points, request);
723
+ }
724
+ return c.elevation(a.lat, a.lon, request);
725
+ },
726
+ (schema) => schema.refine(
727
+ (args) => args.path !== void 0 ? args.samples !== void 0 && args.lat === void 0 && args.lon === void 0 && args.points === void 0 : args.samples === void 0 && (args.points !== void 0 ? args.lat === void 0 && args.lon === void 0 : args.lat !== void 0 && args.lon !== void 0),
728
+ { message: "Pass lat and lon, points, or path with samples." }
729
+ )
706
730
  );
707
731
  tool(
708
732
  "weather",
package/dist/http.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-TPX6WLKM.js";
5
+ } from "./chunk-3CF6NRFS.js";
6
6
 
7
7
  // src/http.ts
8
8
  import { createServer } from "http";
package/dist/registry.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  VERSION,
4
4
  buildServer
5
- } from "./chunk-TPX6WLKM.js";
5
+ } from "./chunk-3CF6NRFS.js";
6
6
  export {
7
7
  VERSION,
8
8
  buildServer
package/dist/stdio.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-TPX6WLKM.js";
5
+ } from "./chunk-3CF6NRFS.js";
6
6
 
7
7
  // src/stdio.ts
8
8
  import { serveStdio } from "@modelcontextprotocol/server/stdio";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "parseapi-mcp",
3
- "version": "1.3.0",
3
+ "version": "1.5.0",
4
4
  "mcpName": "com.parseapi/mcp",
5
5
  "description": "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
6
6
  "keywords": [
@@ -50,7 +50,7 @@
50
50
  "dependencies": {
51
51
  "@modelcontextprotocol/server": "^2.0.0",
52
52
  "@modelcontextprotocol/node": "^2.0.0",
53
- "@parseapi/sdk": "^1.3.0",
53
+ "@parseapi/sdk": "^1.5.0",
54
54
  "zod": "^4.0.0"
55
55
  },
56
56
  "devDependencies": {