parseapi-mcp 1.11.2 → 1.11.4

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
@@ -53,6 +53,15 @@ For local stdio, pin the MCP package version in your application configuration a
53
53
 
54
54
  MCP packages older than 1.0.0 keep their existing behavior and use the team's default. Keep that default unchanged while older applications depend on it. Rolling back to a package without a version header restores the team default, so rollback only restores the old contract when that default has stayed unchanged. See [API versions and migration](https://parseapi.com/docs/versioning).
55
55
 
56
+ ## ISO identifiers
57
+
58
+ Country uses `iso_alpha3` and `iso_numeric`, State uses the full
59
+ `iso_subdivision` code such as `US-CA`, Language uses `iso_alpha3`, and Currency
60
+ uses `iso_numeric`. Primary `country`, `state`, `language` and `currency` codes
61
+ keep their meaning. Results retain the selected API contract's exact keys,
62
+ values, nulls and nesting. Earlier server contracts retain their earlier ISO
63
+ spellings. Use the existing lookup methods for each resource.
64
+
56
65
  ## Tools
57
66
 
58
67
  Full mode provides 68 local lookup tools and 67 hosted lookup tools, plus `discover` for local metadata and `preflight` for authenticated task estimates. `ip_self` is local only. `time` returns current local time and Unix seconds. It accepts a timezone or coordinates and defaults to UTC when both are omitted. `date` parses the supplied date, or returns today in UTC when omitted. Existing `timezone` calls remain supported with their original arguments. Every lookup returns the JSON the API serves.
@@ -88,16 +97,18 @@ Example tool arguments:
88
97
  | `time` | `{"timezone":"America/New_York","at":"2026-11-01T01:30:00","to":"UTC","disambiguation":"later"}` |
89
98
  | `date` | `{"date":"03/04/2026","format":"dmy"}` |
90
99
  | `elevation` | `{"lat":35.2271,"lon":-80.8431}` |
91
- | `elevation` | `{"points":"35.2271,-80.8431|40.7128,-74.006"}` |
92
- | `elevation` | `{"path":"35.2271,-80.8431|35.5951,-82.5515","samples":100}` |
100
+ | `elevation` | `{"points":"39.7392,-104.9903|39.75,-104.98"}` |
101
+ | `elevation` | `{"path":"39.7392,-104.9903|39.75,-104.98","samples":100}` |
93
102
 
94
103
  Time uses `disambiguation` only for offsetless `at` with `to` or `targets`. The default `compatible` selects the earlier repeated time or advances a skipped time. `earlier` and `later` choose the respective instant. `reject` returns `ambiguous_time` for repeated times and `nonexistent_time` for skipped times. Prefer it for user-entered appointments. Ask for an explicit offset or the user's choice before retrying a rejected local time. Explicit offsets select an instant directly. Time deep is available in the same pooled request on every plan.
95
104
 
96
105
  Time Deep includes nullable `resolution`. Resolution reports `kind` (`unique`, `overlap` or `gap`), `policy`, signed `adjustment_seconds`, and chronological `alternatives` with exact local `at`, Unix seconds and UTC offset. Unique wall times have no alternatives. Explicit-offset timestamps, current clocks, non-conversion lookups and unknown source zones have null resolution.
97
106
 
98
- 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.
107
+ Elevation accepts exactly one of `lat` and `lon`, `points`, or `path` with `samples`. A point list supports up to 512 points per local batch 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. An accepted local list uses one pooled request, with JSON POST selected automatically for long URLs.
108
+
109
+ 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. An accepted local path uses one pooled request. `samples` is invalid with a single coordinate or a point list.
99
110
 
100
- 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.
111
+ Each local batch is limited to 25 km between any two coordinates and 12 distinct terrain files in total across the fine grid and all possible global fallback files. For paths, both the supplied vertices and generated samples must fit the 25 km span. The terrain file budget applies to the sampled coordinates. This is a span limit, not a limit on cumulative path length. Send longer or more spread-out routes in shorter sections. An over-limit batch returns HTTP 400. MCP does not silently split or discard coordinates.
101
112
 
102
113
  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).
103
114
 
@@ -223,7 +234,7 @@ MIT licensed.
223
234
 
224
235
  ## Optional detail
225
236
 
226
- Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym and country codes, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, lat, lon }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
237
+ Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym, `iso_alpha3` and `iso_numeric` country identifiers, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, lat, lon }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
227
238
 
228
239
  Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date, Language, Emoji, Phone and Point include detail on every plan. Geographic profiles, Name evidence and NAICS definitions require a paid plan. Carrier and HLR detail stays inside the same metered core unit, including Free allowance units, with no additional charge or second gate.
229
240
 
@@ -237,9 +248,9 @@ Call the `stack` tool:
237
248
  {"domain":"example.com"}
238
249
  ```
239
250
 
240
- Pass a public hostname without a scheme, path, port or IP address. Stack returns the checked URL and `checked_at` time, followed by `scope`, `pages` and `partial`. `scope` is `homepage` or `site`; `pages` counts successfully checked HTML pages. `partial` is true for homepage-only or incomplete bounded site checks. False means the known in-scope candidates were completed, not that every page on a website was visited. A homepage result has `scope: "homepage"`, `pages: 1` and `partial: true`.
251
+ Stack checks static homepage HTML and response headers. It returns the checked URL, original `checked_at` time and eight technology arrays.
241
252
 
242
- `cms`, `servers`, `frameworks`, `ecommerce`, `analytics`, `chat`, `payments` and `hosting` are arrays because a site can use several technologies in each category. Each entry contains `technology`, `name` and nullable `version`. Technology codes are open strings. A successful check uses empty arrays for categories with no matches. When no HTML page could be checked, `checked_at` and all categories are null, `pages` is 0 and `partial` is null. Unknown or conflicting versions are null. Missing detections do not prove absence.
253
+ `cms`, `servers`, `frameworks`, `ecommerce`, `analytics`, `chat`, `payments` and `hosting` are arrays because a site can use several technologies in each category. Each entry contains `technology`, `name` and nullable `version`. Technology codes are open strings. A successful check uses empty arrays for categories with no matches. When no HTML page could be checked, `checked_at` and all categories are null. Unknown or conflicting versions are null. Detections describe the checked homepage.
243
254
 
244
255
  Successful checks may be reused for up to 24 hours. `pretty` optionally formats the wire JSON. Stack uses your plan's request allowance and API version 2.0.0 selected by this client.
245
256
 
@@ -180,7 +180,7 @@ var agent_catalog_default = {
180
180
  "A live registry query on every request"
181
181
  ],
182
182
  required_context: [
183
- "domain: a hostname rather than a URL or email address"
183
+ "domain: a registrable domain such as example.com or example.co.uk, not a URL or email address; Unicode or ASCII IDNA accepted"
184
184
  ],
185
185
  freshness: {
186
186
  mode: "observation_reuse",
@@ -196,7 +196,7 @@ var agent_catalog_default = {
196
196
  available: {
197
197
  true: "Registry reported unregistered",
198
198
  false: "Registry reported registered",
199
- null: "No usable current registry observation; availability is unknown"
199
+ null: "No usable current registry observation, or this name is a subdomain, public suffix or unsupported registration suffix; availability is unknown"
200
200
  },
201
201
  deep: {
202
202
  omitted: "Not requested",
@@ -204,6 +204,12 @@ var agent_catalog_default = {
204
204
  },
205
205
  "deep.registration": {
206
206
  omitted: "No entitled, usable registration observation"
207
+ },
208
+ "deep.registration.dnssec": {
209
+ true: "Registry supplied evidence of signed delegation",
210
+ false: "Registry supplied evidence of unsigned delegation",
211
+ null: "Registry did not supply delegation-signing evidence",
212
+ omitted: "No usable registered-domain detail; an unregistered observation contains only registered=false"
207
213
  }
208
214
  },
209
215
  billing: {
@@ -422,8 +428,8 @@ var agent_catalog_default = {
422
428
  operation: "country",
423
429
  endpoint: "GET /country/{code}",
424
430
  determines: [
425
- "Country everyday reference by ISO2, ISO3 or name; Core includes name, name_full, name_local, demonym, ISO3 and numeric identity, continent, region and subregion, currency, languages, calling code, flag, timezones, neighboring countries, bloc memberships and capital object (name, lat, lon)",
426
- "With entitled deep=true, population, total area, physical geography and national statistics, including gdp_usd, gdp_per_capita_usd, population_growth_percent, urban_population_percent, internet_users_percent and elevation_average in meters"
431
+ "Country everyday identity and references by ISO2, ISO3 or name: names (name, name_full, name_local), demonym, primary country code, iso_alpha3 and iso_numeric, continent, region, subregion, currency, calling code, flag, languages, timezones, borders, bloc codes and capital with coordinates",
432
+ "With entitled deep=true, specialist geography, population, economic and national reference attributes"
427
433
  ],
428
434
  does_not_determine: [
429
435
  "A live census or uniform observation date for every field",
@@ -452,16 +458,27 @@ var agent_catalog_default = {
452
458
  null: "Unknown",
453
459
  zero: "Reported landlocked coastline"
454
460
  },
455
- "deep.tax": {
461
+ deep: {
462
+ omitted: "Not requested",
463
+ empty_object: "Requested but the plan does not unlock the profile"
464
+ },
465
+ "deep.tax.name": {
456
466
  null: "No national consumption levy is named; local levies may still apply"
457
467
  },
458
- "deep.tax_rate": {
468
+ "deep.tax.rate": {
459
469
  null: "Unavailable or no national levy applies",
460
470
  zero: "Known zero national reference rate"
461
471
  },
462
- deep: {
463
- omitted: "Not requested",
464
- empty_object: "Requested but the plan does not unlock the profile"
472
+ "capital.name": {
473
+ null: "Selected capital name unavailable"
474
+ },
475
+ "capital.lat": {
476
+ null: "Selected capital latitude unavailable",
477
+ zero: "Known latitude at the equator"
478
+ },
479
+ "capital.lon": {
480
+ null: "Selected capital longitude unavailable",
481
+ zero: "Known longitude at the prime meridian"
465
482
  }
466
483
  },
467
484
  billing: {
@@ -2232,7 +2249,7 @@ function registerBulk(server, key, transport) {
2232
2249
  // package.json
2233
2250
  var package_default = {
2234
2251
  name: "parseapi-mcp",
2235
- version: "1.11.2",
2252
+ version: "1.11.4",
2236
2253
  mcpName: "com.parseapi/mcp",
2237
2254
  description: "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
2238
2255
  keywords: [
@@ -2282,7 +2299,7 @@ var package_default = {
2282
2299
  dependencies: {
2283
2300
  "@modelcontextprotocol/node": "^2.0.0",
2284
2301
  "@modelcontextprotocol/server": "^2.0.0",
2285
- "@parseapi/sdk": "^1.12.4",
2302
+ "@parseapi/sdk": "^1.12.6",
2286
2303
  zod: "^4.0.0"
2287
2304
  },
2288
2305
  devDependencies: {
@@ -2461,7 +2478,7 @@ function buildServer(key, transport, options = {}) {
2461
2478
  );
2462
2479
  tool(
2463
2480
  "country",
2464
- "Country everyday reference: name, name_full, name_local, demonym, ISO3 and numeric codes, continent, region and subregion, currency, languages, calling code, flag, timezones, borders, bloc memberships and capital object (name, lat, lon). Paid Deep adds population, total area and national statistics (gdp_usd, gdp_per_capita_usd, population_growth_percent, urban_population_percent and internet_users_percent), geography including elevation_average in meters, and a tax reference object (name, rate) and locale conventions. Unknown values stay null.",
2481
+ "Country everyday reference: name, name_full, name_local, demonym, iso_alpha3 and iso_numeric identifiers, continent, region and subregion, currency, languages, calling code, flag, timezones, borders, bloc memberships and capital object (name, lat, lon). Paid Deep adds population, total area and national statistics (gdp_usd, gdp_per_capita_usd, population_growth_percent, urban_population_percent and internet_users_percent), geography including elevation_average in meters, and a tax reference object (name, rate) and locale conventions. Unknown values stay null.",
2465
2482
  { code: iso2("country code"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
2466
2483
  (c, a, request) => c.country(a.code, { ...request, deep: a.deep })
2467
2484
  );
@@ -2473,7 +2490,7 @@ function buildServer(key, transport, options = {}) {
2473
2490
  );
2474
2491
  tool(
2475
2492
  "state",
2476
- "Look up a state or province by code or name. Deep adds its demographic and tax profile on paid plans. Pass country to resolve a colliding code.",
2493
+ "Look up a state or province by code or name, with its full iso_subdivision identifier. Deep adds its demographic and tax profile on paid plans. Pass country to resolve a colliding code.",
2477
2494
  {
2478
2495
  code: z5.string().describe("State code or name, e.g. colorado, NC"),
2479
2496
  country: countryOpt,
@@ -2838,13 +2855,13 @@ function buildServer(key, transport, options = {}) {
2838
2855
  );
2839
2856
  tool(
2840
2857
  "stack",
2841
- "Identify website technologies and available versions by category. Requires a hostname only. CMS, servers, frameworks, ecommerce, analytics, chat, payments and hosting are arrays of technology, name and nullable version. checked_at gives the check time. Scope is homepage or site; pages counts successfully checked HTML pages. Partial is true for homepage-only or incomplete bounded checks, false only when known in-scope candidates finished, never a guarantee every page was visited. When no page could be checked, checked_at and all categories are null, pages is 0 and partial is null. Empty arrays mean no matches. Missing detections do not prove absence. Uses one request from the plan allowance. Successful checks may be reused for up to 24 hours.",
2858
+ "Identify website technologies and available versions by category. Requires a hostname only. CMS, servers, frameworks, ecommerce, analytics, chat, payments and hosting are arrays of technology, name and nullable version. checked_at gives the check time. The check covers static homepage HTML and response headers. When no page could be checked, checked_at and all categories are null. Empty arrays mean no matches. Detections describe the checked homepage. Uses one request from the plan allowance. Successful checks may be reused for up to 24 hours.",
2842
2859
  { domain: z5.string().min(1).max(253).describe("Public website hostname only, e.g. example.com. No scheme, path, port or IP address."), pretty: z5.boolean().optional().describe("Format the JSON response.") },
2843
2860
  (c, a, request) => c.stack(a.domain, { ...request, pretty: a.pretty })
2844
2861
  );
2845
2862
  tool(
2846
2863
  "domain",
2847
- "Check whether a domain is registered. Deep adds registration dates, registrar, status and DNSSEC, included on paid plans. Use dns for DNS records and mx for mail routing.",
2864
+ "Check whether a domain is registered: available is true for unregistered, false for registered, and null when unknown. Deep adds available registration dates, registrar, status and DNSSEC on paid plans. Missing or null DNSSEC is unknown, while false means unsigned. Use dns for DNS records and mx for mail routing.",
2848
2865
  { domain: z5.string().describe("Domain name, e.g. example.com"), deep: deep.describe("Include registration details on a paid plan.") },
2849
2866
  (c, a, request) => c.domain(a.domain, { ...request, deep: a.deep })
2850
2867
  );
@@ -2909,7 +2926,7 @@ function buildServer(key, transport, options = {}) {
2909
2926
  );
2910
2927
  tool(
2911
2928
  "language",
2912
- "Language names, script and writing direction. Deep adds ISO3 and country associations on every plan.",
2929
+ "Language names, script, writing direction, iso_alpha3 identifier and country associations.",
2913
2930
  { code: z5.string().describe("Language code, e.g. en, ja, gsw"), deep: deep.describe("Include optional detail on every plan.") },
2914
2931
  (c, a, request) => c.language(a.code, { ...request, deep: a.deep })
2915
2932
  );
package/dist/http.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-WFVD6M4S.js";
5
+ } from "./chunk-75AQNY3K.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-WFVD6M4S.js";
5
+ } from "./chunk-75AQNY3K.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-WFVD6M4S.js";
5
+ } from "./chunk-75AQNY3K.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.11.2",
3
+ "version": "1.11.4",
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/node": "^2.0.0",
52
52
  "@modelcontextprotocol/server": "^2.0.0",
53
- "@parseapi/sdk": "^1.12.4",
53
+ "@parseapi/sdk": "^1.12.6",
54
54
  "zod": "^4.0.0"
55
55
  },
56
56
  "devDependencies": {