parseapi-mcp 1.2.0 → 1.4.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 +21 -2
- package/dist/{chunk-ZB7K3OVF.js → chunk-MZR3GHLE.js} +15 -3
- 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,7 +55,7 @@ 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 59 local lookup tools and 58 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
60
|
Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `email`, `vat`, `iban`, `bin`, `npi`, `vin`, `naics`, `naics_search`, `tariff`, `dns`, `asn`, `mac`, `currency_rate`, and the rest. All search tools take `query`.
|
|
61
61
|
|
|
@@ -65,6 +65,7 @@ Example tool arguments:
|
|
|
65
65
|
|
|
66
66
|
| Tool | Arguments |
|
|
67
67
|
|---|---|
|
|
68
|
+
| `stack` | `{"domain":"example.com"}` (website technologies and versions by category) |
|
|
68
69
|
| `domain` | `{"domain":"example.com"}` (registration status) |
|
|
69
70
|
| `domain` | `{"domain":"example.com","deep":true}` (registration details on paid plans) |
|
|
70
71
|
| `dns` | `{"domain":"example.com","type":"TXT"}` |
|
|
@@ -80,6 +81,8 @@ Example tool arguments:
|
|
|
80
81
|
| `time` | `{"lat":40.71,"lon":-74.01}` |
|
|
81
82
|
| `date` | `{"date":"03/04/2026","format":"dmy"}` |
|
|
82
83
|
|
|
84
|
+
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).
|
|
85
|
+
|
|
83
86
|
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`.
|
|
84
87
|
|
|
85
88
|
|
|
@@ -117,7 +120,7 @@ The estimate allows up to three attempts per ordinary lookup and one per Email D
|
|
|
117
120
|
For a compact tool catalog, set `PARSEAPI_MCP_MODE=compact` on the MCP process:
|
|
118
121
|
|
|
119
122
|
```bash
|
|
120
|
-
PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@1.
|
|
123
|
+
PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@1.4.0
|
|
121
124
|
```
|
|
122
125
|
|
|
123
126
|
Set `PARSEAPI_KEY` in the process environment for lookups. Compact mode advertises three tools, `discover`, `preflight` and `lookup`. After discovering an operation, pass its exact name and arguments:
|
|
@@ -171,3 +174,19 @@ MIT licensed.
|
|
|
171
174
|
Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date, Currency, Language, Emoji, Phone, IBAN 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.
|
|
172
175
|
|
|
173
176
|
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.
|
|
177
|
+
|
|
178
|
+
## Stack API
|
|
179
|
+
|
|
180
|
+
Call the `stack` tool:
|
|
181
|
+
|
|
182
|
+
```json
|
|
183
|
+
{"domain":"example.com"}
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
Pass a public hostname without a scheme, path, port or IP address. Stack returns the checked URL and `checked_at` time, followed by `scope`, `pages` and `partial`. `scope` is `homepage` or `site`; `pages` counts successfully checked HTML pages. `partial` is true for homepage-only or incomplete bounded site checks. False means the known in-scope candidates were completed, not that every page on a website was visited. A homepage result has `scope: "homepage"`, `pages: 1` and `partial: true`.
|
|
187
|
+
|
|
188
|
+
`cms`, `servers`, `frameworks`, `ecommerce`, `analytics`, `chat`, `payments` and `hosting` are arrays because a site can use several technologies in each category. Each entry contains `technology`, `name` and nullable `version`. Technology codes are open strings. A successful check uses empty arrays for categories with no matches. When no HTML page could be checked, `checked_at` and all categories are null, `pages` is 0 and `partial` is null. Unknown or conflicting versions are null. Missing detections do not prove absence.
|
|
189
|
+
|
|
190
|
+
Successful checks may be reused for up to 24 hours. `pretty` optionally formats the wire JSON. Stack uses your plan's request allowance and API version 2.0.0 selected by this client.
|
|
191
|
+
|
|
192
|
+
The `stack` tool allows 35 seconds per attempt for a first check. MCP cancellation still aborts the request.
|
|
@@ -372,8 +372,9 @@ function registerPreflight(server, client, transport) {
|
|
|
372
372
|
}
|
|
373
373
|
|
|
374
374
|
// src/registry.ts
|
|
375
|
-
var VERSION = "1.
|
|
375
|
+
var VERSION = "1.4.0";
|
|
376
376
|
var API_VERSION = "2.0.0";
|
|
377
|
+
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";
|
|
377
378
|
var deep = z3.boolean().optional().describe("Include the nested deep object when available. Pricing depends on the operation.");
|
|
378
379
|
var lat = z3.number().min(-90).max(90).describe("Latitude in decimal degrees");
|
|
379
380
|
var lon = z3.number().min(-180).max(180).describe("Longitude in decimal degrees");
|
|
@@ -446,7 +447,12 @@ function buildServer(key, transport, options = {}) {
|
|
|
446
447
|
signal,
|
|
447
448
|
...localized && typeof requested === "string" ? { lang: requested } : {}
|
|
448
449
|
};
|
|
449
|
-
|
|
450
|
+
const data = await fn(parse, args, request);
|
|
451
|
+
const result = ok(data);
|
|
452
|
+
if (["postal", "postal_nearby", "postal_distance"].includes(name) && data && typeof data === "object" && "country" in data && data.country === "AU") {
|
|
453
|
+
result.content.push({ type: "text", text: AU_POSTAL_NOTICE });
|
|
454
|
+
}
|
|
455
|
+
return result;
|
|
450
456
|
} catch (err) {
|
|
451
457
|
return toErrorResult(err);
|
|
452
458
|
}
|
|
@@ -628,7 +634,7 @@ function buildServer(key, transport, options = {}) {
|
|
|
628
634
|
);
|
|
629
635
|
tool(
|
|
630
636
|
"postal",
|
|
631
|
-
"Resolve a postal code to its place, coordinates and timezone. Deep adds area, population with its reporting period, tax references, neighbors and metro associations on paid plans. property_tax is a nullable area statistic with annual_median, currency and period: median annual tax payable on owner-occupied homes, adjusted to the final year of the period. It is not a rate or property bill. Unsupported, missing and censored estimates are null. Tax rates are percentages and alternative geographic references, not additive.",
|
|
637
|
+
"Resolve a postal code to its place, coordinates and timezone. Australian core localities lists suburb choices with city, state and state_name. Null or missing means unknown, and [] means no eligible choices in the reviewed reference. A single choice can coexist with city null, so do not infer a city or a user selection. These are geographic choices, not mailing-address verification. Deep adds area, population with its reporting period, tax references, neighbors and metro associations on paid plans. property_tax is a nullable area statistic with annual_median, currency and period: median annual tax payable on owner-occupied homes, adjusted to the final year of the period. It is not a rate or property bill. Unsupported, missing and censored estimates are null. Tax rates are percentages and alternative geographic references, not additive.",
|
|
632
638
|
{
|
|
633
639
|
code: z3.string().describe("Postal or ZIP code, e.g. SW1A 1AA, 28202"),
|
|
634
640
|
country: countryOpt,
|
|
@@ -799,6 +805,12 @@ function buildServer(key, transport, options = {}) {
|
|
|
799
805
|
},
|
|
800
806
|
(c, a, request) => c.hlr(a.number, { ...request, deep: a.deep, country: a.country })
|
|
801
807
|
);
|
|
808
|
+
tool(
|
|
809
|
+
"stack",
|
|
810
|
+
"Identify website technologies and available versions by category. Requires a hostname only. CMS, servers, frameworks, ecommerce, analytics, chat, payments and hosting are arrays of technology, name and nullable version. checked_at gives the check time. Scope is homepage or site; pages counts successfully checked HTML pages. Partial is true for homepage-only or incomplete bounded checks, false only when known in-scope candidates finished, never a guarantee every page was visited. When no page could be checked, checked_at and all categories are null, pages is 0 and partial is null. Empty arrays mean no matches. Missing detections do not prove absence. Uses one request from the plan allowance. Successful checks may be reused for up to 24 hours.",
|
|
811
|
+
{ domain: z3.string().min(1).max(253).describe("Public website hostname only, e.g. example.com. No scheme, path, port or IP address."), pretty: z3.boolean().optional().describe("Format the JSON response.") },
|
|
812
|
+
(c, a, request) => c.stack(a.domain, { ...request, pretty: a.pretty })
|
|
813
|
+
);
|
|
802
814
|
tool(
|
|
803
815
|
"domain",
|
|
804
816
|
"Check whether a domain is registered. Deep adds registration dates, registrar, status and DNSSEC, included on paid plans. Use dns for DNS records and mx for mail routing.",
|
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.4.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/server": "^2.0.0",
|
|
52
52
|
"@modelcontextprotocol/node": "^2.0.0",
|
|
53
|
-
"@parseapi/sdk": "^1.
|
|
53
|
+
"@parseapi/sdk": "^1.4.0",
|
|
54
54
|
"zod": "^4.0.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|