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 +1 -13
- package/dist/{chunk-MO7I4G22.js → chunk-3DOZOXMP.js} +3 -81
- package/dist/http.js +1 -1
- package/dist/registry.js +1 -1
- package/dist/stdio.js +1 -1
- package/package.json +2 -2
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`, `
|
|
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.
|
|
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.
|
|
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", "
|
|
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
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.10.
|
|
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.
|
|
53
|
+
"@parseapi/sdk": "^1.11.2",
|
|
54
54
|
"zod": "^4.0.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|