parseapi-mcp 1.7.0 → 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-XLQITELE.js → chunk-HTZMIZFF.js} +70 -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
|
|
|
@@ -871,6 +871,7 @@ function registerDiscovery(server, operations, mode, apiVersion) {
|
|
|
871
871
|
const all = [...operations.values()].sort((a, b) => a.name.localeCompare(b.name));
|
|
872
872
|
const reviewed = Object.keys(policies).filter((name) => operations.has(name)).sort();
|
|
873
873
|
server.registerTool("discover", {
|
|
874
|
+
title: "Discover ParseAPI operations",
|
|
874
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.",
|
|
875
876
|
inputSchema: z.object({
|
|
876
877
|
query: z.string().trim().min(1).max(256).optional().describe("Keywords such as mailbox, DNS, or population"),
|
|
@@ -916,6 +917,7 @@ function registerDiscovery(server, operations, mode, apiVersion) {
|
|
|
916
917
|
});
|
|
917
918
|
if (mode !== "compact") return;
|
|
918
919
|
server.registerTool("lookup", {
|
|
920
|
+
title: "Run a ParseAPI lookup",
|
|
919
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.",
|
|
920
922
|
inputSchema: z.object({ operation: z.string().min(1).max(64), arguments: object2 }),
|
|
921
923
|
annotations: { readOnlyHint: true, idempotentHint: false }
|
|
@@ -942,6 +944,7 @@ var task = z2.strictObject({
|
|
|
942
944
|
});
|
|
943
945
|
function registerPreflight(server, client, transport) {
|
|
944
946
|
server.registerTool("preflight", {
|
|
947
|
+
title: "Estimate ParseAPI task usage",
|
|
945
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.",
|
|
946
949
|
inputSchema: task,
|
|
947
950
|
annotations: { readOnlyHint: true, idempotentHint: true }
|
|
@@ -957,7 +960,7 @@ function registerPreflight(server, client, transport) {
|
|
|
957
960
|
}
|
|
958
961
|
|
|
959
962
|
// src/registry.ts
|
|
960
|
-
var VERSION = "1.
|
|
963
|
+
var VERSION = "1.8.0";
|
|
961
964
|
var API_VERSION = "2.0.0";
|
|
962
965
|
var US_ROUTING_NOTICE = "Routing reference attribution: https://parseapi.com/legal/attribution#routing-numbers";
|
|
963
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";
|
|
@@ -965,7 +968,28 @@ var deep = z3.boolean().optional().describe("Include the nested deep object when
|
|
|
965
968
|
var lat = z3.number().min(-90).max(90).describe("Latitude in decimal degrees");
|
|
966
969
|
var lon = z3.number().min(-180).max(180).describe("Longitude in decimal degrees");
|
|
967
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.");
|
|
968
973
|
var countryOpt = z3.string().optional().describe("ISO2, ISO3, or a country name. Optional when the lookup is unique.");
|
|
974
|
+
var titleWords = {
|
|
975
|
+
ip: "IP",
|
|
976
|
+
asn: "ASN",
|
|
977
|
+
id: "ID",
|
|
978
|
+
dns: "DNS",
|
|
979
|
+
mx: "MX",
|
|
980
|
+
vat: "VAT",
|
|
981
|
+
iban: "IBAN",
|
|
982
|
+
npi: "NPI",
|
|
983
|
+
naics: "NAICS",
|
|
984
|
+
vin: "VIN",
|
|
985
|
+
bin: "BIN",
|
|
986
|
+
us: "US",
|
|
987
|
+
ach: "ACH",
|
|
988
|
+
url: "URL",
|
|
989
|
+
hlr: "HLR",
|
|
990
|
+
mac: "MAC",
|
|
991
|
+
useragent: "User Agent"
|
|
992
|
+
};
|
|
969
993
|
var languageTools = /* @__PURE__ */ new Set([
|
|
970
994
|
"ip",
|
|
971
995
|
"ip_self",
|
|
@@ -1052,6 +1076,7 @@ function buildServer(key, transport, options = {}) {
|
|
|
1052
1076
|
server.registerTool(
|
|
1053
1077
|
name,
|
|
1054
1078
|
{
|
|
1079
|
+
title: name.split("_").map((word) => titleWords[word] ?? word.charAt(0).toUpperCase() + word.slice(1)).join(" "),
|
|
1055
1080
|
description,
|
|
1056
1081
|
inputSchema: schema,
|
|
1057
1082
|
annotations: { readOnlyHint: true }
|
|
@@ -1288,6 +1313,41 @@ function buildServer(key, transport, options = {}) {
|
|
|
1288
1313
|
},
|
|
1289
1314
|
(c, a, request) => c.company(a.number, { ...request, country: a.country, deep: a.deep })
|
|
1290
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
|
+
);
|
|
1291
1351
|
tool(
|
|
1292
1352
|
"point",
|
|
1293
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.",
|
|
@@ -1518,19 +1578,21 @@ function buildServer(key, transport, options = {}) {
|
|
|
1518
1578
|
);
|
|
1519
1579
|
tool(
|
|
1520
1580
|
"tariff",
|
|
1521
|
-
"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.",
|
|
1522
1582
|
{
|
|
1523
|
-
code: z3.string().describe("HTS code
|
|
1524
|
-
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,
|
|
1525
1587
|
deep
|
|
1526
1588
|
},
|
|
1527
|
-
(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 })
|
|
1528
1590
|
);
|
|
1529
1591
|
tool(
|
|
1530
1592
|
"tariff_search",
|
|
1531
|
-
"Search US tariff schedule descriptions by product. Returns up to 20 lines
|
|
1532
|
-
{ query: z3.string().describe("Product words, e.g. sunglasses, laptop, coffee") },
|
|
1533
|
-
(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 })
|
|
1534
1596
|
);
|
|
1535
1597
|
tool(
|
|
1536
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": {
|