parseapi-mcp 1.13.0 → 1.14.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
@@ -1,12 +1,14 @@
1
1
  # parseapi-mcp
2
2
 
3
+ This package selects HTTP API `2.2.0`. Its SDK dependency is pinned to `1.15.0`. Use the `api22` npm tag to opt in; the `latest` and `api21` tags keep their existing contracts.
4
+
3
5
  Official ParseAPI MCP server. Look up places, addresses, companies, email, phone, weather, timezones, dates and more from your AI agent.
4
6
 
5
7
  ## Hosted
6
8
 
7
9
  One URL, nothing to install. Add the server and sign in once in the browser. Free plan works.
8
10
 
9
- The shared hosted service remains on API 2.0. Installing this package selects API 2.1 for your local server without changing the shared service.
11
+ Installing a local package does not update the shared hosted service. Hosted activation is reviewed separately.
10
12
 
11
13
  ```json
12
14
  {
@@ -40,7 +42,7 @@ CI and headless setups skip the browser with a key from [parseapi.com](https://p
40
42
  "mcpServers": {
41
43
  "parseAPI": {
42
44
  "command": "npx",
43
- "args": ["-y", "parseapi-mcp@1.13.0"],
45
+ "args": ["-y", "parseapi-mcp@api22"],
44
46
  "env": { "PARSEAPI_KEY": "your-api-key" }
45
47
  }
46
48
  }
@@ -49,7 +51,7 @@ CI and headless setups skip the browser with a key from [parseapi.com](https://p
49
51
 
50
52
  ## API versions
51
53
 
52
- Since version 1.0.0, the package explicitly selects the API contract supported by this MCP package. This version sends `X-API-Version: 2.1.0` on every API tool request, matching its tool descriptions and SDK response types. The contract is fixed for local stdio and HTTP servers running this package, including retries. The shared hosted service remains on its existing API 2.0 release. Your key, OAuth identity and team's saved default stay the same. The API still accepts earlier `Parse-Version` request pins.
54
+ Since version 1.0.0, the package explicitly selects the API contract supported by this MCP package. This version sends `X-API-Version: 2.2.0` on every API tool request, matching its tool descriptions and SDK response types. The contract is fixed for local stdio and HTTP servers running this package, including retries. The shared hosted service remains on its existing API 2.0 release. Your key, OAuth identity and team's saved default stay the same. The API still accepts earlier `Parse-Version` request pins.
53
55
 
54
56
  For local stdio, pin the MCP package version in your application configuration and test the new release before deploying it. A future major MCP upgrade can select a newer API contract. There is no version argument to add to individual tool calls. The hosted service uses the API contract supported by its deployed MCP release.
55
57
 
@@ -58,8 +60,9 @@ MCP packages older than 1.0.0 keep their existing behavior and use the team's de
58
60
  ## ISO identifiers
59
61
 
60
62
  Country uses `iso_alpha3` and `iso_numeric`, State uses the full
61
- `iso_subdivision` code such as `US-CA`, Language uses `iso_alpha3`, and Currency
62
- uses `iso_numeric`. Primary `country`, `state`, `language` and `currency` codes
63
+ `iso_code` such as `US-CA`, Language uses `iso_alpha3`, and Currency
64
+ uses `iso_numeric`. County lookup and State county-list items include nullable
65
+ `iso_code` for an exact recorded ISO 3166-2 assignment; unsupported assignments stay null. Primary `country`, `state`, `language` and `currency` codes
63
66
  keep their meaning. Results retain the selected API contract's exact keys,
64
67
  values, nulls and nesting. Earlier server contracts retain their earlier ISO
65
68
  spellings. Use the existing lookup methods for each resource.
@@ -161,7 +164,7 @@ The estimate allows up to three attempts per ordinary lookup and one per Email D
161
164
  For a compact tool catalog, set `PARSEAPI_MCP_MODE=compact` on the MCP process:
162
165
 
163
166
  ```bash
164
- PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@1.6.0
167
+ PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@api22
165
168
  ```
166
169
 
167
170
  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:
@@ -340,6 +343,12 @@ The 2.0 API is a temporary migration bridge for older installed clients. There i
340
343
 
341
344
  ## Upgrade to API 2.1
342
345
 
343
- This version selects API `2.1.0`. Update existing `.deep` property reads to the fields at their natural homes, such as `country.population`. User-Agent identities are objects; Postal tax and Weather observations keep their documented object homes. Paid profile detail is automatic in API 2.1. Existing explicit depth requests remain supported; verification stays explicit.
346
+ API `2.1.0` introduced natural fields. Update existing `.deep` property reads to the fields at their natural homes, such as `country.population`. User-Agent identities are objects; Postal tax and Weather observations keep their documented object homes. Paid profile detail is automatic in API 2.1. Existing explicit depth requests remain supported; verification stays explicit.
344
347
 
345
348
  **This minor version changes existing field reads.** Upgrade the SDK and your application reads together. Existing factories remain. Email verification is explicit and includes basic validation; Carrier/HLR need no extra detail request. Preserve missing values, `null`, `false` and `0`.
349
+
350
+ ## County migration: HTTP API 2.2
351
+
352
+ This source selects HTTP API `2.2.0`. County is the public name for counties and comparable administrative areas internationally. Use `county` and the State counties operation. Read `county`, `county_name`, `county_name_local` and `counties` in affected geography results; City `capital_of` uses `county` for this administrative level. Actual local types such as `department` and `district` retain their meaning.
353
+
354
+ This is a breaking field-read upgrade from earlier contracts. Canonical tools are `county` and `state_counties`. Deprecated `district` and `state_districts` tools preserve their historical result keys and omit the added County `iso_code` through a tool-only adapter; other geography tools use the canonical County fields. Hosted activation requires a separate compatibility review. Update property reads before upgrading. Older installed packages keep their existing API contract, and this client does not change an account's saved default. The shared hosted service and existing npm tags are unchanged by this opt-in package.
@@ -46,7 +46,7 @@ import * as z from "zod";
46
46
  // src/agent-catalog.json
47
47
  var agent_catalog_default = {
48
48
  schema_version: "1.0.0",
49
- api_version: "2.1.0",
49
+ api_version: "2.2.0",
50
50
  operations: {
51
51
  email: {
52
52
  operation: "email",
@@ -121,7 +121,7 @@ var agent_catalog_default = {
121
121
  guidance: "Basic syntax and routing checks do not establish mailbox deliverability. Use email_verify explicitly for that metered operation."
122
122
  },
123
123
  docs: {
124
- help: "https://api.parseapi.com/version/2.1.0/email/help",
124
+ help: "https://api.parseapi.com/version/2.2.0/email/help",
125
125
  guide: "https://parseapi.com/docs/email"
126
126
  }
127
127
  },
@@ -206,7 +206,7 @@ var agent_catalog_default = {
206
206
  guidance: "available=null is a completed HTTP response with an unknown fact, not evidence the domain is free. Do not retry automatically from null; respect rate and quota errors."
207
207
  },
208
208
  docs: {
209
- help: "https://api.parseapi.com/version/2.1.0/domain/help",
209
+ help: "https://api.parseapi.com/version/2.2.0/domain/help",
210
210
  guide: "https://parseapi.com/docs/domain"
211
211
  }
212
212
  },
@@ -292,7 +292,7 @@ var agent_catalog_default = {
292
292
  guidance: "An empty records array and a DNS-name 404 are negative answers, not transient failures. Reuse records only within their remaining TTL; respect rate and quota errors."
293
293
  },
294
294
  docs: {
295
- help: "https://api.parseapi.com/version/2.1.0/dns/help",
295
+ help: "https://api.parseapi.com/version/2.2.0/dns/help",
296
296
  guide: "https://parseapi.com/docs/dns"
297
297
  }
298
298
  },
@@ -367,7 +367,7 @@ var agent_catalog_default = {
367
367
  guidance: "Do not retry solely because mx is empty. Use email for mail-route validation or dns for explicit A/AAAA records; respect rate and quota errors."
368
368
  },
369
369
  docs: {
370
- help: "https://api.parseapi.com/version/2.1.0/mx/help",
370
+ help: "https://api.parseapi.com/version/2.2.0/mx/help",
371
371
  guide: "https://parseapi.com/docs/mx"
372
372
  }
373
373
  },
@@ -470,7 +470,7 @@ var agent_catalog_default = {
470
470
  guidance: "Do not retry to fill null reference fields or a locked deep object. Preserve unknowns and distinguish reported zero from null; respect rate and quota errors."
471
471
  },
472
472
  docs: {
473
- help: "https://api.parseapi.com/version/2.1.0/country/help",
473
+ help: "https://api.parseapi.com/version/2.2.0/country/help",
474
474
  guide: "https://parseapi.com/docs/country"
475
475
  }
476
476
  },
@@ -595,7 +595,7 @@ var agent_catalog_default = {
595
595
  guidance: "Do not retry unresolved/ambiguous locations or rejected wall times automatically. Correct the input or choose a resolution. Retried calls with omitted at evaluate a later now; pin an explicit instant when repeatability matters."
596
596
  },
597
597
  docs: {
598
- help: "https://api.parseapi.com/version/2.1.0/time/help",
598
+ help: "https://api.parseapi.com/version/2.2.0/time/help",
599
599
  guide: "https://parseapi.com/docs/time"
600
600
  }
601
601
  },
@@ -707,7 +707,7 @@ var agent_catalog_default = {
707
707
  guidance: "Do not retry a successful unknown prefix or null fields to manufacture a match. Honor Retry-After; waits over five seconds return the API error without automatic retry."
708
708
  },
709
709
  docs: {
710
- help: "https://api.parseapi.com/version/2.1.0/card/help",
710
+ help: "https://api.parseapi.com/version/2.2.0/card/help",
711
711
  guide: "https://parseapi.com/docs/card",
712
712
  attribution: "https://parseapi.com/legal/attribution#bin"
713
713
  }
@@ -783,7 +783,7 @@ var agent_catalog_default = {
783
783
  guidance: "Do not retry an empty match list automatically. Correct or broaden the identifier query."
784
784
  },
785
785
  docs: {
786
- help: "https://api.parseapi.com/version/2.1.0/time/help",
786
+ help: "https://api.parseapi.com/version/2.2.0/time/help",
787
787
  guide: "https://parseapi.com/docs/time"
788
788
  }
789
789
  },
@@ -855,7 +855,7 @@ var agent_catalog_default = {
855
855
  guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
856
856
  },
857
857
  docs: {
858
- help: "https://api.parseapi.com/version/2.1.0/emoji/help",
858
+ help: "https://api.parseapi.com/version/2.2.0/emoji/help",
859
859
  guide: "https://parseapi.com/docs/emoji"
860
860
  }
861
861
  },
@@ -926,7 +926,7 @@ var agent_catalog_default = {
926
926
  guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
927
927
  },
928
928
  docs: {
929
- help: "https://api.parseapi.com/version/2.1.0/emoji/help",
929
+ help: "https://api.parseapi.com/version/2.2.0/emoji/help",
930
930
  guide: "https://parseapi.com/docs/emoji"
931
931
  }
932
932
  },
@@ -996,7 +996,7 @@ var agent_catalog_default = {
996
996
  guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
997
997
  },
998
998
  docs: {
999
- help: "https://api.parseapi.com/version/2.1.0/emoji/help",
999
+ help: "https://api.parseapi.com/version/2.2.0/emoji/help",
1000
1000
  guide: "https://parseapi.com/docs/emoji"
1001
1001
  }
1002
1002
  },
@@ -1051,7 +1051,7 @@ var agent_catalog_default = {
1051
1051
  guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1052
1052
  },
1053
1053
  docs: {
1054
- help: "https://api.parseapi.com/version/2.1.0/emoji/help",
1054
+ help: "https://api.parseapi.com/version/2.2.0/emoji/help",
1055
1055
  guide: "https://parseapi.com/docs/emoji"
1056
1056
  }
1057
1057
  },
@@ -1120,7 +1120,7 @@ var agent_catalog_default = {
1120
1120
  guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1121
1121
  },
1122
1122
  docs: {
1123
- help: "https://api.parseapi.com/version/2.1.0/emoji/help",
1123
+ help: "https://api.parseapi.com/version/2.2.0/emoji/help",
1124
1124
  guide: "https://parseapi.com/docs/emoji"
1125
1125
  }
1126
1126
  },
@@ -1190,7 +1190,7 @@ var agent_catalog_default = {
1190
1190
  guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1191
1191
  },
1192
1192
  docs: {
1193
- help: "https://api.parseapi.com/version/2.1.0/emoji/help",
1193
+ help: "https://api.parseapi.com/version/2.2.0/emoji/help",
1194
1194
  guide: "https://parseapi.com/docs/emoji"
1195
1195
  }
1196
1196
  },
@@ -1252,7 +1252,7 @@ var agent_catalog_default = {
1252
1252
  guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1253
1253
  },
1254
1254
  docs: {
1255
- help: "https://api.parseapi.com/version/2.1.0/emoji/help",
1255
+ help: "https://api.parseapi.com/version/2.2.0/emoji/help",
1256
1256
  guide: "https://parseapi.com/docs/emoji"
1257
1257
  }
1258
1258
  },
@@ -1288,7 +1288,7 @@ var agent_catalog_default = {
1288
1288
  },
1289
1289
  access: {
1290
1290
  plans: "all",
1291
- credentials: "Existing permitted API or app key; API 2.1.0",
1291
+ credentials: "Existing permitted API or app key; API 2.2.0",
1292
1292
  deep: "Not accepted; complete collection metadata is core",
1293
1293
  effective_access: null,
1294
1294
  preflight_and_tasks: "Unsupported by the current single-value preflight/task execution contract; use a direct collection lookup."
@@ -1299,7 +1299,7 @@ var agent_catalog_default = {
1299
1299
  "Optional type and region; a region must be represented in every reached annual calendar"
1300
1300
  ],
1301
1301
  docs: {
1302
- help: "https://api.parseapi.com/version/2.1.0/holiday/help",
1302
+ help: "https://api.parseapi.com/version/2.2.0/holiday/help",
1303
1303
  reference: "https://parseapi.com/docs/holiday"
1304
1304
  },
1305
1305
  retry: {
@@ -1378,7 +1378,7 @@ var agent_catalog_default = {
1378
1378
  effective_access: null
1379
1379
  },
1380
1380
  docs: {
1381
- help: "https://api.parseapi.com/version/2.1.0/holiday/help",
1381
+ help: "https://api.parseapi.com/version/2.2.0/holiday/help",
1382
1382
  reference: "https://parseapi.com/docs/holiday"
1383
1383
  },
1384
1384
  retry: {
@@ -1418,7 +1418,7 @@ var agent_catalog_default = {
1418
1418
  },
1419
1419
  access: {
1420
1420
  plans: "all",
1421
- credentials: "Existing permitted API or app key; API 2.1.0",
1421
+ credentials: "Existing permitted API or app key; API 2.2.0",
1422
1422
  deep: "Not accepted; complete collection metadata is core",
1423
1423
  effective_access: null,
1424
1424
  preflight_and_tasks: "Unsupported by the current single-value preflight/task execution contract; use a direct collection lookup."
@@ -1429,7 +1429,7 @@ var agent_catalog_default = {
1429
1429
  "Optional type and region; a region must be represented in every reached annual calendar"
1430
1430
  ],
1431
1431
  docs: {
1432
- help: "https://api.parseapi.com/version/2.1.0/holiday/help",
1432
+ help: "https://api.parseapi.com/version/2.2.0/holiday/help",
1433
1433
  reference: "https://parseapi.com/docs/holiday"
1434
1434
  },
1435
1435
  retry: {
@@ -1533,7 +1533,7 @@ var agent_catalog_default = {
1533
1533
  guidance: "A successful response with unknown facts is a completed result, not a reason to retry. Respect explicit unavailable errors and retry guidance."
1534
1534
  },
1535
1535
  docs: {
1536
- help: "https://api.parseapi.com/version/2.1.0/postal/help",
1536
+ help: "https://api.parseapi.com/version/2.2.0/postal/help",
1537
1537
  guide: "https://parseapi.com/docs/postal"
1538
1538
  }
1539
1539
  },
@@ -1596,7 +1596,7 @@ var agent_catalog_default = {
1596
1596
  guidance: "A successful response with unknown facts is a completed result, not a reason to retry. Respect explicit unavailable errors and retry guidance."
1597
1597
  },
1598
1598
  docs: {
1599
- help: "https://api.parseapi.com/version/2.1.0/postal/help",
1599
+ help: "https://api.parseapi.com/version/2.2.0/postal/help",
1600
1600
  guide: "https://parseapi.com/docs/postal"
1601
1601
  }
1602
1602
  },
@@ -1658,7 +1658,7 @@ var agent_catalog_default = {
1658
1658
  guidance: "A successful response with unknown facts is a completed result, not a reason to retry. Respect explicit unavailable errors and retry guidance."
1659
1659
  },
1660
1660
  docs: {
1661
- help: "https://api.parseapi.com/version/2.1.0/postal/help",
1661
+ help: "https://api.parseapi.com/version/2.2.0/postal/help",
1662
1662
  guide: "https://parseapi.com/docs/postal"
1663
1663
  }
1664
1664
  },
@@ -1717,8 +1717,8 @@ var agent_catalog_default = {
1717
1717
  },
1718
1718
  errors: {
1719
1719
  "400": "Invalid controls or cursor from another query/catalog; restart pagination when the edition changes",
1720
- "409": "ambiguous_city under ambiguity=error; bounded safe candidates without Deep",
1721
1720
  "404": "City ID or name is not present in the serving catalog",
1721
+ "409": "ambiguous_city under ambiguity=error; bounded safe candidates without Deep",
1722
1722
  "503": "Required catalog or admitted spelling index unavailable"
1723
1723
  },
1724
1724
  billing: {
@@ -1768,7 +1768,7 @@ var agent_catalog_default = {
1768
1768
  ]
1769
1769
  },
1770
1770
  docs: {
1771
- help: "https://api.parseapi.com/version/2.1.0/city/help",
1771
+ help: "https://api.parseapi.com/version/2.2.0/city/help",
1772
1772
  guide: "https://parseapi.com/docs/city",
1773
1773
  selection: "https://parseapi.com/docs/city#choose-a-city",
1774
1774
  continuity: "https://parseapi.com/docs/city#stable-ids"
@@ -1875,7 +1875,7 @@ var agent_catalog_default = {
1875
1875
  guidance: "Do not infer a retry from null. Repeated completed checks consume additional verification units; a transport failure does not prove the previous attempt was unbilled. DNS failures can return 503 before mailbox verification."
1876
1876
  },
1877
1877
  docs: {
1878
- help: "https://api.parseapi.com/version/2.1.0/email/help",
1878
+ help: "https://api.parseapi.com/version/2.2.0/email/help",
1879
1879
  guide: "https://parseapi.com/docs/email"
1880
1880
  }
1881
1881
  }
@@ -1962,7 +1962,7 @@ function registerDiscovery(server, operations, mode, apiVersion) {
1962
1962
  if (mode !== "compact") return;
1963
1963
  server.registerTool("lookup", {
1964
1964
  title: "Run a ParseAPI lookup",
1965
- description: "Run one ParseAPI operation found with discover. Pass its exact name and arguments. Uses the same validation, API 2.0.0 contract, credentials and billing as the named lookup. Reads can consume pooled or paid units. Ordinary lookups can retry twice, metered checks default to no retries.",
1965
+ description: "Run one ParseAPI operation found with discover. Pass its exact name and arguments. Uses the same validation, API 2.2.0 contract, credentials and billing as the named lookup. Reads can consume pooled or paid units. Ordinary lookups can retry twice, metered checks default to no retries.",
1966
1966
  inputSchema: z.object({ operation: z.string().min(1).max(64), arguments: object2 }),
1967
1967
  annotations: { readOnlyHint: true, idempotentHint: false }
1968
1968
  }, async (args, context) => {
@@ -2101,7 +2101,7 @@ function registerBulk(server, key, transport) {
2101
2101
  // package.json
2102
2102
  var package_default = {
2103
2103
  name: "parseapi-mcp",
2104
- version: "1.13.0",
2104
+ version: "1.14.0",
2105
2105
  mcpName: "com.parseapi/mcp",
2106
2106
  description: "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
2107
2107
  keywords: [
@@ -2151,7 +2151,7 @@ var package_default = {
2151
2151
  dependencies: {
2152
2152
  "@modelcontextprotocol/node": "^2.0.0",
2153
2153
  "@modelcontextprotocol/server": "^2.0.0",
2154
- "@parseapi/sdk": "^1.14.0",
2154
+ "@parseapi/sdk": "1.15.0",
2155
2155
  zod: "^4.0.0"
2156
2156
  },
2157
2157
  devDependencies: {
@@ -2166,9 +2166,9 @@ var package_default = {
2166
2166
 
2167
2167
  // src/registry.ts
2168
2168
  var VERSION = package_default.version;
2169
- var API_VERSION = "2.1.0";
2169
+ var API_VERSION = "2.2.0";
2170
2170
  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";
2171
- var deep = z5.boolean().optional().describe("Legacy profile request flag. API 2.1 paid plans include profile detail automatically. Existing access rules and explicit metered operations remain unchanged.");
2171
+ var deep = z5.boolean().optional().describe("Legacy profile request flag. API 2.2 paid plans include profile detail automatically. Existing access rules and explicit metered operations remain unchanged.");
2172
2172
  var lat = z5.number().min(-90).max(90).describe("Latitude in decimal degrees");
2173
2173
  var lon = z5.number().min(-180).max(180).describe("Longitude in decimal degrees");
2174
2174
  var iso2 = (what) => z5.string().describe(`ISO 3166-1 alpha-2 ${what}, e.g. US`);
@@ -2227,7 +2227,7 @@ function cityCollectionArguments(args) {
2227
2227
  romanized: args.romanized || void 0
2228
2228
  };
2229
2229
  }
2230
- var languageTools = /* @__PURE__ */ new Set(["ip", "ip_self", "asn", "company", "continent", "continent_countries", "country", "country_states", "state", "state_districts", "district", "city", "city_id", "city_search", "city_nearest", "city_nearby", "postal", "postal_nearby", "postal_distance", "currency", "language", "date", "time", "timezone", "emoji", "emoji_search", "emoji_browse", "emoji_parse", "emoji_catalog", "point", "city_list", "city_nearby_coordinates", "city_children", "city_ancestors", "city_siblings"]);
2230
+ var languageTools = /* @__PURE__ */ new Set(["ip", "ip_self", "asn", "company", "continent", "continent_countries", "country", "country_states", "state", "state_counties", "county", "state_districts", "district", "city", "city_id", "city_search", "city_nearest", "city_nearby", "postal", "postal_nearby", "postal_distance", "currency", "language", "date", "time", "timezone", "emoji", "emoji_search", "emoji_browse", "emoji_parse", "emoji_catalog", "point", "city_list", "city_nearby_coordinates", "city_children", "city_ancestors", "city_siblings"]);
2231
2231
  var displayLanguage = z5.string().min(2).max(64).optional().describe("Optional display language, such as fr or zh-Hant. IDs, numeric values and input parsing stay unchanged.");
2232
2232
  var emojiFilters = {
2233
2233
  limit: z5.number().int().min(1).max(50).optional().describe("Maximum results per page."),
@@ -2239,6 +2239,12 @@ var emojiFilters = {
2239
2239
  offset: z5.number().int().min(0).max(1e5).optional().describe("Page offset. Reuse next_offset with the same filters."),
2240
2240
  deep: deep.describe("Include optional detail when supported; access follows this operation's plan or included-unit rules.")
2241
2241
  };
2242
+ function legacyDistrictResult(value) {
2243
+ if (Array.isArray(value)) return value.map(legacyDistrictResult);
2244
+ if (!value || typeof value !== "object") return value;
2245
+ const names = { county: "district", county_name: "district_name", county_name_local: "district_name_local", counties: "districts" };
2246
+ return Object.fromEntries(Object.entries(value).filter(([key]) => !(key === "iso_code" && Object.hasOwn(value, "county"))).map(([key, item]) => [Object.hasOwn(names, key) ? names[key] : key, legacyDistrictResult(item)]));
2247
+ }
2242
2248
  function buildServer(key, transport, options = {}) {
2243
2249
  const mode = options.mode ?? "full";
2244
2250
  if (mode !== "full" && mode !== "compact") throw new Error("Unknown MCP catalog mode");
@@ -2336,7 +2342,7 @@ function buildServer(key, transport, options = {}) {
2336
2342
  );
2337
2343
  tool(
2338
2344
  "state",
2339
- "Look up a state or province by code or name, with its full iso_subdivision identifier. Paid plans include its demographic and tax profile automatically. Pass country to resolve a colliding code.",
2345
+ "Look up a state or province by code or name, with its full iso_code identifier. Paid plans include its demographic and tax profile automatically. Pass country to resolve a colliding code.",
2340
2346
  {
2341
2347
  code: z5.string().describe("State code or name, e.g. colorado, NC"),
2342
2348
  country: countryOpt,
@@ -2344,27 +2350,35 @@ function buildServer(key, transport, options = {}) {
2344
2350
  },
2345
2351
  (c, a, request) => c.state(a.code, { ...request, deep: a.deep, country: a.country })
2346
2352
  );
2347
- tool(
2348
- "state_districts",
2349
- "List the districts, counties or departments of a state. Paid plans include population to each result automatically.",
2350
- {
2351
- code: z5.string().describe("State code or name, e.g. NC, colorado"),
2352
- country: countryOpt,
2353
- deep: deep.describe("Include population in each district on a paid plan.")
2354
- },
2355
- (c, a, request) => c.state.districts(a.code, { ...request, deep: a.deep, country: a.country })
2356
- );
2357
- tool(
2358
- "district",
2359
- "Look up a district, county or department by code or name. Paid plans include area, population and seat automatically. Pass state to resolve a colliding name. Paid deep property_tax contains annual_median, currency and period: median annual tax payable on owner-occupied homes in the area, adjusted to the final year of that period. It is not a rate or property bill. Unsupported, missing and censored estimates are null.",
2360
- {
2361
- code: z5.string().describe("District code or name, e.g. 37081, guilford county"),
2362
- country: countryOpt,
2363
- state: z5.string().optional().describe("ADM1 code or name to disambiguate, e.g. NC or louisiana"),
2364
- deep: deep.describe("Compatibility flag; paid plans include this profile detail automatically.")
2365
- },
2366
- (c, a, request) => c.district(a.code, { ...request, deep: a.deep, country: a.country, state: a.state })
2367
- );
2353
+ for (const deprecated of [false, true]) {
2354
+ tool(
2355
+ deprecated ? "state_districts" : "state_counties",
2356
+ deprecated ? "Deprecated alias for state_counties. Retains historical districts/district result keys for existing tool callers. Paid plans include population automatically." : "List the counties and comparable administrative areas of a state, including nullable ISO 3166-2 iso_code on each item. Paid plans include population in each result automatically.",
2357
+ {
2358
+ code: z5.string().describe("State code or name, e.g. NC, colorado"),
2359
+ country: countryOpt,
2360
+ deep: deep.describe("Include population in each county on a paid plan.")
2361
+ },
2362
+ async (c, a, request) => {
2363
+ const result = await c.state.counties(a.code, { ...request, deep: a.deep, country: a.country });
2364
+ return deprecated ? legacyDistrictResult(result) : result;
2365
+ }
2366
+ );
2367
+ tool(
2368
+ deprecated ? "district" : "county",
2369
+ deprecated ? "Deprecated alias for county. Retains the historical district result key for existing tool callers." : "Look up a county or comparable administrative area by code or name, with nullable ISO 3166-2 iso_code. Paid plans include area, population and seat automatically. Pass state to resolve a colliding name. Property_tax contains annual_median, currency and period: median annual tax payable on owner-occupied homes in the area, adjusted to the final year of that period. It is not a rate or property bill. Unsupported, missing and censored estimates are null.",
2370
+ {
2371
+ code: z5.string().describe("County code or name, e.g. 37081, guilford county"),
2372
+ country: countryOpt,
2373
+ state: z5.string().optional().describe("ADM1 code or name to disambiguate, e.g. NC or louisiana"),
2374
+ deep: deep.describe("Compatibility flag; paid plans include this profile detail automatically.")
2375
+ },
2376
+ async (c, a, request) => {
2377
+ const result = await c.county(a.code, { ...request, deep: a.deep, country: a.country, state: a.state });
2378
+ return deprecated ? legacyDistrictResult(result) : result;
2379
+ }
2380
+ );
2381
+ }
2368
2382
  tool(
2369
2383
  "city",
2370
2384
  "Resolve a city name to coordinates, timezone and administrative context. Paid plans include demographic and geographic detail automatically. Pass country or state for name ties.",
package/dist/http.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-OY4MSQLL.js";
5
+ } from "./chunk-W2HQKIWP.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-OY4MSQLL.js";
5
+ } from "./chunk-W2HQKIWP.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-OY4MSQLL.js";
5
+ } from "./chunk-W2HQKIWP.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.13.0",
3
+ "version": "1.14.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/node": "^2.0.0",
52
52
  "@modelcontextprotocol/server": "^2.0.0",
53
- "@parseapi/sdk": "^1.14.0",
53
+ "@parseapi/sdk": "1.15.0",
54
54
  "zod": "^4.0.0"
55
55
  },
56
56
  "devDependencies": {