parseapi-mcp 1.7.1 → 1.8.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 +20 -5
- package/dist/{chunk-SCQMK735.js → chunk-HTZMIZFF.js} +47 -8
- 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
|
@@ -55,9 +55,9 @@ 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 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`, `email`, `vat`, `bank`, `bank_us_ach`, `bank_requirements`, `card`, `provider`, `vehicle`, `industry`, `industry_search`, `tariff`, `dns`, `asn`, `mac`, `currency_rate`, and the rest.
|
|
60
|
+
Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `company_id`, `company_search`, `company_coverage`, `email`, `vat`, `bank`, `bank_us_ach`, `bank_requirements`, `card`, `provider`, `vehicle`, `industry`, `industry_search`, `tariff`, `dns`, `asn`, `mac`, `currency_rate`, and the rest. Text searches take `query`. Company directory search supports one name/domain/ticker/identifier selector or country/exact-SIC discovery filters.
|
|
61
61
|
|
|
62
62
|
The existing `naics` and `naics_search` tools remain available as compatibility names for Industry.
|
|
63
63
|
|
|
@@ -80,6 +80,9 @@ Example tool arguments:
|
|
|
80
80
|
| `country_states` | `{"code":"US"}` |
|
|
81
81
|
| `address_search` | `{"query":"1600 Pennsylvania","country":"US","city":"Washington","state":"DC"}` |
|
|
82
82
|
| `company` | `{"number":"552100554","country":"FR"}` |
|
|
83
|
+
| `company_search` | `{"query":"Cloudflare","country":"US"}` |
|
|
84
|
+
| `company_id` | `{"id":"co_xw3f22es6cjq","deep":true}` |
|
|
85
|
+
| `company_coverage` | `{}` |
|
|
83
86
|
| `time` | `{}` (UTC now) |
|
|
84
87
|
| `time` | `{"timezone":"America/New_York","at":"2026-09-05T09:00:00","to":"Asia/Tokyo"}` |
|
|
85
88
|
| `time` | `{"lat":40.71,"lon":-74.01}` |
|
|
@@ -101,12 +104,24 @@ A path uses the same string formats with 2-512 vertices and a required integer `
|
|
|
101
104
|
|
|
102
105
|
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).
|
|
103
106
|
|
|
104
|
-
|
|
107
|
+
Address lookup returns standardized components and registration status for the US and France. Its `deep` object is currently empty. National-number `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`.
|
|
108
|
+
|
|
109
|
+
For the company directory, call `company_search` with at most one of `query`,
|
|
110
|
+
`domain`, `ticker` or `identifier`. Use `exchange` with a ticker and `authority`
|
|
111
|
+
with an identifier. Review the candidates, then pass the chosen `id` to
|
|
112
|
+
`company_id`. Send the returned `next` as `cursor` with the same selector,
|
|
113
|
+
filters and `limit` for another page. Directory deep adds detail in the same
|
|
114
|
+
pooled request on every plan and belongs to each company result.
|
|
115
|
+
Selected website descriptions, logos, socials and founding claims include
|
|
116
|
+
field-level sources. Logo URLs are returned without fetching images. Directory
|
|
117
|
+
tools do not accept `lang`. `company_coverage` describes the edition's records,
|
|
118
|
+
and empty listings do not establish private ownership. The existing `company`
|
|
119
|
+
tool continues to parse national registration numbers.
|
|
105
120
|
|
|
106
|
-
|
|
121
|
+
For discovery without an identity selector, supply `country` or both `industry` and `industry_type`. For example: `{ "country": "US", "industry": "0700", "industry_type": "sic" }`. SIC is the supported namespace; its exact four-digit code stays a string. Empty requests, incomplete industry pairs and multiple selectors are rejected. Country means the profile country. Filters intersect, unknown values do not match, and the same filters and limit must accompany a returned cursor. Filter-only candidates carry `match: { "field": "filters", "value": null }`.
|
|
107
122
|
|
|
108
123
|
|
|
109
|
-
|
|
124
|
+
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. Core `sources` is available on every plan: NPPES, LEIE, PECOS and opt-out each have nullable edition metadata (`edition`, `published_at`, `through`, `imported_at`). Provider record dates are separate from source publication and completed import dates. Older responses may omit these additions. Edition details remain null until a verified source is served.
|
|
110
125
|
|
|
111
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.
|
|
112
127
|
|
|
@@ -960,7 +960,7 @@ function registerPreflight(server, client, transport) {
|
|
|
960
960
|
}
|
|
961
961
|
|
|
962
962
|
// src/registry.ts
|
|
963
|
-
var VERSION = "1.
|
|
963
|
+
var VERSION = "1.8.0";
|
|
964
964
|
var API_VERSION = "2.0.0";
|
|
965
965
|
var US_ROUTING_NOTICE = "Routing reference attribution: https://parseapi.com/legal/attribution#routing-numbers";
|
|
966
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";
|
|
@@ -968,6 +968,8 @@ var deep = z3.boolean().optional().describe("Include the nested deep object when
|
|
|
968
968
|
var lat = z3.number().min(-90).max(90).describe("Latitude in decimal degrees");
|
|
969
969
|
var lon = z3.number().min(-180).max(180).describe("Longitude in decimal degrees");
|
|
970
970
|
var iso2 = (what) => z3.string().describe(`ISO 3166-1 alpha-2 ${what}, e.g. US`);
|
|
971
|
+
var tariffEdition = z3.string().regex(/^[a-f0-9]{64}$/).optional().describe("Exact immutable edition fingerprint. Without date, returns undated schedule context.");
|
|
972
|
+
var tariffDate = z3.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.");
|
|
971
973
|
var countryOpt = z3.string().optional().describe("ISO2, ISO3, or a country name. Optional when the lookup is unique.");
|
|
972
974
|
var titleWords = {
|
|
973
975
|
ip: "IP",
|
|
@@ -1311,6 +1313,41 @@ function buildServer(key, transport, options = {}) {
|
|
|
1311
1313
|
},
|
|
1312
1314
|
(c, a, request) => c.company(a.number, { ...request, country: a.country, deep: a.deep })
|
|
1313
1315
|
);
|
|
1316
|
+
tool(
|
|
1317
|
+
"company_id",
|
|
1318
|
+
"Look up a company directory profile by its stable co_ ID. Deep adds legal/reference details and selected description, logo, domains, social_profiles (platform, url, handle), phone_numbers and email_addresses (with source-reported type), founding precision, reported employees and field-level sources when available. Employee counts retain their measurement date, organization scope and approximation flag; null means unknown. A website claim is not legal ownership proof. National registration numbers use company.",
|
|
1319
|
+
{ id: z3.string().min(1).describe("Stable company directory ID returned by company_search"), deep },
|
|
1320
|
+
(c, a, request) => c.company.id(a.id, { ...request, deep: a.deep })
|
|
1321
|
+
);
|
|
1322
|
+
tool(
|
|
1323
|
+
"company_search",
|
|
1324
|
+
"Find company directory candidates using at most one of query, domain, ticker or identifier, or discover by country, an exact industry pair. Returns companies and an opaque next cursor without choosing a match. Deep belongs to each result. Keep the same selector, filters and limit when sending cursor. Empty listings do not establish private ownership.",
|
|
1325
|
+
{
|
|
1326
|
+
query: z3.string().min(1).optional().describe("Company name search, sent as q"),
|
|
1327
|
+
domain: z3.string().min(1).optional().describe("Company website domain or URL"),
|
|
1328
|
+
ticker: z3.string().min(1).optional().describe("Security ticker, optionally scoped by exchange"),
|
|
1329
|
+
identifier: z3.string().min(1).optional().describe("Business identifier, preserving leading zeros"),
|
|
1330
|
+
country: z3.string().regex(/^[A-Za-z]{2}$/).optional().describe("ISO2 profile-country filter; does not mean headquarters or operating presence"),
|
|
1331
|
+
industry: z3.string().regex(/^[0-9]{4}$/).optional().describe("Exact four-digit SIC code string, preserving leading zeros; requires industry_type"),
|
|
1332
|
+
industry_type: z3.literal("sic").optional().describe("Industry namespace; currently sic; requires industry"),
|
|
1333
|
+
exchange: z3.string().optional().describe("Exchange filter for ticker searches"),
|
|
1334
|
+
authority: z3.string().optional().describe("Issuing authority filter for identifier searches"),
|
|
1335
|
+
limit: z3.number().int().min(1).max(50).optional().describe("Maximum candidates on this page, from 1 to 50"),
|
|
1336
|
+
cursor: z3.string().optional().describe("Opaque next cursor returned by the same search"),
|
|
1337
|
+
deep
|
|
1338
|
+
},
|
|
1339
|
+
(c, a, request) => c.company.search({ ...request, query: a.query, domain: a.domain, ticker: a.ticker, identifier: a.identifier, country: a.country, industry: a.industry, industry_type: a.industry_type, exchange: a.exchange, authority: a.authority, limit: a.limit, cursor: a.cursor, deep: a.deep }),
|
|
1340
|
+
(schema) => schema.refine((args) => args.industry === void 0 === (args.industry_type === void 0), { message: "Supply industry and industry_type together." }).refine((args) => {
|
|
1341
|
+
const selectors = [args.query, args.domain, args.ticker, args.identifier].filter((value) => value !== void 0).length;
|
|
1342
|
+
return selectors <= 1 && (selectors === 1 || args.country !== void 0 || args.industry !== void 0 && args.industry_type !== void 0);
|
|
1343
|
+
}, { message: "Use at most one selector, or supply country, a complete industry pair." })
|
|
1344
|
+
);
|
|
1345
|
+
tool(
|
|
1346
|
+
"company_coverage",
|
|
1347
|
+
"Describe the company directory edition, countries and record counts. Counts describe this edition and do not establish complete country or worldwide coverage. A missing profile does not establish that a company does not exist.",
|
|
1348
|
+
{},
|
|
1349
|
+
(c, _a, request) => c.company.coverage(request)
|
|
1350
|
+
);
|
|
1314
1351
|
tool(
|
|
1315
1352
|
"point",
|
|
1316
1353
|
"Locate coordinates in their country, state, district and actual IANA timezone. Deep adds terrain and a compact nearest-city summary on every plan. The timezone ID stays in core. Nearest city is null when none is within 200 km.",
|
|
@@ -1541,19 +1578,21 @@ function buildServer(key, transport, options = {}) {
|
|
|
1541
1578
|
);
|
|
1542
1579
|
tool(
|
|
1543
1580
|
"tariff",
|
|
1544
|
-
"Look up a tariff code, description, lineage
|
|
1581
|
+
"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.",
|
|
1545
1582
|
{
|
|
1546
|
-
code: z3.string().describe("HTS code
|
|
1547
|
-
origin: iso2("country
|
|
1583
|
+
code: z3.string().describe("US HTS code: 4, 6, 8 or 10 ASCII digits, dots and whitespace optional, e.g. 8471.30.01.00"),
|
|
1584
|
+
origin: iso2("country where the goods originate, not the shipping country; only read with deep").optional(),
|
|
1585
|
+
edition: tariffEdition,
|
|
1586
|
+
date: tariffDate,
|
|
1548
1587
|
deep
|
|
1549
1588
|
},
|
|
1550
|
-
(c, a, request) => c.tariff(a.code, { ...request, deep: a.deep, origin: a.origin })
|
|
1589
|
+
(c, a, request) => c.tariff(a.code, { ...request, deep: a.deep, origin: a.origin, edition: a.edition, date: a.date })
|
|
1551
1590
|
);
|
|
1552
1591
|
tool(
|
|
1553
1592
|
"tariff_search",
|
|
1554
|
-
"Search US tariff schedule descriptions by product. Returns up to 20 lines
|
|
1555
|
-
{ query: z3.string().describe("Product words, e.g. sunglasses, laptop, coffee") },
|
|
1556
|
-
(c, a, request) => c.tariff.search(a.query, request)
|
|
1593
|
+
"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.",
|
|
1594
|
+
{ query: z3.string().describe("Product words, e.g. sunglasses, laptop, coffee"), edition: tariffEdition, date: tariffDate },
|
|
1595
|
+
(c, a, request) => c.tariff.search(a.query, { ...request, edition: a.edition, date: a.date })
|
|
1557
1596
|
);
|
|
1558
1597
|
tool(
|
|
1559
1598
|
"industry",
|
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.8.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": [
|
|
@@ -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.
|
|
53
|
+
"@parseapi/sdk": "^1.9.0",
|
|
54
54
|
"zod": "^4.0.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|