parseapi-mcp 1.10.0 → 1.10.2

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
@@ -57,7 +57,7 @@ MCP packages older than 1.0.0 keep their existing behavior and use the team's de
57
57
 
58
58
  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.
59
59
 
60
- Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `company_id`, `company_search`, `company_coverage`, `email`, `vat`, `bank`, `bank_us_ach`, `bank_requirements`, `card`, `provider`, `vehicle`, `industry`, `industry_search`, `tariff`, `dns`, `asn`, `mac`, `currency_rate`, and the rest. Text searches take `query`. Company directory search supports one name/domain/ticker/identifier selector or country/exact-SIC discovery filters.
60
+ Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `company_id`, `company_search`, `company_coverage`, `email`, `bank`, `bank_us_ach`, `bank_requirements`, `card`, `industry`, `industry_search`, `dns`, `asn`, `mac`, `currency_rate`, and the rest. Text searches take `query`. Company directory search supports one name/domain/ticker/identifier selector or country/exact-SIC discovery filters.
61
61
 
62
62
  The existing `naics` and `naics_search` tools remain available as compatibility names for Industry.
63
63
 
@@ -75,8 +75,6 @@ Example tool arguments:
75
75
  | `asn` | `{"asn":"AS13335"}` |
76
76
  | `mac` | `{"mac":"00:1B:63:84:45:E6"}` |
77
77
  | `card` | `{"bin":"424242"}` |
78
- | `provider` | `{"npi":"1881018208"}` (provider directory record) |
79
- | `provider` | `{"npi":"1881018208","deep":true}` (stored Medicare and deactivation detail on paid plans) |
80
78
  | `country_states` | `{"code":"US"}` |
81
79
  | `address_search` | `{"query":"1600 Pennsylvania","country":"US","city":"Washington","state":"DC"}` |
82
80
  | `company` | `{"number":"552100554","country":"FR"}` |
@@ -123,12 +121,6 @@ For discovery without an identity selector, supply `country` or both `industry`
123
121
 
124
122
  Paid Deep also returns `taxonomies` in published order, with taxonomy code, specialty label, primary flag and provider-reported license number/state, plus `enumerated_at`, `updated_at` and `reactivated_at` record dates. Reported licenses are not verified licenses. Null lists mean unavailable; empty lists mean the edition contains no entries. Provider record dates describe the provider record, not live verification.
125
123
 
126
- Pass the original NPI as a string. `valid` checks its format and checksum; `registered` means a match in the stored NPPES snapshot. `active` reflects recorded NPI deactivation, not licensure. `excluded` is an NPI-only OIG LEIE match; `false` is not a complete exclusion clearance. These directory facts do not verify credentials, current practice contact or payment eligibility.
127
-
128
- Invalid input returns `valid: false` with unknown provider fields. A checksum-valid number missing from the snapshot returns `registered: false`; unavailable storage remains an API error. Preserve `null` as unknown.
129
-
130
- The default pooled lookup includes provider identity, specialty and practice contact where held. Paid `deep` adds `deactivated_at`, `medicare`, `opt_out` and `enrollments` from stored source files, with no separate check meter or live verification. `enrollments: null` means unavailable; `[]` means no enrollment rows are returned. The API omits unrequested `deep` and returns `{}` when requested on Free.
131
-
132
124
  Ordinary lookups retry up to twice after a transient failure. A valid `Retry-After` is honored when the wait is at most five seconds; longer waits return the API error immediately without retrying early. When the response supplies this header, the error includes `retry_after` with its original seconds or HTTP-date value. Metered lookups and address deep checks default to no retries. Cancelling a tool call cancels the pending SDK request.
133
125
 
134
126
  Errors come back as JSON with a machine-readable `code`. Branch on `code`, never on message text. A miss is `not_found`. No key is `invalid_api_key`.
@@ -250,7 +242,6 @@ Bank tools send original IBAN, routing and account strings in POST JSON bodies,
250
242
 
251
243
  When US ACH returns a bank name, MCP includes a separate [routing reference attribution](https://parseapi.com/legal/attribution#routing-numbers) notice alongside the unchanged JSON result.
252
244
 
253
- Vehicle lookups use `vin` as the input and response field. The `vin` tool remains available for compatibility.
254
245
 
255
246
  ## Emoji catalog additions
256
247
 
@@ -298,9 +289,6 @@ Reviewed children, ancestors and siblings use canonical lists with partial relat
298
289
  Strict `ambiguity=error` can return HTTP 409 `ambiguous_city` with up to two safe candidate identities. The existing error constructor and unrelated error metadata are preserved; candidates are retained only for that status/code and never contain Deep. GeoJSON is available through HTTP; these typed City list methods do not return GeoJSON.
299
290
 
300
291
 
301
-
302
-
303
-
304
292
  Coverage by country and available fields is described at https://parseapi.com/city#coverage.
305
293
 
306
294
  `romanized=true` requests reviewed official name forms as `name_romanized` and `romanization_language` (camelCase in Swift/Kotlin). Current reviewed forms cover 20 Japanese whole-city aliases in ja-Latn. Missing or conflicting forms stay null; ASCII folding is not substituted for an official form.
@@ -1657,7 +1657,7 @@ function registerTasks(server, client, transport) {
1657
1657
  // package.json
1658
1658
  var package_default = {
1659
1659
  name: "parseapi-mcp",
1660
- version: "1.10.0",
1660
+ version: "1.10.2",
1661
1661
  mcpName: "com.parseapi/mcp",
1662
1662
  description: "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
1663
1663
  keywords: [
@@ -1707,7 +1707,7 @@ var package_default = {
1707
1707
  dependencies: {
1708
1708
  "@modelcontextprotocol/node": "^2.0.0",
1709
1709
  "@modelcontextprotocol/server": "^2.0.0",
1710
- "@parseapi/sdk": "^1.11.0",
1710
+ "@parseapi/sdk": "^1.11.2",
1711
1711
  zod: "^4.0.0"
1712
1712
  },
1713
1713
  devDependencies: {
@@ -1729,8 +1729,6 @@ var deep = z4.boolean().optional().describe("Include the nested deep object when
1729
1729
  var lat = z4.number().min(-90).max(90).describe("Latitude in decimal degrees");
1730
1730
  var lon = z4.number().min(-180).max(180).describe("Longitude in decimal degrees");
1731
1731
  var iso2 = (what) => z4.string().describe(`ISO 3166-1 alpha-2 ${what}, e.g. US`);
1732
- var tariffEdition = z4.string().max(64).regex(/^(?:[a-f0-9]{64}|ted_[1-9][0-9]{0,19})(?![\s\S])/).refine((value) => value.length === 64 && /^[a-f0-9]{64}$/.test(value) || /^ted_[1-9][0-9]{0,19}(?![\s\S])/.test(value) && (value.length < 24 || value.slice(4) <= "18446744073709551615"), "Use an exact edition ID such as ted_3.").optional().describe("Exact edition returned by Tariff, such as ted_3. Without date, returns undated schedule context.");
1733
- var tariffDate = z4.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("YYYY-MM-DD with verified source coverage. Combine with edition only when it covers this date.");
1734
1732
  var countryOpt = z4.string().optional().describe("ISO2, ISO3, or a country name. Optional when the lookup is unique.");
1735
1733
  var titleWords = {
1736
1734
  ip: "IP",
@@ -1742,7 +1740,6 @@ var titleWords = {
1742
1740
  iban: "IBAN",
1743
1741
  npi: "NPI",
1744
1742
  naics: "NAICS",
1745
- vin: "VIN",
1746
1743
  bin: "BIN",
1747
1744
  us: "US",
1748
1745
  ach: "ACH",
@@ -1796,7 +1793,7 @@ function cityCollectionArguments(args) {
1796
1793
  romanized: args.romanized || void 0
1797
1794
  };
1798
1795
  }
1799
- var languageTools = /* @__PURE__ */ new Set(["ip", "ip_self", "asn", "company", "npi", "provider", "continent", "continent_countries", "bloc_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", "measure_units", "emoji", "emoji_search", "emoji_browse", "emoji_parse", "emoji_catalog", "point", "city_list", "city_nearby_coordinates", "city_children", "city_ancestors", "city_siblings"]);
1796
+ 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", "measure_units", "emoji", "emoji_search", "emoji_browse", "emoji_parse", "emoji_catalog", "point", "city_list", "city_nearby_coordinates", "city_children", "city_ancestors", "city_siblings"]);
1800
1797
  var displayLanguage = z4.string().min(2).max(64).optional().describe("Optional display language, such as fr or zh-Hant. IDs, numeric values and input parsing stay unchanged.");
1801
1798
  var emojiFilters = {
1802
1799
  limit: z4.number().int().min(1).max(50).optional().describe("Maximum results per page."),
@@ -1915,22 +1912,6 @@ function buildServer(key, transport, options = {}) {
1915
1912
  { code: z4.string().describe("Continent code: AF, AN, AS, EU, NA, OC, SA") },
1916
1913
  (c, a, request) => c.continent.countries(a.code, request)
1917
1914
  );
1918
- tool(
1919
- "bloc",
1920
- "Look up a country group by code: EU, EEA, Schengen, Eurozone, SEPA, NATO, and more. Returns the official name and the current member count.",
1921
- {
1922
- code: z4.string().describe("Bloc code: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR")
1923
- },
1924
- (c, a, request) => c.bloc(a.code, request)
1925
- );
1926
- tool(
1927
- "bloc_countries",
1928
- "List the current members of a country group, each with name, flag, and calling code.",
1929
- {
1930
- code: z4.string().describe("Bloc code: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR")
1931
- },
1932
- (c, a, request) => c.bloc.countries(a.code, request)
1933
- );
1934
1915
  tool(
1935
1916
  "country",
1936
1917
  "Country names, language codes, currency, calling code and timezones. Deep adds the country reference profile on paid plans, including population, land/water area in km2, coastline in km, mean and extreme elevations in metres, tax and locale conventions. Unknown geography values stay null.",
@@ -2251,17 +2232,6 @@ function buildServer(key, transport, options = {}) {
2251
2232
  { email: z4.string().describe("Email address to validate"), deep },
2252
2233
  (c, a, request) => c.email(a.email, { ...request, deep: a.deep })
2253
2234
  );
2254
- tool(
2255
- "vat",
2256
- "Validate a VAT number: format and checksum on every call. Deep asks the live EU registry for registered, legal name, and address. Pass from with your own VAT for a consultation identifier.",
2257
- {
2258
- number: z4.string().describe("VAT number, with or without the country prefix"),
2259
- country: iso2("country code when the number has no prefix").optional(),
2260
- from: z4.string().optional().describe("Your own VAT number. Returns a consultation identifier for your audit file"),
2261
- deep
2262
- },
2263
- (c, a, request) => c.vat(a.number, { ...request, country: a.country, from: a.from, deep: a.deep })
2264
- );
2265
2235
  tool(
2266
2236
  "iban",
2267
2237
  "Parse an IBAN and check its format, ISO checksum, and published national BBAN checks, with known bank identifiers. Deep adds check digits, branch and account decomposition on every plan. Does not verify an account exists.",
@@ -2281,15 +2251,6 @@ function buildServer(key, transport, options = {}) {
2281
2251
  },
2282
2252
  (c, a, request) => c.bin(a.bin, { ...request, deep: a.deep })
2283
2253
  );
2284
- tool(
2285
- "npi",
2286
- "Validate an NPI and identify the registered provider, active/exclusion status, specialty and practice contact. Paid deep adds deactivation date and Medicare enrollment evidence.",
2287
- {
2288
- npi: z4.string().describe("10-digit NPI number"),
2289
- deep
2290
- },
2291
- (c, a, request) => c.npi(a.npi, { ...request, deep: a.deep })
2292
- );
2293
2254
  tool(
2294
2255
  "bank",
2295
2256
  "Send an IBAN in a POST JSON body, keeping it out of the request URL. Parse with core checks and issues for input, country, length, structure, ISO checksum and supported national checks. not_supported is not a failed national check. Known bank names and BICs are independent nullable directory facts. Deep adds check digits, branch, the BBAN account remainder and source edition/match grain when a directory lookup ran, on every plan. Does not verify account existence, ownership or payment reachability.",
@@ -2327,15 +2288,6 @@ function buildServer(key, transport, options = {}) {
2327
2288
  },
2328
2289
  (c, a, request) => c.card(a.bin, { ...request, deep: a.deep })
2329
2290
  );
2330
- tool(
2331
- "provider",
2332
- "Look up an NPI in stored provider-directory sources. valid is format/checksum only; registered means found in the NPPES snapshot; active is recorded NPI activation, not licensure. excluded is an NPI-only OIG LEIE match, and false is not complete exclusion clearance. Returns identity, specialty and practice contact where held. Paid deep adds all published taxonomies and reported license details, provider enumeration/update/reactivation dates, deactivation date, Medicare enrollment, opt-out and enrollment rows. Reported licenses are not verified licenses; provider update dates are not source freshness. Null means unknown. No live credential or payment-eligibility verification. Pooled request; no separate check meter.",
2333
- {
2334
- npi: z4.string().describe("Original NPI input as a string, normally 10 digits. Preserve the input; invalid values return valid=false with unknown provider fields. Do not URI-decode it."),
2335
- deep: deep.describe("Include taxonomies, enumerated_at, updated_at, reactivated_at, deactivated_at, medicare, opt_out and enrollments from stored sources on paid plans. Omitted by default; Free returns {}. Null lists are unavailable; [] means the source recorded no rows.")
2336
- },
2337
- (c, a, request) => c.provider(a.npi, { ...request, deep: a.deep })
2338
- );
2339
2291
  tool(
2340
2292
  "phone",
2341
2293
  "Parse and validate a phone number with national and international display formats. Deep adds numbering-plan state and timezone on every plan. These do not locate a handset.",
@@ -2420,36 +2372,6 @@ function buildServer(key, transport, options = {}) {
2420
2372
  { ua: z4.string().describe("The User-Agent string to parse"), deep },
2421
2373
  (c, a, request) => c.useragent(a.ua, { ...request, deep: a.deep })
2422
2374
  );
2423
- tool(
2424
- "vehicle",
2425
- "Identify a vehicle by VIN: year, make, model, trim, body and vehicle type. Paid deep adds specifications, manufacturing detail and model-level recall campaigns. These do not establish whether this VIN needs a repair.",
2426
- { vin: z4.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
2427
- (c, a, request) => c.vehicle(a.vin, { ...request, deep: a.deep })
2428
- );
2429
- tool(
2430
- "vin",
2431
- "Compatibility entry for vehicle. Decode a VIN to year, make, model, trim, body and vehicle type. Paid deep adds specifications, manufacturing detail and model-level recall campaigns.",
2432
- { vin: z4.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
2433
- (c, a, request) => c.vin(a.vin, { ...request, deep: a.deep })
2434
- );
2435
- tool(
2436
- "tariff",
2437
- "Look up a US tariff code, description, lineage, published base general rate, exact edition and answering date. Paid deep adds schedule columns, units and matched Chapter 99 measures. Origin is the country where goods originate, not the shipping country. Optional edition pins immutable source bytes. Optional date requires verified source coverage; edition without date returns date null and no effective rate. Default requests use today. deep.reason explains a null effective_rate, including incomplete_coverage; null never means zero. Matched measures are inspectable candidates, not complete duty or landed cost.",
2438
- {
2439
- code: z4.string().describe("US HTS code: 4, 6, 8 or 10 ASCII digits, dots and whitespace optional, e.g. 8471.30.01.00"),
2440
- origin: iso2("country where the goods originate, not the shipping country; only read with deep").optional(),
2441
- edition: tariffEdition,
2442
- date: tariffDate,
2443
- deep
2444
- },
2445
- (c, a, request) => c.tariff(a.code, { ...request, deep: a.deep, origin: a.origin, edition: a.edition, date: a.date })
2446
- );
2447
- tool(
2448
- "tariff_search",
2449
- "Search US tariff schedule descriptions by product words. Returns up to 20 candidate lines with hts, description, general rate and parent lineage, plus the exact edition and answering date. Optional edition pins immutable source bytes. Optional date requires verified source coverage; combine only when that edition covers the date. Edition without date returns date null. Description search is not product classification.",
2450
- { query: z4.string().describe("Product words, e.g. sunglasses, laptop, coffee"), edition: tariffEdition, date: tariffDate },
2451
- (c, a, request) => c.tariff.search(a.query, { ...request, edition: a.edition, date: a.date })
2452
- );
2453
2375
  tool(
2454
2376
  "industry",
2455
2377
  "Look up a US NAICS 2022 code, title and parent hierarchy. Deep adds definition, children and exclusions on paid plans.",
package/dist/http.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-MO7I4G22.js";
5
+ } from "./chunk-3DOZOXMP.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-MO7I4G22.js";
5
+ } from "./chunk-3DOZOXMP.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-MO7I4G22.js";
5
+ } from "./chunk-3DOZOXMP.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.10.0",
3
+ "version": "1.10.2",
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.11.0",
53
+ "@parseapi/sdk": "^1.11.2",
54
54
  "zod": "^4.0.0"
55
55
  },
56
56
  "devDependencies": {