parseapi-mcp 1.12.3 → 1.12.4
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 +9 -15
- package/dist/{chunk-W5DHLSD3.js → chunk-CPJ3VR6E.js} +9 -9
- 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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# parseapi-mcp
|
|
2
2
|
|
|
3
|
-
Official ParseAPI MCP server. Look up places, addresses,
|
|
3
|
+
Official ParseAPI MCP server. Look up places, addresses, companies, email, phone, weather, timezones, dates and more from your AI agent.
|
|
4
4
|
|
|
5
5
|
## Hosted
|
|
6
6
|
|
|
@@ -66,7 +66,7 @@ spellings. Use the existing lookup methods for each resource.
|
|
|
66
66
|
|
|
67
67
|
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.
|
|
68
68
|
|
|
69
|
-
Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `company_id`, `company_search`, `company_coverage`, `email`, `
|
|
69
|
+
Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `company_id`, `company_search`, `company_coverage`, `email`, `card`, `industry`, `industry_search`, `dns`, `asn`, `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.
|
|
70
70
|
|
|
71
71
|
The existing `naics` and `naics_search` tools remain available as compatibility names for Industry.
|
|
72
72
|
|
|
@@ -85,7 +85,6 @@ Example tool arguments:
|
|
|
85
85
|
| `card` | `{"bin":"424242"}` |
|
|
86
86
|
| `country_states` | `{"code":"US"}` |
|
|
87
87
|
| `address_search` | `{"query":"1600 Pennsylvania","country":"US","city":"Washington","state":"DC"}` |
|
|
88
|
-
| `company` | `{"number":"552100554","country":"FR"}` |
|
|
89
88
|
| `company_search` | `{"query":"Cloudflare","country":"US"}` |
|
|
90
89
|
| `company_id` | `{"id":"co_xw3f22es6cjq","deep":true}` |
|
|
91
90
|
| `company_coverage` | `{}` |
|
|
@@ -112,25 +111,24 @@ Each local batch is limited to 25 km between any two coordinates and 12 distinct
|
|
|
112
111
|
|
|
113
112
|
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).
|
|
114
113
|
|
|
115
|
-
Address lookup returns standardized components and registration status for the US and France. Its `deep` object is currently empty.
|
|
114
|
+
Address lookup returns standardized components and registration status for the US and France. Its `deep` object is currently empty. `address_search` also accepts `postal` and `ip` to narrow or rank matches. French search needs `country: "FR"` and either `postal` or `city`.
|
|
116
115
|
|
|
117
116
|
For the company directory, call `company_search` with at most one of `query`,
|
|
118
117
|
`domain`, `ticker` or `identifier`. Use `exchange` with a ticker and `authority`
|
|
119
118
|
with an identifier. Review the candidates, then pass the chosen `id` to
|
|
120
119
|
`company_id`. Send the returned `next` as `cursor` with the same selector,
|
|
121
|
-
filters and `limit` for another page. Directory
|
|
122
|
-
pooled request
|
|
120
|
+
filters and `limit` for another page. Directory Deep adds detail to each company result on paid plans in the same
|
|
121
|
+
pooled request. Existing accounts retain their current Deep access.
|
|
123
122
|
Selected website descriptions, logos, socials and founding claims are returned
|
|
124
123
|
where available. Logo URLs are returned without fetching images. Directory
|
|
125
124
|
tools do not accept `lang`. `company_coverage` describes the edition's records,
|
|
126
|
-
and empty listings do not establish private ownership. The
|
|
127
|
-
|
|
125
|
+
and empty listings do not establish private ownership. The `company` tool
|
|
126
|
+
remains listed for compatibility, but national-number lookups are retired on
|
|
127
|
+
the public API. Use `company_search` and `company_id` for maintained public-company records.
|
|
128
128
|
|
|
129
129
|
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 }`.
|
|
130
130
|
|
|
131
131
|
|
|
132
|
-
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.
|
|
133
|
-
|
|
134
132
|
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.
|
|
135
133
|
|
|
136
134
|
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`.
|
|
@@ -236,7 +234,7 @@ MIT licensed.
|
|
|
236
234
|
|
|
237
235
|
Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym, `iso_alpha3` and `iso_numeric` country identifiers, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, latitude, longitude }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
|
|
238
236
|
|
|
239
|
-
Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date,
|
|
237
|
+
Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date, Emoji, Phone, Point and Card offer optional detail on paid plans; existing accounts retain their current Deep access. Language includes every reference fact in Core, and requested Deep is empty. 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.
|
|
240
238
|
|
|
241
239
|
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.
|
|
242
240
|
|
|
@@ -264,10 +262,6 @@ Time `targets` accepts 1-10 destination IDs instead of `to`. Results retain the
|
|
|
264
262
|
`time_zones` can filter by country, IANA area, exact offset, abbreviation, DST at an instant or DST occurrence during the UTC calendar year. It preserves explicit false filters. `details` adds rich rows and the common evaluation instant, while the default identifier list remains compact. Abbreviations return candidate zones. Source deep exposes standard and signed seasonal offsets plus actual DST-season transition boundaries. Negative seasonal adjustments and null boundaries retain their meaning.
|
|
265
263
|
|
|
266
264
|
|
|
267
|
-
Bank tools send original IBAN, routing and account strings in POST JSON bodies, keeping account input out of URLs. `bank` retains optional country and deep controls. Deep directory evidence identifies the immutable source edition and actual match grain when a directory lookup ran; it does not prove country completeness or reachability. `bank_us_ach` takes routing/account strings and checks the ABA routing checksum plus account-field syntax. It has no deep option and cannot verify an account checksum, existence, ownership or ACH eligibility. Preserve all account characters and leading zeros. `bank_requirements` takes a country and optional format (`iban` by default, or `us_ach`) and returns accepted fields, check scope and limitations. Requirements are metadata, not bank coverage. Avoid logging tool arguments or request bodies containing banking input.
|
|
268
|
-
|
|
269
|
-
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.
|
|
270
|
-
|
|
271
265
|
|
|
272
266
|
## Emoji catalog additions
|
|
273
267
|
|
|
@@ -685,7 +685,7 @@ var agent_catalog_default = {
|
|
|
685
685
|
deep: {
|
|
686
686
|
type: "boolean",
|
|
687
687
|
default: false,
|
|
688
|
-
description: "Optional recorded issuer details;
|
|
688
|
+
description: "Optional recorded issuer details on paid plans; existing accounts retain their current Deep access. Six or more digits enable matching."
|
|
689
689
|
}
|
|
690
690
|
}
|
|
691
691
|
},
|
|
@@ -731,7 +731,7 @@ var agent_catalog_default = {
|
|
|
731
731
|
metered: null,
|
|
732
732
|
monetary_quote: null,
|
|
733
733
|
account_state: "unknown; pooled allowance and accepted account terms are not checked",
|
|
734
|
-
deep: "Included in the same pooled request on
|
|
734
|
+
deep: "Included in the same pooled request on paid plans. Existing accounts retain their current Deep access"
|
|
735
735
|
},
|
|
736
736
|
access: {
|
|
737
737
|
api_key_required: true,
|
|
@@ -2249,9 +2249,9 @@ function registerBulk(server, key, transport) {
|
|
|
2249
2249
|
// package.json
|
|
2250
2250
|
var package_default = {
|
|
2251
2251
|
name: "parseapi-mcp",
|
|
2252
|
-
version: "1.12.
|
|
2252
|
+
version: "1.12.4",
|
|
2253
2253
|
mcpName: "com.parseapi/mcp",
|
|
2254
|
-
description: "Official ParseAPI MCP server. Look up places, addresses,
|
|
2254
|
+
description: "Official ParseAPI MCP server. Look up places, addresses, companies, email, phone, weather, dates and more.",
|
|
2255
2255
|
keywords: [
|
|
2256
2256
|
"parseapi",
|
|
2257
2257
|
"mcp",
|
|
@@ -2402,7 +2402,7 @@ function buildServer(key, transport, options = {}) {
|
|
|
2402
2402
|
name: "parseapi",
|
|
2403
2403
|
version: VERSION,
|
|
2404
2404
|
title: "ParseAPI",
|
|
2405
|
-
description: "Lookups for agents: IP and place data, addresses,
|
|
2405
|
+
description: "Lookups for agents: IP and place data, addresses, companies, email, phone, domains, weather, timezones, dates and holidays. Real reference data instead of guessing.",
|
|
2406
2406
|
websiteUrl: "https://parseapi.com"
|
|
2407
2407
|
},
|
|
2408
2408
|
{ capabilities: { tools: {} } }
|
|
@@ -2706,7 +2706,7 @@ function buildServer(key, transport, options = {}) {
|
|
|
2706
2706
|
);
|
|
2707
2707
|
tool(
|
|
2708
2708
|
"company",
|
|
2709
|
-
"
|
|
2709
|
+
"Compatibility national Company-number lookup. This operation is retired on the public API in both contracts. Use company_search and company_id for maintained public-company records. Existing inputs and compatibility methods are preserved.",
|
|
2710
2710
|
{
|
|
2711
2711
|
number: z5.string().describe("Company registration number, e.g. 552100554 with country FR"),
|
|
2712
2712
|
country: countryOpt,
|
|
@@ -2807,10 +2807,10 @@ function buildServer(key, transport, options = {}) {
|
|
|
2807
2807
|
);
|
|
2808
2808
|
tool(
|
|
2809
2809
|
"card",
|
|
2810
|
-
"Identify a network and its CDN SVG logo from 2-11 leading digits, including processor-provided BIN/IIN prefixes. Unknown or ambiguous networks return null brand and a generic logo. Optional
|
|
2810
|
+
"Identify a network and its CDN SVG logo from 2-11 leading digits, including processor-provided BIN/IIN prefixes. Unknown or ambiguous networks return null brand and a generic logo. Optional Deep on paid plans adds the longest recorded prefix, issuer, country, funding type and nullable prepaid status; existing accounts retain their current Deep access. Core identity is independent of issuer coverage. A shorter deep.prefix is broader coverage; missing fields never inherit from a parent row. Partial reference data does not prove card validity, account existence or payment acceptance. Core uses one pooled request on every plan. Optional Deep follows paid-plan or retained-access rules in that same request.",
|
|
2811
2811
|
{
|
|
2812
2812
|
bin: z5.string().max(64, "Send a prefix only: 2-11 digits.").regex(/^[ \t\r\n-]*(?:[0-9][ \t\r\n-]*){2,11}$/, "Send a prefix only: 2-11 digits.").describe("Processor-provided leading digits as a string, 2-11 ASCII digits. Preserve zeros. Only ASCII space, tab, CR, LF and hyphen separators; at most 64 raw characters. Never send a full card number. Six or more digits enable issuer lookup."),
|
|
2813
|
-
deep: deep.describe("Include recorded issuer details
|
|
2813
|
+
deep: deep.describe("Include recorded issuer details on paid plans in the same pooled request; existing accounts retain their current Deep access. Omitted by default; locked Deep is empty. With access, fewer than six digits returns all-null Deep fields.")
|
|
2814
2814
|
},
|
|
2815
2815
|
(c, a, request) => c.card(a.bin, { ...request, deep: a.deep })
|
|
2816
2816
|
);
|
|
@@ -2826,7 +2826,7 @@ function buildServer(key, transport, options = {}) {
|
|
|
2826
2826
|
);
|
|
2827
2827
|
tool(
|
|
2828
2828
|
"carrier",
|
|
2829
|
-
"Look up current carrier,
|
|
2829
|
+
"Look up current carrier, line type and burner flag. Type uses the provider observation when mapped; otherwise it retains the numbering-plan type. Deep adds issuing city and state in the same metered lookup, including Free allowance units. No extra check or second paid gate.",
|
|
2830
2830
|
{
|
|
2831
2831
|
number: z5.string().describe("Phone number, e.g. +14155552671"),
|
|
2832
2832
|
country: iso2("country code for national-format numbers").optional(),
|
package/dist/http.js
CHANGED
package/dist/registry.js
CHANGED
package/dist/stdio.js
CHANGED
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "parseapi-mcp",
|
|
3
|
-
"version": "1.12.
|
|
3
|
+
"version": "1.12.4",
|
|
4
4
|
"mcpName": "com.parseapi/mcp",
|
|
5
|
-
"description": "Official ParseAPI MCP server. Look up places, addresses,
|
|
5
|
+
"description": "Official ParseAPI MCP server. Look up places, addresses, companies, email, phone, weather, dates and more.",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"parseapi",
|
|
8
8
|
"mcp",
|