parseapi-mcp 1.10.1 → 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 -12
- package/dist/{chunk-PID2V4GM.js → chunk-3DOZOXMP.js} +3 -68
- 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`.
|
|
@@ -297,9 +289,6 @@ Reviewed children, ancestors and siblings use canonical lists with partial relat
|
|
|
297
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.
|
|
298
290
|
|
|
299
291
|
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
292
|
Coverage by country and available fields is described at https://parseapi.com/city#coverage.
|
|
304
293
|
|
|
305
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",
|
|
@@ -1795,7 +1793,7 @@ function cityCollectionArguments(args) {
|
|
|
1795
1793
|
romanized: args.romanized || void 0
|
|
1796
1794
|
};
|
|
1797
1795
|
}
|
|
1798
|
-
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"]);
|
|
1799
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.");
|
|
1800
1798
|
var emojiFilters = {
|
|
1801
1799
|
limit: z4.number().int().min(1).max(50).optional().describe("Maximum results per page."),
|
|
@@ -1914,22 +1912,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
1914
1912
|
{ code: z4.string().describe("Continent code: AF, AN, AS, EU, NA, OC, SA") },
|
|
1915
1913
|
(c, a, request) => c.continent.countries(a.code, request)
|
|
1916
1914
|
);
|
|
1917
|
-
tool(
|
|
1918
|
-
"bloc",
|
|
1919
|
-
"Look up a country group by code: EU, EEA, Schengen, Eurozone, SEPA, NATO, and more. Returns the official name and the current member count.",
|
|
1920
|
-
{
|
|
1921
|
-
code: z4.string().describe("Bloc code: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR")
|
|
1922
|
-
},
|
|
1923
|
-
(c, a, request) => c.bloc(a.code, request)
|
|
1924
|
-
);
|
|
1925
|
-
tool(
|
|
1926
|
-
"bloc_countries",
|
|
1927
|
-
"List the current members of a country group, each with name, flag, and calling code.",
|
|
1928
|
-
{
|
|
1929
|
-
code: z4.string().describe("Bloc code: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR")
|
|
1930
|
-
},
|
|
1931
|
-
(c, a, request) => c.bloc.countries(a.code, request)
|
|
1932
|
-
);
|
|
1933
1915
|
tool(
|
|
1934
1916
|
"country",
|
|
1935
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.",
|
|
@@ -2250,17 +2232,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
2250
2232
|
{ email: z4.string().describe("Email address to validate"), deep },
|
|
2251
2233
|
(c, a, request) => c.email(a.email, { ...request, deep: a.deep })
|
|
2252
2234
|
);
|
|
2253
|
-
tool(
|
|
2254
|
-
"vat",
|
|
2255
|
-
"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.",
|
|
2256
|
-
{
|
|
2257
|
-
number: z4.string().describe("VAT number, with or without the country prefix"),
|
|
2258
|
-
country: iso2("country code when the number has no prefix").optional(),
|
|
2259
|
-
from: z4.string().optional().describe("Your own VAT number. Returns a consultation identifier for your audit file"),
|
|
2260
|
-
deep
|
|
2261
|
-
},
|
|
2262
|
-
(c, a, request) => c.vat(a.number, { ...request, country: a.country, from: a.from, deep: a.deep })
|
|
2263
|
-
);
|
|
2264
2235
|
tool(
|
|
2265
2236
|
"iban",
|
|
2266
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.",
|
|
@@ -2280,15 +2251,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
2280
2251
|
},
|
|
2281
2252
|
(c, a, request) => c.bin(a.bin, { ...request, deep: a.deep })
|
|
2282
2253
|
);
|
|
2283
|
-
tool(
|
|
2284
|
-
"npi",
|
|
2285
|
-
"Validate an NPI and identify the registered provider, active/exclusion status, specialty and practice contact. Paid deep adds deactivation date and Medicare enrollment evidence.",
|
|
2286
|
-
{
|
|
2287
|
-
npi: z4.string().describe("10-digit NPI number"),
|
|
2288
|
-
deep
|
|
2289
|
-
},
|
|
2290
|
-
(c, a, request) => c.npi(a.npi, { ...request, deep: a.deep })
|
|
2291
|
-
);
|
|
2292
2254
|
tool(
|
|
2293
2255
|
"bank",
|
|
2294
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.",
|
|
@@ -2326,15 +2288,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
2326
2288
|
},
|
|
2327
2289
|
(c, a, request) => c.card(a.bin, { ...request, deep: a.deep })
|
|
2328
2290
|
);
|
|
2329
|
-
tool(
|
|
2330
|
-
"provider",
|
|
2331
|
-
"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.",
|
|
2332
|
-
{
|
|
2333
|
-
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."),
|
|
2334
|
-
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.")
|
|
2335
|
-
},
|
|
2336
|
-
(c, a, request) => c.provider(a.npi, { ...request, deep: a.deep })
|
|
2337
|
-
);
|
|
2338
2291
|
tool(
|
|
2339
2292
|
"phone",
|
|
2340
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.",
|
|
@@ -2419,24 +2372,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
2419
2372
|
{ ua: z4.string().describe("The User-Agent string to parse"), deep },
|
|
2420
2373
|
(c, a, request) => c.useragent(a.ua, { ...request, deep: a.deep })
|
|
2421
2374
|
);
|
|
2422
|
-
tool(
|
|
2423
|
-
"tariff",
|
|
2424
|
-
"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.",
|
|
2425
|
-
{
|
|
2426
|
-
code: z4.string().describe("US HTS code: 4, 6, 8 or 10 ASCII digits, dots and whitespace optional, e.g. 8471.30.01.00"),
|
|
2427
|
-
origin: iso2("country where the goods originate, not the shipping country; only read with deep").optional(),
|
|
2428
|
-
edition: tariffEdition,
|
|
2429
|
-
date: tariffDate,
|
|
2430
|
-
deep
|
|
2431
|
-
},
|
|
2432
|
-
(c, a, request) => c.tariff(a.code, { ...request, deep: a.deep, origin: a.origin, edition: a.edition, date: a.date })
|
|
2433
|
-
);
|
|
2434
|
-
tool(
|
|
2435
|
-
"tariff_search",
|
|
2436
|
-
"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.",
|
|
2437
|
-
{ query: z4.string().describe("Product words, e.g. sunglasses, laptop, coffee"), edition: tariffEdition, date: tariffDate },
|
|
2438
|
-
(c, a, request) => c.tariff.search(a.query, { ...request, edition: a.edition, date: a.date })
|
|
2439
|
-
);
|
|
2440
2375
|
tool(
|
|
2441
2376
|
"industry",
|
|
2442
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": {
|