parseapi-mcp 1.11.3 → 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.
@@ -225,7 +234,7 @@ MIT licensed.
225
234
 
226
235
  ## Optional detail
227
236
 
228
- 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.
229
238
 
230
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.
231
240
 
@@ -239,9 +248,9 @@ Call the `stack` tool:
239
248
  {"domain":"example.com"}
240
249
  ```
241
250
 
242
- 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.
243
252
 
244
- `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.
245
254
 
246
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.
247
256
 
@@ -428,8 +428,8 @@ var agent_catalog_default = {
428
428
  operation: "country",
429
429
  endpoint: "GET /country/{code}",
430
430
  determines: [
431
- "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)",
432
- "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"
433
433
  ],
434
434
  does_not_determine: [
435
435
  "A live census or uniform observation date for every field",
@@ -458,16 +458,27 @@ var agent_catalog_default = {
458
458
  null: "Unknown",
459
459
  zero: "Reported landlocked coastline"
460
460
  },
461
- "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": {
462
466
  null: "No national consumption levy is named; local levies may still apply"
463
467
  },
464
- "deep.tax_rate": {
468
+ "deep.tax.rate": {
465
469
  null: "Unavailable or no national levy applies",
466
470
  zero: "Known zero national reference rate"
467
471
  },
468
- deep: {
469
- omitted: "Not requested",
470
- 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"
471
482
  }
472
483
  },
473
484
  billing: {
@@ -2238,7 +2249,7 @@ function registerBulk(server, key, transport) {
2238
2249
  // package.json
2239
2250
  var package_default = {
2240
2251
  name: "parseapi-mcp",
2241
- version: "1.11.3",
2252
+ version: "1.11.4",
2242
2253
  mcpName: "com.parseapi/mcp",
2243
2254
  description: "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
2244
2255
  keywords: [
@@ -2288,7 +2299,7 @@ var package_default = {
2288
2299
  dependencies: {
2289
2300
  "@modelcontextprotocol/node": "^2.0.0",
2290
2301
  "@modelcontextprotocol/server": "^2.0.0",
2291
- "@parseapi/sdk": "^1.12.5",
2302
+ "@parseapi/sdk": "^1.12.6",
2292
2303
  zod: "^4.0.0"
2293
2304
  },
2294
2305
  devDependencies: {
@@ -2467,7 +2478,7 @@ function buildServer(key, transport, options = {}) {
2467
2478
  );
2468
2479
  tool(
2469
2480
  "country",
2470
- "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.",
2471
2482
  { code: iso2("country code"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
2472
2483
  (c, a, request) => c.country(a.code, { ...request, deep: a.deep })
2473
2484
  );
@@ -2479,7 +2490,7 @@ function buildServer(key, transport, options = {}) {
2479
2490
  );
2480
2491
  tool(
2481
2492
  "state",
2482
- "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.",
2483
2494
  {
2484
2495
  code: z5.string().describe("State code or name, e.g. colorado, NC"),
2485
2496
  country: countryOpt,
@@ -2844,7 +2855,7 @@ function buildServer(key, transport, options = {}) {
2844
2855
  );
2845
2856
  tool(
2846
2857
  "stack",
2847
- "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.",
2848
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.") },
2849
2860
  (c, a, request) => c.stack(a.domain, { ...request, pretty: a.pretty })
2850
2861
  );
@@ -2915,7 +2926,7 @@ function buildServer(key, transport, options = {}) {
2915
2926
  );
2916
2927
  tool(
2917
2928
  "language",
2918
- "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.",
2919
2930
  { code: z5.string().describe("Language code, e.g. en, ja, gsw"), deep: deep.describe("Include optional detail on every plan.") },
2920
2931
  (c, a, request) => c.language(a.code, { ...request, deep: a.deep })
2921
2932
  );
package/dist/http.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-HBJ2FCLM.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-HBJ2FCLM.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-HBJ2FCLM.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.3",
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.5",
53
+ "@parseapi/sdk": "^1.12.6",
54
54
  "zod": "^4.0.0"
55
55
  },
56
56
  "devDependencies": {