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 +18 -7
- package/dist/{chunk-WFVD6M4S.js → chunk-75AQNY3K.js} +33 -16
- package/dist/http.js +1 -1
- package/dist/registry.js +1 -1
- package/dist/stdio.js +1 -1
- package/package.json +2 -2
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":"
|
|
92
|
-
| `elevation` | `{"path":"
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
426
|
-
"With entitled deep=true,
|
|
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
|
-
|
|
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.
|
|
468
|
+
"deep.tax.rate": {
|
|
459
469
|
null: "Unavailable or no national levy applies",
|
|
460
470
|
zero: "Known zero national reference rate"
|
|
461
471
|
},
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
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.
|
|
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.
|
|
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,
|
|
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.
|
|
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
|
|
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
|
|
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
package/dist/registry.js
CHANGED
package/dist/stdio.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "parseapi-mcp",
|
|
3
|
-
"version": "1.11.
|
|
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.
|
|
53
|
+
"@parseapi/sdk": "^1.12.6",
|
|
54
54
|
"zod": "^4.0.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|