parseapi-mcp 1.6.0 → 1.7.1

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
@@ -55,11 +55,13 @@ MCP packages older than 1.0.0 keep their existing behavior and use the team's de
55
55
 
56
56
  ## Tools
57
57
 
58
- Full mode provides 59 local lookup tools and 58 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.
58
+ Full mode provides 64 local lookup tools and 63 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`, `email`, `vat`, `iban`, `bin`, `npi`, `vin`, `naics`, `naics_search`, `tariff`, `dns`, `asn`, `mac`, `currency_rate`, and the rest. All search tools take `query`.
60
+ Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `email`, `vat`, `bank`, `bank_us_ach`, `bank_requirements`, `card`, `provider`, `vehicle`, `industry`, `industry_search`, `tariff`, `dns`, `asn`, `mac`, `currency_rate`, and the rest. All search tools take `query`.
61
61
 
62
- NAICS paid deep records include classification `deep.exclusions`, each with a description and linked codes. Generic exclusions can have no linked codes. Omitted or null exclusions in older responses remain unknown. Search results also include `match`: the matched `field` (`name`, `term` or `naics`) and `text`, plus `corrections` with `from` and `to` tokens for typo fallback. Corrections are empty for exact, plural and prefix matches. Direct code lookups omit `match`. Older responses may omit it.
62
+ The existing `naics` and `naics_search` tools remain available as compatibility names for Industry.
63
+
64
+ Industry paid deep records include classification `deep.exclusions`, each with a description and linked codes. Generic exclusions can have no linked codes. Omitted or null exclusions in older responses remain unknown. Search results also include `match`: the matched `field` (`name`, `term` or `naics`) and `text`, plus `corrections` with `from` and `to` tokens for typo fallback. Corrections are empty for exact, plural and prefix matches. Direct code lookups omit `match`. Older responses may omit it.
63
65
 
64
66
  Example tool arguments:
65
67
 
@@ -72,7 +74,9 @@ Example tool arguments:
72
74
  | `mx` | `{"domain":"example.com"}` |
73
75
  | `asn` | `{"asn":"AS13335"}` |
74
76
  | `mac` | `{"mac":"00:1B:63:84:45:E6"}` |
75
- | `bin` | `{"bin":"424242"}` |
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) |
76
80
  | `country_states` | `{"code":"US"}` |
77
81
  | `address_search` | `{"query":"1600 Pennsylvania","country":"US","city":"Washington","state":"DC"}` |
78
82
  | `company` | `{"number":"552100554","country":"FR"}` |
@@ -97,10 +101,20 @@ A path uses the same string formats with 2-512 vertices and a required integer `
97
101
 
98
102
  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).
99
103
 
104
+ 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).
105
+
100
106
  Address lookup returns standardized components and registration status for the US and France. Its `deep` object is currently empty. Company lookup returns validity, registration status and business details when available. `address_search` also accepts `postal` and `ip` to narrow or rank matches. French search needs `country: "FR"` and either `postal` or `city`.
101
107
 
102
108
 
103
- Ordinary lookups retry up to twice after a transient failure. Metered lookups and address deep checks default to no retries. Cancelling a tool call cancels the pending SDK request.
109
+ Card takes a processor-provided BIN/IIN prefix, with 6–11 ASCII digits. Leading zeros are preserved. ASCII spaces, tabs, line breaks and hyphens are accepted within a 64-character input limit. Full numbers and malformed prefixes are rejected before an API request; input is never truncated. The complete lookup is returned without a deep option.
110
+
111
+ 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.
112
+
113
+ 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.
114
+
115
+ 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.
116
+
117
+ 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.
104
118
 
105
119
  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`.
106
120
 
@@ -183,9 +197,11 @@ The [agent benchmark](eval/README.md) compares full and compact discovery on fix
183
197
  MIT licensed.
184
198
 
185
199
 
200
+ Bank returns core `checks` for input, country, length, structure, checksum and national rules, plus an `issues` list. States are `passed`, `failed`, `not_checked` or `not_supported`. Unsupported national checking is not a failure. `valid` covers the implemented format and checksum rules, not account existence, ownership or payment reachability. Directory names and BICs may be null independently. Older responses may omit `checks` and `issues`, and future states and issue codes remain strings. Pass the original input unchanged so the API can report invalid characters. Deep `account` remains the BBAN remainder.
201
+
186
202
  ## Optional detail
187
203
 
188
- Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date, Currency, Language, Emoji, Phone, IBAN 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.
204
+ Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date, Currency, Language, Emoji, Phone, Bank 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.
189
205
 
190
206
  Search detail belongs to each returned entity. Time conversion puts target display detail in `to.deep`; only the source returns `deep.next_dst`. Name core parsing needs no dictionary lookup. Paid Name deep also returns flat `short`, `directory`, and `initials`. Optional `name_locale` selects CLDR formatting rules, defaults to `en`, and leaves parsing and gender context unchanged. Unavailable formatting is null, and older responses may omit these fields. Country, State and Postal tax references are in their paid deep bags.
191
207
 
@@ -211,3 +227,10 @@ Time `targets` accepts 1-10 destination IDs instead of `to`. Results retain the
211
227
  `time` accepts one explicit IP, city, country, IATA airport, ICAO airport, port UN/LOCODE or address input. Country/state may narrow city or address. Address point lookup currently requires US country context. Port reference coverage is a reviewed subset of UN/LOCODE. Hosted calls never infer the user's IP from the server. Ambiguous or missing inputs return null clock fields and `location` candidates. Ask for the missing context or let the user choose rather than selecting a candidate silently.
212
228
 
213
229
  `time_zones` can filter by country, IANA area, exact offset, abbreviation, DST at an instant or DST occurrence during the UTC calendar year. It preserves explicit false filters. `details` adds rich rows and the common evaluation instant, while the default identifier list remains compact. Abbreviations return candidate zones. Source deep exposes standard and signed seasonal offsets plus actual DST-season transition boundaries. Negative seasonal adjustments and null boundaries retain their meaning.
230
+
231
+
232
+ Bank tools send original IBAN, routing and account strings in POST JSON bodies, keeping account input out of URLs. `bank` retains optional country and deep controls. Deep directory evidence identifies the immutable source edition and actual match grain when a directory lookup ran; it does not prove country completeness or reachability. `bank_us_ach` takes routing/account strings and checks the ABA routing checksum plus account-field syntax. It has no deep option and cannot verify an account checksum, existence, ownership or ACH eligibility. Preserve all account characters and leading zeros. `bank_requirements` takes a country and optional format (`iban` by default, or `us_ach`) and returns accepted fields, check scope and limitations. Requirements are metadata, not bank coverage. Avoid logging tool arguments or request bodies containing banking input.
233
+
234
+ 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.
235
+
236
+ Vehicle lookups use `vin` as the input and response field. The `vin` tool remains available for compatibility.
@@ -10,15 +10,21 @@ import { ParseAPIError } from "@parseapi/sdk";
10
10
  function ok(data) {
11
11
  return { content: [{ type: "text", text: JSON.stringify(data) }] };
12
12
  }
13
- function errorJson(code, message, docs, requestId) {
13
+ function errorJson(code, message, docs, requestId, retryAfter) {
14
14
  return {
15
15
  isError: true,
16
- content: [{ type: "text", text: JSON.stringify({ code, message, docs, request_id: requestId }) }]
16
+ content: [{ type: "text", text: JSON.stringify({
17
+ code,
18
+ message,
19
+ docs,
20
+ request_id: requestId,
21
+ ...retryAfter == null ? {} : { retry_after: retryAfter }
22
+ }) }]
17
23
  };
18
24
  }
19
25
  function toErrorResult(err) {
20
26
  if (err instanceof ParseAPIError) {
21
- return errorJson(err.code, err.message, err.docs, err.requestId);
27
+ return errorJson(err.code, err.message, err.docs, err.requestId, err.retryAfter);
22
28
  }
23
29
  const message = err instanceof Error ? err.message : String(err);
24
30
  return errorJson("network_error", message, null, null);
@@ -636,6 +642,119 @@ var agent_catalog_default = {
636
642
  guide: "https://parseapi.com/docs/time"
637
643
  }
638
644
  },
645
+ card: {
646
+ operation: "card",
647
+ endpoint: "GET /card/{bin}",
648
+ determines: [
649
+ "Network identity from reviewed prefix rules and a CDN SVG logo with a generic fallback",
650
+ "Optional Deep: longest recorded prefix, issuer, country, funding type and prepaid status where known"
651
+ ],
652
+ does_not_determine: [
653
+ "Current allocation, card validity, account existence, ownership, funds or payment acceptance",
654
+ "Complete six-digit or eight-digit coverage or a uniform observation date",
655
+ "Missing fields by inheriting from a shorter prefix"
656
+ ],
657
+ required_context: [
658
+ "bin: processor-provided leading digits as a string, with 2 to 11 ASCII digits",
659
+ "At most 64 input characters; remove only ASCII space, tab, CR, LF and hyphen separators; preserve leading zeros",
660
+ "Never send a full card number or collect one to truncate for this lookup"
661
+ ],
662
+ input_schema: {
663
+ type: "object",
664
+ required: [
665
+ "bin"
666
+ ],
667
+ properties: {
668
+ bin: {
669
+ type: "string",
670
+ maxLength: 64,
671
+ pattern: "^[ \\t\\r\\n-]*(?:[0-9][ \\t\\r\\n-]*){2,11}$"
672
+ },
673
+ deep: {
674
+ type: "boolean",
675
+ default: false,
676
+ description: "Optional recorded issuer details; included on every plan. Six or more digits enable matching."
677
+ }
678
+ }
679
+ },
680
+ freshness: {
681
+ mode: "pinned_reference",
682
+ coverage: "15 network rule families; not complete global coverage. Issuer directory coverage is partial.",
683
+ mixed_source_ages: true,
684
+ uniform_refresh_interval_seconds: null,
685
+ actual_age_seconds: null,
686
+ actual_age_status: "not_exposed; a lookup or download time is not an allocation or verification date"
687
+ },
688
+ uncertainty: {
689
+ bin: {
690
+ value: "Normalized input string; compare deep.prefix to this value when Deep is requested",
691
+ invalid: "HTTP 400; malformed input is not an unknown-prefix result"
692
+ },
693
+ brand: {
694
+ value: "Network key determined independently of issuer records; brand_name is its display name",
695
+ null: "Unknown or ambiguous among reviewed network rules; send more prefix digits when available, up to 11"
696
+ },
697
+ "deep.prefix": {
698
+ null: "HTTP 200: fewer than six digits or no recorded directory match; not a verdict about a card or account",
699
+ equals_bin: "An exact recorded-prefix match for the supplied digits; individual fields can still be null",
700
+ shorter_than_bin: "A broader reference match only; an eight-digit input matching six digits does not establish an exact eight-digit allocation"
701
+ },
702
+ "deep.metadata": {
703
+ null: "Unknown in the one matched record. A more specific record masks its parent, including null fields; never backfill from a shorter prefix"
704
+ },
705
+ "deep.prepaid": {
706
+ true: "Explicitly recorded as prepaid",
707
+ false: "Explicitly recorded as not prepaid",
708
+ null: "Unknown, not false"
709
+ },
710
+ "deep.type": {
711
+ null: "Unknown or mixed funding type"
712
+ },
713
+ logo: {
714
+ value: "CDN SVG URL; generic for unknown or ambiguous networks or unavailable reviewed artwork"
715
+ }
716
+ },
717
+ billing: {
718
+ pooled_requests_per_success: 1,
719
+ metered: null,
720
+ monetary_quote: null,
721
+ account_state: "unknown; pooled allowance and accepted account terms are not checked",
722
+ deep: "Included in the same pooled request on every plan"
723
+ },
724
+ access: {
725
+ api_key_required: true,
726
+ key_types: [
727
+ "secret",
728
+ "public",
729
+ "app"
730
+ ],
731
+ key_fences: {
732
+ public: "Allowed browser origin required",
733
+ app: "Allowed X-App-Id required"
734
+ },
735
+ effective_access: null,
736
+ effective_access_status: "not_checked; key fences, account access and quotas still apply"
737
+ },
738
+ retry: {
739
+ client: "javascript_sdk_and_mcp",
740
+ default_retries: 2,
741
+ retry_http_statuses: [
742
+ 429,
743
+ 500,
744
+ 502,
745
+ 503,
746
+ 504
747
+ ],
748
+ retry_network_errors: true,
749
+ successful_unknown_retried: false,
750
+ 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."
751
+ },
752
+ docs: {
753
+ help: "https://api.parseapi.com/version/2.0.0/card/help",
754
+ guide: "https://parseapi.com/docs/card",
755
+ attribution: "https://parseapi.com/legal/attribution#bin"
756
+ }
757
+ },
639
758
  time_zones: {
640
759
  operation: "time_zones",
641
760
  endpoint: "GET /time/zones",
@@ -752,6 +871,7 @@ function registerDiscovery(server, operations, mode, apiVersion) {
752
871
  const all = [...operations.values()].sort((a, b) => a.name.localeCompare(b.name));
753
872
  const reviewed = Object.keys(policies).filter((name) => operations.has(name)).sort();
754
873
  server.registerTool("discover", {
874
+ title: "Discover ParseAPI operations",
755
875
  description: "Find ParseAPI operations by keyword, or describe one by its exact name. Returns inputs and reviewed capability, freshness, uncertainty, billing and access policies. Metadata only, no API request or usage charge. Use preflight for effective credential permissions and account-specific cost estimates. Use operation to get full detail before lookup.",
756
876
  inputSchema: z.object({
757
877
  query: z.string().trim().min(1).max(256).optional().describe("Keywords such as mailbox, DNS, or population"),
@@ -797,6 +917,7 @@ function registerDiscovery(server, operations, mode, apiVersion) {
797
917
  });
798
918
  if (mode !== "compact") return;
799
919
  server.registerTool("lookup", {
920
+ title: "Run a ParseAPI lookup",
800
921
  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.",
801
922
  inputSchema: z.object({ operation: z.string().min(1).max(64), arguments: object2 }),
802
923
  annotations: { readOnlyHint: true, idempotentHint: false }
@@ -823,6 +944,7 @@ var task = z2.strictObject({
823
944
  });
824
945
  function registerPreflight(server, client, transport) {
825
946
  server.registerTool("preflight", {
947
+ title: "Estimate ParseAPI task usage",
826
948
  description: "Estimate whether your secret key permits a proposed Email, Domain, DNS, MX or Country task, its advisory capacity, and additional USD charges under accepted terms. Supply operation counts and optional Deep, without lookup inputs. Uses default SDK retries: up to three attempts per ordinary lookup and one per Email Deep lookup. Authenticated metadata request, no lookup units or paid checks. Reserves no units or money and does not enforce a budget. Check permitted, cost.status, capacity and budget before lookup.",
827
949
  inputSchema: task,
828
950
  annotations: { readOnlyHint: true, idempotentHint: true }
@@ -838,20 +960,41 @@ function registerPreflight(server, client, transport) {
838
960
  }
839
961
 
840
962
  // src/registry.ts
841
- var VERSION = "1.6.0";
963
+ var VERSION = "1.7.1";
842
964
  var API_VERSION = "2.0.0";
965
+ var US_ROUTING_NOTICE = "Routing reference attribution: https://parseapi.com/legal/attribution#routing-numbers";
843
966
  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";
844
967
  var deep = z3.boolean().optional().describe("Include the nested deep object when available. Pricing depends on the operation.");
845
968
  var lat = z3.number().min(-90).max(90).describe("Latitude in decimal degrees");
846
969
  var lon = z3.number().min(-180).max(180).describe("Longitude in decimal degrees");
847
970
  var iso2 = (what) => z3.string().describe(`ISO 3166-1 alpha-2 ${what}, e.g. US`);
848
971
  var countryOpt = z3.string().optional().describe("ISO2, ISO3, or a country name. Optional when the lookup is unique.");
972
+ var titleWords = {
973
+ ip: "IP",
974
+ asn: "ASN",
975
+ id: "ID",
976
+ dns: "DNS",
977
+ mx: "MX",
978
+ vat: "VAT",
979
+ iban: "IBAN",
980
+ npi: "NPI",
981
+ naics: "NAICS",
982
+ vin: "VIN",
983
+ bin: "BIN",
984
+ us: "US",
985
+ ach: "ACH",
986
+ url: "URL",
987
+ hlr: "HLR",
988
+ mac: "MAC",
989
+ useragent: "User Agent"
990
+ };
849
991
  var languageTools = /* @__PURE__ */ new Set([
850
992
  "ip",
851
993
  "ip_self",
852
994
  "asn",
853
995
  "company",
854
996
  "npi",
997
+ "provider",
855
998
  "continent",
856
999
  "continent_countries",
857
1000
  "bloc_countries",
@@ -918,6 +1061,9 @@ function buildServer(key, transport, options = {}) {
918
1061
  if (["postal", "postal_nearby", "postal_distance"].includes(name) && data && typeof data === "object" && "country" in data && data.country === "AU") {
919
1062
  result.content.push({ type: "text", text: AU_POSTAL_NOTICE });
920
1063
  }
1064
+ if (name === "bank_us_ach" && data && typeof data === "object" && "bank_name" in data && typeof data.bank_name === "string" && data.bank_name.length > 0) {
1065
+ result.content.push({ type: "text", text: US_ROUTING_NOTICE });
1066
+ }
921
1067
  return result;
922
1068
  } catch (err) {
923
1069
  return toErrorResult(err);
@@ -928,6 +1074,7 @@ function buildServer(key, transport, options = {}) {
928
1074
  server.registerTool(
929
1075
  name,
930
1076
  {
1077
+ title: name.split("_").map((word) => titleWords[word] ?? word.charAt(0).toUpperCase() + word.slice(1)).join(" "),
931
1078
  description,
932
1079
  inputSchema: schema,
933
1080
  annotations: { readOnlyHint: true }
@@ -1250,6 +1397,52 @@ function buildServer(key, transport, options = {}) {
1250
1397
  },
1251
1398
  (c, a, request) => c.npi(a.npi, { ...request, deep: a.deep })
1252
1399
  );
1400
+ tool(
1401
+ "bank",
1402
+ "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.",
1403
+ {
1404
+ iban: z3.string().describe("Original IBAN input, with or without the country prefix. Preserve characters exactly so the API can report invalid input. Do not strip punctuation or decode percent escapes."),
1405
+ country: iso2("country code when the number has no prefix").optional(),
1406
+ deep: deep.describe("Include optional detail on every plan.")
1407
+ },
1408
+ (c, a, request) => c.bank(a.iban, { ...request, deep: a.deep, country: a.country })
1409
+ );
1410
+ tool(
1411
+ "bank_us_ach",
1412
+ "Check US routing-number format and ABA checksum plus account-field syntax. Sends original strings in a POST JSON body. No universal account checksum is available. A nullable bank_name is routing-directory identity only; this does not establish ACH eligibility, account existence or ownership. No deep option.",
1413
+ {
1414
+ routing: z3.string().describe("Original US routing string. Preserve leading zeros and characters; the API validates accepted separators."),
1415
+ account: z3.string().describe("Original account string. Preserve all characters, letter case and leading zeros; do not trim, normalize or decode.")
1416
+ },
1417
+ (c, a, request) => c.bankUsAch({ routing: a.routing, account: a.account }, request)
1418
+ );
1419
+ tool(
1420
+ "bank_requirements",
1421
+ "Describe supported Bank input fields, normalization rules, check scope and limitations for a country and format. Metadata only: support does not establish directory completeness or payment reachability.",
1422
+ {
1423
+ country: iso2("country code"),
1424
+ format: z3.string().optional().describe("Input format, currently iban (default) or us_ach. Unknown formats report supported false.")
1425
+ },
1426
+ (c, a, request) => c.bankRequirements(a.country, { ...request, format: a.format })
1427
+ );
1428
+ tool(
1429
+ "card",
1430
+ "Identify a network and its CDN SVG logo from 2-11 leading digits, including processor-provided BIN/IIN prefixes. Unknown or ambiguous networks return null brand and a generic logo. Optional deep adds the longest recorded prefix, issuer, country, funding type and nullable prepaid status. Core identity is independent of issuer coverage. A shorter deep.prefix is broader coverage; missing fields never inherit from a parent row. Partial reference data does not prove card validity, account existence or payment acceptance. One pooled request on every plan, including deep.",
1431
+ {
1432
+ bin: z3.string().max(64, "Send a prefix only: 2-11 digits.").regex(/^[ \t\r\n-]*(?:[0-9][ \t\r\n-]*){2,11}$/, "Send a prefix only: 2-11 digits.").describe("Processor-provided leading digits as a string, 2-11 ASCII digits. Preserve zeros. Only ASCII space, tab, CR, LF and hyphen separators; at most 64 raw characters. Never send a full card number. Six or more digits enable issuer lookup."),
1433
+ deep: deep.describe("Include recorded issuer details, pooled on every plan. Omitted by default; fewer than six digits returns all-null Deep fields.")
1434
+ },
1435
+ (c, a, request) => c.card(a.bin, { ...request, deep: a.deep })
1436
+ );
1437
+ tool(
1438
+ "provider",
1439
+ "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. Core sources provides nullable edition metadata on every plan. 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.",
1440
+ {
1441
+ npi: z3.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."),
1442
+ 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.")
1443
+ },
1444
+ (c, a, request) => c.provider(a.npi, { ...request, deep: a.deep })
1445
+ );
1253
1446
  tool(
1254
1447
  "phone",
1255
1448
  "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.",
@@ -1334,9 +1527,15 @@ function buildServer(key, transport, options = {}) {
1334
1527
  { ua: z3.string().describe("The User-Agent string to parse"), deep },
1335
1528
  (c, a, request) => c.useragent(a.ua, { ...request, deep: a.deep })
1336
1529
  );
1530
+ tool(
1531
+ "vehicle",
1532
+ "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.",
1533
+ { vin: z3.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
1534
+ (c, a, request) => c.vehicle(a.vin, { ...request, deep: a.deep })
1535
+ );
1337
1536
  tool(
1338
1537
  "vin",
1339
- "Decode a VIN to year, make, model, trim, body and vehicle type. Paid deep adds specifications, manufacturing detail and recalls.",
1538
+ "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.",
1340
1539
  { vin: z3.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
1341
1540
  (c, a, request) => c.vin(a.vin, { ...request, deep: a.deep })
1342
1541
  );
@@ -1357,20 +1556,36 @@ function buildServer(key, transport, options = {}) {
1357
1556
  (c, a, request) => c.tariff.search(a.query, request)
1358
1557
  );
1359
1558
  tool(
1360
- "naics",
1559
+ "industry",
1361
1560
  "Look up a US NAICS 2022 code, title and parent hierarchy. Deep adds definition, children and exclusions on paid plans.",
1362
1561
  { code: z3.string().describe("NAICS code, e.g. 541511 or sector range 31-33"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
1363
- (c, a, request) => c.naics(a.code, { ...request, deep: a.deep })
1562
+ (c, a, request) => c.industry(a.code, { ...request, deep: a.deep })
1364
1563
  );
1365
1564
  tool(
1366
- "naics_search",
1565
+ "industry_search",
1367
1566
  "Search US NAICS 2022 titles and activities. Matching text and corrections stay with the result. Deep adds definition, children and exclusions inside each result on paid plans.",
1368
1567
  {
1369
1568
  query: z3.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
1370
1569
  limit: z3.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
1371
1570
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1372
1571
  },
1373
- (c, a, request) => c.naics.search(a.query, { ...request, deep: a.deep, limit: a.limit })
1572
+ (c, a, request) => c.industry.search(a.query, { ...request, deep: a.deep, limit: a.limit })
1573
+ );
1574
+ tool(
1575
+ "naics",
1576
+ "Compatibility name for industry. Look up a US NAICS 2022 code, title and parent hierarchy. Deep adds definition, children and exclusions on paid plans.",
1577
+ { code: z3.string().describe("NAICS code, e.g. 541511 or sector range 31-33"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
1578
+ (c, a, request) => c.industry(a.code, { ...request, deep: a.deep })
1579
+ );
1580
+ tool(
1581
+ "naics_search",
1582
+ "Compatibility name for industry_search. Search US NAICS 2022 titles and activities. Matching text and corrections stay with the result. Deep adds definition, children and exclusions inside each result on paid plans.",
1583
+ {
1584
+ query: z3.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
1585
+ limit: z3.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
1586
+ deep: deep.describe("Include the complete detail bag on a paid plan.")
1587
+ },
1588
+ (c, a, request) => c.industry.search(a.query, { ...request, deep: a.deep, limit: a.limit })
1374
1589
  );
1375
1590
  tool(
1376
1591
  "currency",
package/dist/http.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-2LCFYIWI.js";
5
+ } from "./chunk-SCQMK735.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-2LCFYIWI.js";
5
+ } from "./chunk-SCQMK735.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-2LCFYIWI.js";
5
+ } from "./chunk-SCQMK735.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.6.0",
3
+ "version": "1.7.1",
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": [
@@ -48,9 +48,9 @@
48
48
  "prepublishOnly": "npm run typecheck && npm test"
49
49
  },
50
50
  "dependencies": {
51
- "@modelcontextprotocol/server": "^2.0.0",
52
51
  "@modelcontextprotocol/node": "^2.0.0",
53
- "@parseapi/sdk": "^1.6.0",
52
+ "@modelcontextprotocol/server": "^2.0.0",
53
+ "@parseapi/sdk": "^1.8.0",
54
54
  "zod": "^4.0.0"
55
55
  },
56
56
  "devDependencies": {