parseapi-mcp 1.12.2 → 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 CHANGED
@@ -1,6 +1,6 @@
1
1
  # parseapi-mcp
2
2
 
3
- Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, timezones, dates and more from your AI agent.
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`, `bank_us_ach`, `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.
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` | `{}` |
@@ -100,7 +99,7 @@ Example tool arguments:
100
99
  | `elevation` | `{"points":"39.7392,-104.9903|39.75,-104.98"}` |
101
100
  | `elevation` | `{"path":"39.7392,-104.9903|39.75,-104.98","samples":100}` |
102
101
 
103
- Time uses `disambiguation` only for offsetless `at` with `to` or `targets`. The default `compatible` selects the earlier repeated time or advances a skipped time. `earlier` and `later` choose the respective instant. `reject` returns `ambiguous_time` for repeated times and `nonexistent_time` for skipped times. Prefer it for user-entered appointments. Ask for an explicit offset or the user's choice before retrying a rejected local time. Explicit offsets select an instant directly. Time deep is available in the same pooled request on every plan.
102
+ Time uses `disambiguation` only for offsetless `at` with `to` or `targets`. The default `compatible` selects the earlier repeated time or advances a skipped time. `earlier` and `later` choose the respective instant. `reject` returns `ambiguous_time` for repeated times and `nonexistent_time` for skipped times. Prefer it for user-entered appointments. Ask for an explicit offset or the user's choice before retrying a rejected local time. Explicit offsets select an instant directly. Time Deep is available on paid plans in the same pooled request. Existing accounts retain their current Deep access.
104
103
 
105
104
  Time Deep includes nullable `resolution`. Resolution reports `kind` (`unique`, `overlap` or `gap`), `policy`, signed `adjustment_seconds`, and chronological `alternatives` with exact local `at`, Unix seconds and UTC offset. Unique wall times have no alternatives. Explicit-offset timestamps, current clocks, non-conversion lookups and unknown source zones have null resolution.
106
105
 
@@ -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. 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`.
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 deep adds detail in the same
122
- pooled request on every plan and belongs to each company result.
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 existing `company`
127
- tool continues to parse national registration numbers.
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, Language, Emoji, Phone 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.
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
 
@@ -575,7 +575,7 @@ var agent_catalog_default = {
575
575
  },
576
576
  deep: {
577
577
  omitted: "Not requested",
578
- object: "Requested; optional detail is included on every plan"
578
+ object: "Requested; optional detail is included on paid plans or with retained Deep access. Locked requests return {}"
579
579
  },
580
580
  http_status: {
581
581
  "400": "Invalid input, or a repeated/nonexistent source wall time with disambiguation=reject. Supply an explicit UTC offset or choose earlier/later",
@@ -630,7 +630,7 @@ var agent_catalog_default = {
630
630
  app: "Allowed X-App-Id required"
631
631
  },
632
632
  deep: {
633
- entitlement: "Optional time detail on every plan"
633
+ entitlement: "Included on paid plans. Existing accounts retain their current Deep access"
634
634
  },
635
635
  effective_access: null,
636
636
  effective_access_status: "not_checked; key fences, account access and quotas still apply"
@@ -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; included on every plan. Six or more digits enable matching."
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 every plan"
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,
@@ -894,7 +894,7 @@ var agent_catalog_default = {
894
894
  app: "Allowed X-App-Id required"
895
895
  },
896
896
  deep: {
897
- entitlement: "Included reference detail on every plan"
897
+ entitlement: "Included on paid plans. Existing accounts retain their current Deep access"
898
898
  },
899
899
  effective_access_status: "Not checked; credential fences, account access and quotas still apply."
900
900
  },
@@ -968,7 +968,7 @@ var agent_catalog_default = {
968
968
  app: "Allowed X-App-Id required"
969
969
  },
970
970
  deep: {
971
- entitlement: "Included reference detail on every plan"
971
+ entitlement: "Included on paid plans. Existing accounts retain their current Deep access"
972
972
  },
973
973
  effective_access_status: "Not checked; credential fences, account access and quotas still apply."
974
974
  },
@@ -1041,7 +1041,7 @@ var agent_catalog_default = {
1041
1041
  app: "Allowed X-App-Id required"
1042
1042
  },
1043
1043
  deep: {
1044
- entitlement: "Included reference detail on every plan"
1044
+ entitlement: "Included on paid plans. Existing accounts retain their current Deep access"
1045
1045
  },
1046
1046
  effective_access_status: "Not checked; credential fences, account access and quotas still apply."
1047
1047
  },
@@ -1230,7 +1230,7 @@ var agent_catalog_default = {
1230
1230
  app: "Allowed X-App-Id required"
1231
1231
  },
1232
1232
  deep: {
1233
- entitlement: "Included reference detail on every plan"
1233
+ entitlement: "Included on paid plans. Existing accounts retain their current Deep access"
1234
1234
  },
1235
1235
  effective_access_status: "Not checked; credential fences, account access and quotas still apply."
1236
1236
  },
@@ -1303,7 +1303,7 @@ var agent_catalog_default = {
1303
1303
  app: "Allowed X-App-Id required"
1304
1304
  },
1305
1305
  deep: {
1306
- entitlement: "Included reference detail on every plan"
1306
+ entitlement: "Included on paid plans. Existing accounts retain their current Deep access"
1307
1307
  },
1308
1308
  effective_access_status: "Not checked; credential fences, account access and quotas still apply."
1309
1309
  },
@@ -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.2",
2252
+ version: "1.12.4",
2253
2253
  mcpName: "com.parseapi/mcp",
2254
- description: "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
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",
@@ -2391,7 +2391,7 @@ var emojiFilters = {
2391
2391
  max_version: z5.string().optional().describe("Latest Emoji release to include, such as 16.0."),
2392
2392
  include_skin_tones: z5.boolean().optional().describe("Include skin-tone variants. Explicit false excludes them."),
2393
2393
  offset: z5.number().int().min(0).max(1e5).optional().describe("Page offset. Reuse next_offset with the same filters."),
2394
- deep: deep.describe("Include optional reference detail on every plan.")
2394
+ deep: deep.describe("Include optional detail when supported; access follows this operation's plan or included-unit rules.")
2395
2395
  };
2396
2396
  function buildServer(key, transport, options = {}) {
2397
2397
  const mode = options.mode ?? "full";
@@ -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, company numbers, email, phone, domains, weather, timezones, dates and holidays. Real reference data instead of guessing.",
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
- "Parse a company number and its registered identity, status and address. Paid deep adds business activity and associated identifiers. Geography lookups are separate calls.",
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,
@@ -2751,7 +2751,7 @@ function buildServer(key, transport, options = {}) {
2751
2751
  );
2752
2752
  tool(
2753
2753
  "point",
2754
- "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.",
2754
+ "Locate coordinates in their country, state, district and actual IANA timezone. Deep adds terrain and a compact nearest-city summary with its ID and distance on paid plans; existing accounts retain their current Deep access. The timezone ID stays in core. Nearest city is null when none is within 200 km.",
2755
2755
  { lat, lon, deep },
2756
2756
  (c, a, request) => c.point(a.lat, a.lon, { ...request, deep: a.deep })
2757
2757
  );
@@ -2807,16 +2807,16 @@ 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 deep adds the longest recorded prefix, issuer, country, funding type and nullable prepaid status. 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. One pooled request on every plan, including deep.",
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, pooled on every plan. Omitted by default; fewer than six digits returns all-null Deep fields.")
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
  );
2817
2817
  tool(
2818
2818
  "phone",
2819
- "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.",
2819
+ "Parse and validate a phone number with national and international display formats. Deep adds numbering-plan state and timezone on paid plans; existing accounts retain their current Deep access. These do not locate a handset.",
2820
2820
  {
2821
2821
  number: z5.string().describe("Phone number, e.g. +14155552671"),
2822
2822
  country: iso2("country code for national-format numbers").optional(),
@@ -2826,7 +2826,7 @@ function buildServer(key, transport, options = {}) {
2826
2826
  );
2827
2827
  tool(
2828
2828
  "carrier",
2829
- "Look up current carrier, real line type and burner flag. Deep adds issuing city and state in the same metered lookup, including Free allowance units. No extra check or second paid gate.",
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(),
@@ -2927,7 +2927,7 @@ function buildServer(key, transport, options = {}) {
2927
2927
  tool(
2928
2928
  "language",
2929
2929
  "Language names, script, writing direction, iso_alpha3 identifier and country associations.",
2930
- { code: z5.string().describe("Language code, e.g. en, ja, gsw"), deep: deep.describe("Include optional detail on every plan.") },
2930
+ { code: z5.string().describe("Language code, e.g. en, ja, gsw"), deep: deep.describe("All language facts are in Core. Requested Deep is empty.") },
2931
2931
  (c, a, request) => c.language(a.code, { ...request, deep: a.deep })
2932
2932
  );
2933
2933
  tool(
@@ -2943,7 +2943,7 @@ function buildServer(key, transport, options = {}) {
2943
2943
  );
2944
2944
  tool(
2945
2945
  "time",
2946
- "Current local time, Unix seconds, exact offset and DST. Use an IANA zone, both coordinates, or one explicit IP, city, country, airport, port or address selector. Omit all for UTC. Ambiguous or missing locations return null clock fields with location candidates; never choose a candidate for the user. to or targets converts one instant. Deep adds wall-time resolution, standard/seasonal offsets and actual DST-season transitions on every plan.",
2946
+ "Current local time, Unix seconds, exact offset and DST. Use an IANA zone, both coordinates, or one explicit IP, city, country, airport, port or address selector. Omit all for UTC. Ambiguous or missing locations return null clock fields with location candidates; never choose a candidate for the user. to or targets converts one instant. Deep adds wall-time resolution, standard/seasonal offsets and actual DST-season transitions on paid plans; existing accounts retain their current Deep access.",
2947
2947
  {
2948
2948
  timezone: z5.string().min(1).refine((zone) => !["zones", "help"].includes(zone.trim().toLowerCase()), { message: "Time source must be an IANA timezone ID. Use time_zones to list IDs." }).optional().describe("IANA timezone, e.g. America/New_York. Omit for UTC when all source selectors are absent"),
2949
2949
  lat: lat.optional(),
@@ -2960,7 +2960,7 @@ function buildServer(key, transport, options = {}) {
2960
2960
  disambiguation: z5.enum(["compatible", "earlier", "later", "reject"]).optional().describe("For offsetless at with to or targets at a clock change. Default compatible chooses the earlier repeated time or advances a skipped time. earlier and later choose the respective instant. For user-entered appointments prefer reject: repeated times return ambiguous_time and skipped times nonexistent_time. Ask for an explicit offset or earlier/later choice. Deep resolution explains a successful choice. Explicit offsets select the instant directly."),
2961
2961
  targets: z5.array(z5.string().trim().min(1).max(64).refine((zone) => !zone.includes(","), { message: "Pass one timezone ID per target." })).min(1).max(10).optional().describe("Destination IANA IDs, preserving order and duplicates. Use instead of to. All targets share one instant. An unresolved or ambiguous source returns targets null."),
2962
2962
  to: z5.string().min(1).optional().describe("Destination IANA timezone, e.g. Asia/Tokyo. Returns to.at and to.unix at the same instant"),
2963
- deep: deep.describe("Include optional detail on every plan.")
2963
+ deep: deep.describe("Include optional detail on paid plans; existing accounts retain their current Deep access. Requested but locked Deep is empty.")
2964
2964
  },
2965
2965
  (c, a, request) => a.lat !== void 0 && a.lon !== void 0 ? c.time.at(a.lat, a.lon, { ...request, deep: a.deep, at: a.at, to: a.to, targets: a.targets, disambiguation: a.disambiguation }) : c.time(a.timezone, { ...request, ip: a.ip, city: a.city, country: a.country, state: a.state, iata: a.iata, icao: a.icao, unlocode: a.unlocode, address: a.address, deep: a.deep, at: a.at, to: a.to, targets: a.targets, disambiguation: a.disambiguation }),
2966
2966
  (schema) => schema.refine(
@@ -3016,12 +3016,12 @@ function buildServer(key, transport, options = {}) {
3016
3016
  );
3017
3017
  tool(
3018
3018
  "date",
3019
- "Parse a date to ISO date, validity and Unix midnight. Ambiguous numeric dates need format. to adds signed days between; omit date for UTC today. Deep adds calendar details on every plan.",
3019
+ "Parse a date to ISO date, validity and Unix midnight. Ambiguous numeric dates need format. to adds signed days between; omit date for UTC today. Deep adds calendar details on paid plans; existing accounts retain their current Deep access.",
3020
3020
  {
3021
3021
  date: z5.string().min(1).optional().describe("The date as you have it, any common format. Omit for today (UTC)"),
3022
3022
  format: z5.enum(["mdy", "dmy"]).optional().describe("Breaks the month-first / day-first tie on numeric dates like 03/04/2026"),
3023
3023
  to: z5.string().optional().describe("Another date. Appends to (normalized ISO) and days (signed days between)"),
3024
- deep: deep.describe("Include optional detail on every plan.")
3024
+ deep: deep.describe("Include optional detail on paid plans; existing accounts retain their current Deep access. Requested but locked Deep is empty.")
3025
3025
  },
3026
3026
  (c, a, request) => {
3027
3027
  if (a.date == null) return c.date.today({ ...request, deep: a.deep, to: a.to });
@@ -3049,8 +3049,8 @@ function buildServer(key, transport, options = {}) {
3049
3049
  );
3050
3050
  tool(
3051
3051
  "emoji",
3052
- 'Resolve an emoji character, shortcode, name or codepoint sequence. Deep adds encoding, keywords, tone relationships and artwork on every plan. Artwork is keyed by style: deep.artwork.openmoji.svg and deep.artwork.openmoji.png["72"].',
3053
- { emoji: z5.string().describe("Emoji input, e.g. rocket, :rocket:, \u{1F680} or U+1F680"), shortcode_source: z5.enum(["cldr", "github", "slack", "discord"]).optional().describe("Resolve the shortcode within this source."), deep: deep.describe("Include optional detail on every plan.") },
3052
+ 'Resolve an emoji character, shortcode, name or codepoint sequence. Deep adds encoding, keywords, tone relationships and artwork on paid plans; existing accounts retain their current Deep access. Artwork is keyed by style: deep.artwork.openmoji.svg and deep.artwork.openmoji.png["72"].',
3053
+ { emoji: z5.string().describe("Emoji input, e.g. rocket, :rocket:, \u{1F680} or U+1F680"), shortcode_source: z5.enum(["cldr", "github", "slack", "discord"]).optional().describe("Resolve the shortcode within this source."), deep: deep.describe("Include optional detail on paid plans; existing accounts retain their current Deep access. Requested but locked Deep is empty.") },
3054
3054
  (c, a, request) => c.emoji(a.emoji, { ...request, deep: a.deep, shortcodeSource: a.shortcode_source })
3055
3055
  );
3056
3056
  tool(
package/dist/http.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-LZYA45MG.js";
5
+ } from "./chunk-CPJ3VR6E.js";
6
6
 
7
7
  // src/http.ts
8
8
  import { createServer } from "http";
package/dist/registry.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  VERSION,
4
4
  buildServer
5
- } from "./chunk-LZYA45MG.js";
5
+ } from "./chunk-CPJ3VR6E.js";
6
6
  export {
7
7
  VERSION,
8
8
  buildServer
package/dist/stdio.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-LZYA45MG.js";
5
+ } from "./chunk-CPJ3VR6E.js";
6
6
 
7
7
  // src/stdio.ts
8
8
  import { serveStdio } from "@modelcontextprotocol/server/stdio";
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "parseapi-mcp",
3
- "version": "1.12.2",
3
+ "version": "1.12.4",
4
4
  "mcpName": "com.parseapi/mcp",
5
- "description": "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
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",