parseapi-mcp 1.6.0 → 1.7.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 +29 -6
- package/dist/{chunk-2LCFYIWI.js → chunk-XLQITELE.js} +201 -9
- package/dist/http.js +1 -1
- package/dist/registry.js +1 -1
- package/dist/stdio.js +1 -1
- package/package.json +3 -3
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
|
|
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`, `
|
|
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
|
-
|
|
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
|
-
| `
|
|
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
|
-
|
|
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,
|
|
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({
|
|
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",
|
|
@@ -838,8 +957,9 @@ function registerPreflight(server, client, transport) {
|
|
|
838
957
|
}
|
|
839
958
|
|
|
840
959
|
// src/registry.ts
|
|
841
|
-
var VERSION = "1.
|
|
960
|
+
var VERSION = "1.7.0";
|
|
842
961
|
var API_VERSION = "2.0.0";
|
|
962
|
+
var US_ROUTING_NOTICE = "Routing reference attribution: https://parseapi.com/legal/attribution#routing-numbers";
|
|
843
963
|
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
964
|
var deep = z3.boolean().optional().describe("Include the nested deep object when available. Pricing depends on the operation.");
|
|
845
965
|
var lat = z3.number().min(-90).max(90).describe("Latitude in decimal degrees");
|
|
@@ -852,6 +972,7 @@ var languageTools = /* @__PURE__ */ new Set([
|
|
|
852
972
|
"asn",
|
|
853
973
|
"company",
|
|
854
974
|
"npi",
|
|
975
|
+
"provider",
|
|
855
976
|
"continent",
|
|
856
977
|
"continent_countries",
|
|
857
978
|
"bloc_countries",
|
|
@@ -918,6 +1039,9 @@ function buildServer(key, transport, options = {}) {
|
|
|
918
1039
|
if (["postal", "postal_nearby", "postal_distance"].includes(name) && data && typeof data === "object" && "country" in data && data.country === "AU") {
|
|
919
1040
|
result.content.push({ type: "text", text: AU_POSTAL_NOTICE });
|
|
920
1041
|
}
|
|
1042
|
+
if (name === "bank_us_ach" && data && typeof data === "object" && "bank_name" in data && typeof data.bank_name === "string" && data.bank_name.length > 0) {
|
|
1043
|
+
result.content.push({ type: "text", text: US_ROUTING_NOTICE });
|
|
1044
|
+
}
|
|
921
1045
|
return result;
|
|
922
1046
|
} catch (err) {
|
|
923
1047
|
return toErrorResult(err);
|
|
@@ -1250,6 +1374,52 @@ function buildServer(key, transport, options = {}) {
|
|
|
1250
1374
|
},
|
|
1251
1375
|
(c, a, request) => c.npi(a.npi, { ...request, deep: a.deep })
|
|
1252
1376
|
);
|
|
1377
|
+
tool(
|
|
1378
|
+
"bank",
|
|
1379
|
+
"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.",
|
|
1380
|
+
{
|
|
1381
|
+
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."),
|
|
1382
|
+
country: iso2("country code when the number has no prefix").optional(),
|
|
1383
|
+
deep: deep.describe("Include optional detail on every plan.")
|
|
1384
|
+
},
|
|
1385
|
+
(c, a, request) => c.bank(a.iban, { ...request, deep: a.deep, country: a.country })
|
|
1386
|
+
);
|
|
1387
|
+
tool(
|
|
1388
|
+
"bank_us_ach",
|
|
1389
|
+
"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.",
|
|
1390
|
+
{
|
|
1391
|
+
routing: z3.string().describe("Original US routing string. Preserve leading zeros and characters; the API validates accepted separators."),
|
|
1392
|
+
account: z3.string().describe("Original account string. Preserve all characters, letter case and leading zeros; do not trim, normalize or decode.")
|
|
1393
|
+
},
|
|
1394
|
+
(c, a, request) => c.bankUsAch({ routing: a.routing, account: a.account }, request)
|
|
1395
|
+
);
|
|
1396
|
+
tool(
|
|
1397
|
+
"bank_requirements",
|
|
1398
|
+
"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.",
|
|
1399
|
+
{
|
|
1400
|
+
country: iso2("country code"),
|
|
1401
|
+
format: z3.string().optional().describe("Input format, currently iban (default) or us_ach. Unknown formats report supported false.")
|
|
1402
|
+
},
|
|
1403
|
+
(c, a, request) => c.bankRequirements(a.country, { ...request, format: a.format })
|
|
1404
|
+
);
|
|
1405
|
+
tool(
|
|
1406
|
+
"card",
|
|
1407
|
+
"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.",
|
|
1408
|
+
{
|
|
1409
|
+
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."),
|
|
1410
|
+
deep: deep.describe("Include recorded issuer details, pooled on every plan. Omitted by default; fewer than six digits returns all-null Deep fields.")
|
|
1411
|
+
},
|
|
1412
|
+
(c, a, request) => c.card(a.bin, { ...request, deep: a.deep })
|
|
1413
|
+
);
|
|
1414
|
+
tool(
|
|
1415
|
+
"provider",
|
|
1416
|
+
"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.",
|
|
1417
|
+
{
|
|
1418
|
+
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."),
|
|
1419
|
+
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.")
|
|
1420
|
+
},
|
|
1421
|
+
(c, a, request) => c.provider(a.npi, { ...request, deep: a.deep })
|
|
1422
|
+
);
|
|
1253
1423
|
tool(
|
|
1254
1424
|
"phone",
|
|
1255
1425
|
"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 +1504,15 @@ function buildServer(key, transport, options = {}) {
|
|
|
1334
1504
|
{ ua: z3.string().describe("The User-Agent string to parse"), deep },
|
|
1335
1505
|
(c, a, request) => c.useragent(a.ua, { ...request, deep: a.deep })
|
|
1336
1506
|
);
|
|
1507
|
+
tool(
|
|
1508
|
+
"vehicle",
|
|
1509
|
+
"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.",
|
|
1510
|
+
{ vin: z3.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
|
|
1511
|
+
(c, a, request) => c.vehicle(a.vin, { ...request, deep: a.deep })
|
|
1512
|
+
);
|
|
1337
1513
|
tool(
|
|
1338
1514
|
"vin",
|
|
1339
|
-
"Decode a VIN to year, make, model, trim, body and vehicle type. Paid deep adds specifications, manufacturing detail and
|
|
1515
|
+
"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
1516
|
{ vin: z3.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
|
|
1341
1517
|
(c, a, request) => c.vin(a.vin, { ...request, deep: a.deep })
|
|
1342
1518
|
);
|
|
@@ -1357,20 +1533,36 @@ function buildServer(key, transport, options = {}) {
|
|
|
1357
1533
|
(c, a, request) => c.tariff.search(a.query, request)
|
|
1358
1534
|
);
|
|
1359
1535
|
tool(
|
|
1360
|
-
"
|
|
1536
|
+
"industry",
|
|
1361
1537
|
"Look up a US NAICS 2022 code, title and parent hierarchy. Deep adds definition, children and exclusions on paid plans.",
|
|
1362
1538
|
{ 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.
|
|
1539
|
+
(c, a, request) => c.industry(a.code, { ...request, deep: a.deep })
|
|
1364
1540
|
);
|
|
1365
1541
|
tool(
|
|
1366
|
-
"
|
|
1542
|
+
"industry_search",
|
|
1367
1543
|
"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
1544
|
{
|
|
1369
1545
|
query: z3.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
|
|
1370
1546
|
limit: z3.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
|
|
1371
1547
|
deep: deep.describe("Include the complete detail bag on a paid plan.")
|
|
1372
1548
|
},
|
|
1373
|
-
(c, a, request) => c.
|
|
1549
|
+
(c, a, request) => c.industry.search(a.query, { ...request, deep: a.deep, limit: a.limit })
|
|
1550
|
+
);
|
|
1551
|
+
tool(
|
|
1552
|
+
"naics",
|
|
1553
|
+
"Compatibility name for industry. Look up a US NAICS 2022 code, title and parent hierarchy. Deep adds definition, children and exclusions on paid plans.",
|
|
1554
|
+
{ 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.") },
|
|
1555
|
+
(c, a, request) => c.industry(a.code, { ...request, deep: a.deep })
|
|
1556
|
+
);
|
|
1557
|
+
tool(
|
|
1558
|
+
"naics_search",
|
|
1559
|
+
"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.",
|
|
1560
|
+
{
|
|
1561
|
+
query: z3.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
|
|
1562
|
+
limit: z3.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
|
|
1563
|
+
deep: deep.describe("Include the complete detail bag on a paid plan.")
|
|
1564
|
+
},
|
|
1565
|
+
(c, a, request) => c.industry.search(a.query, { ...request, deep: a.deep, limit: a.limit })
|
|
1374
1566
|
);
|
|
1375
1567
|
tool(
|
|
1376
1568
|
"currency",
|
package/dist/http.js
CHANGED
package/dist/registry.js
CHANGED
package/dist/stdio.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "parseapi-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.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": [
|
|
@@ -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
|
-
"@
|
|
52
|
+
"@modelcontextprotocol/server": "^2.0.0",
|
|
53
|
+
"@parseapi/sdk": "^1.8.0",
|
|
54
54
|
"zod": "^4.0.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|