parseapi-mcp 1.5.0 → 1.7.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 CHANGED
@@ -55,11 +55,13 @@ 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 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.
58
+ Full mode provides 64 local lookup tools and 63 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`, `iban`, `bin`, `npi`, `vin`, `naics`, `naics_search`, `tariff`, `dns`, `asn`, `mac`, `currency_rate`, and the rest. All search tools take `query`.
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. All search tools take `query`.
61
61
 
62
- NAICS paid deep records include classification `deep.exclusions`, each with a description and linked codes. Generic exclusions can have no linked codes. Omitted or null exclusions in older responses remain unknown. Search results also include `match`: the matched `field` (`name`, `term` or `naics`) and `text`, plus `corrections` with `from` and `to` tokens for typo fallback. Corrections are empty for exact, plural and prefix matches. Direct code lookups omit `match`. Older responses may omit it.
62
+ The existing `naics` and `naics_search` tools remain available as compatibility names for Industry.
63
+
64
+ Industry paid deep records include classification `deep.exclusions`, each with a description and linked codes. Generic exclusions can have no linked codes. Omitted or null exclusions in older responses remain unknown. Search results also include `match`: the matched `field` (`name`, `term` or `naics`) and `text`, plus `corrections` with `from` and `to` tokens for typo fallback. Corrections are empty for exact, plural and prefix matches. Direct code lookups omit `match`. Older responses may omit it.
63
65
 
64
66
  Example tool arguments:
65
67
 
@@ -72,28 +74,47 @@ Example tool arguments:
72
74
  | `mx` | `{"domain":"example.com"}` |
73
75
  | `asn` | `{"asn":"AS13335"}` |
74
76
  | `mac` | `{"mac":"00:1B:63:84:45:E6"}` |
75
- | `bin` | `{"bin":"424242"}` |
77
+ | `card` | `{"bin":"424242"}` |
78
+ | `provider` | `{"npi":"1881018208"}` (provider directory record) |
79
+ | `provider` | `{"npi":"1881018208","deep":true}` (stored Medicare and deactivation detail on paid plans) |
76
80
  | `country_states` | `{"code":"US"}` |
77
81
  | `address_search` | `{"query":"1600 Pennsylvania","country":"US","city":"Washington","state":"DC"}` |
78
82
  | `company` | `{"number":"552100554","country":"FR"}` |
79
83
  | `time` | `{}` (UTC now) |
80
84
  | `time` | `{"timezone":"America/New_York","at":"2026-09-05T09:00:00","to":"Asia/Tokyo"}` |
81
85
  | `time` | `{"lat":40.71,"lon":-74.01}` |
86
+ | `time` | `{"timezone":"UTC","targets":["America/New_York","Asia/Tokyo"]}` |
87
+ | `time_zones` | `{"query":"New York"}` |
88
+ | `time` | `{"timezone":"America/New_York","at":"2026-11-01T01:30:00","to":"UTC","disambiguation":"later"}` |
82
89
  | `date` | `{"date":"03/04/2026","format":"dmy"}` |
83
90
  | `elevation` | `{"lat":35.2271,"lon":-80.8431}` |
84
91
  | `elevation` | `{"points":"35.2271,-80.8431|40.7128,-74.006"}` |
85
92
  | `elevation` | `{"path":"35.2271,-80.8431|35.5951,-82.5515","samples":100}` |
86
93
 
94
+ 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.
95
+
96
+ Canonical Time source deep includes `timezone_database_version` and 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.
97
+
87
98
  Elevation accepts exactly one of `lat` and `lon`, `points`, or `path` with `samples`. A point list supports up to 512 coordinates as `lat,lon` pairs separated by `|`, or `enc:` followed by a Google encoded polyline, with at most 12000 characters. The `points` response array preserves input order and duplicate coordinates. Each sample includes meters, feet and grid resolution in meters. Unknown samples stay null. A list uses one pooled request, with JSON POST selected automatically for long URLs.
88
99
 
89
100
  A path uses the same string formats with 2-512 vertices and a required integer `samples` count from 2 to 512. The response `points` include both endpoints, spaced uniformly by cumulative great-circle distance along the path. Each segment follows the shortest arc. A segment with antipodal endpoints is rejected because it does not define a unique arc. A path uses one pooled request. `samples` is invalid with a single coordinate or a point list.
90
101
 
91
102
  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).
92
103
 
104
+ 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).
105
+
93
106
  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`.
94
107
 
95
108
 
96
- Ordinary lookups retry up to twice after a transient failure. Metered lookups and address deep checks default to no retries. Cancelling a tool call cancels the pending SDK request.
109
+ Card takes a processor-provided BIN/IIN prefix, with 6–11 ASCII digits. Leading zeros are preserved. ASCII spaces, tabs, line breaks and hyphens are accepted within a 64-character input limit. Full numbers and malformed prefixes are rejected before an API request; input is never truncated. The complete lookup is returned without a deep option.
110
+
111
+ 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
+
113
+ Invalid input returns `valid: false` with unknown provider fields. A checksum-valid number missing from the snapshot returns `registered: false`; unavailable storage remains an API error. Preserve `null` as unknown.
114
+
115
+ The default pooled lookup includes provider identity, specialty and practice contact where held. Paid `deep` adds `deactivated_at`, `medicare`, `opt_out` and `enrollments` from stored source files, with no separate check meter or live verification. `enrollments: null` means unavailable; `[]` means no enrollment rows are returned. The API omits unrequested `deep` and returns `{}` when requested on Free.
116
+
117
+ 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.
97
118
 
98
119
  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`.
99
120
 
@@ -105,7 +126,7 @@ Ask `discover` what an operation can determine before making a lookup:
105
126
  { "operation": "email" }
106
127
  ```
107
128
 
108
- The result includes the actual input schema and reviewed policies for capabilities, freshness, uncertainty, billing units, credential types and retries. Both JSON text and MCP `structuredContent` carry the same result. Email, Domain, DNS, MX and Country have reviewed policies. Other operations return their input schema with `policy: null`. Field meanings are specific to each operation. An unknown result is not automatically a reason to retry.
129
+ The result includes the actual input schema and reviewed policies for capabilities, freshness, uncertainty, billing units, credential types and retries. Both JSON text and MCP `structuredContent` carry the same result. Email, Domain, DNS, MX, Country, Time and timezone discovery have reviewed policies. Other operations return their input schema with `policy: null`. Field meanings are specific to each operation. An unknown result is not automatically a reason to retry.
109
130
 
110
131
  Use `{ "query": "mailbox" }` to find operations. Search returns up to five summaries by default. `detail: "full"` includes schemas and policies. Use `limit` and the returned `next_offset` to page through results. Metadata calls make no API requests and consume no lookup units. Hosted HTTP still requires its existing authentication before discovery.
111
132
 
@@ -127,7 +148,7 @@ The estimate allows up to three attempts per ordinary lookup and one per Email D
127
148
  For a compact tool catalog, set `PARSEAPI_MCP_MODE=compact` on the MCP process:
128
149
 
129
150
  ```bash
130
- PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@1.5.0
151
+ PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@1.6.0
131
152
  ```
132
153
 
133
154
  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:
@@ -176,9 +197,11 @@ The [agent benchmark](eval/README.md) compares full and compact discovery on fix
176
197
  MIT licensed.
177
198
 
178
199
 
200
+ Bank returns core `checks` for input, country, length, structure, checksum and national rules, plus an `issues` list. States are `passed`, `failed`, `not_checked` or `not_supported`. Unsupported national checking is not a failure. `valid` covers the implemented format and checksum rules, not account existence, ownership or payment reachability. Directory names and BICs may be null independently. Older responses may omit `checks` and `issues`, and future states and issue codes remain strings. Pass the original input unchanged so the API can report invalid characters. Deep `account` remains the BBAN remainder.
201
+
179
202
  ## Optional detail
180
203
 
181
- 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.
204
+ Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date, Currency, Language, Emoji, Phone, Bank 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.
182
205
 
183
206
  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.
184
207
 
@@ -197,3 +220,17 @@ Pass a public hostname without a scheme, path, port or IP address. Stack returns
197
220
  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.
198
221
 
199
222
  The `stack` tool allows 35 seconds per attempt for a first check. MCP cancellation still aborts the request.
223
+
224
+
225
+ Time `targets` accepts 1-10 destination IDs instead of `to`. Results retain the requested order and duplicates at one instant in a single pooled request. Unknown source coordinates return `targets: null`. Unknown destination IDs return `not_found` for the whole request. Use `time_zones` to search serving IDs or omit its query for the complete sorted list and pinned rule edition. An empty search result is `timezones: []`.
226
+
227
+ `time` accepts one explicit IP, city, country, IATA airport, ICAO airport, port UN/LOCODE or address input. Country/state may narrow city or address. Address point lookup currently requires US country context. Port reference coverage is a reviewed subset of UN/LOCODE. Hosted calls never infer the user's IP from the server. Ambiguous or missing inputs return null clock fields and `location` candidates. Ask for the missing context or let the user choose rather than selecting a candidate silently.
228
+
229
+ `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.
230
+
231
+
232
+ 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.
233
+
234
+ 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.
235
+
236
+ Vehicle lookups use `vin` as the input and response field. The `vin` tool remains available for compatibility.
@@ -10,15 +10,21 @@ import { ParseAPIError } from "@parseapi/sdk";
10
10
  function ok(data) {
11
11
  return { content: [{ type: "text", text: JSON.stringify(data) }] };
12
12
  }
13
- function errorJson(code, message, docs, requestId) {
13
+ function errorJson(code, message, docs, requestId, retryAfter) {
14
14
  return {
15
15
  isError: true,
16
- content: [{ type: "text", text: JSON.stringify({ code, message, docs, request_id: requestId }) }]
16
+ content: [{ type: "text", text: JSON.stringify({
17
+ code,
18
+ message,
19
+ docs,
20
+ request_id: requestId,
21
+ ...retryAfter == null ? {} : { retry_after: retryAfter }
22
+ }) }]
17
23
  };
18
24
  }
19
25
  function toErrorResult(err) {
20
26
  if (err instanceof ParseAPIError) {
21
- return errorJson(err.code, err.message, err.docs, err.requestId);
27
+ return errorJson(err.code, err.message, err.docs, err.requestId, err.retryAfter);
22
28
  }
23
29
  const message = err instanceof Error ? err.message : String(err);
24
30
  return errorJson("network_error", message, null, null);
@@ -44,13 +50,34 @@ var agent_catalog_default = {
44
50
  email: {
45
51
  operation: "email",
46
52
  endpoint: "GET /email/{email}",
47
- determines: ["Email syntax and domain mail routing", "Consumer, disposable and role-address classifications", "With deep=true, a mailbox deliverability observation"],
48
- does_not_determine: ["Recipient identity, consent or ownership", "Guaranteed delivery to an inbox", "A new mailbox probe on every request"],
49
- required_context: ["email: a complete email address", "deep=true only when a mailbox check is needed"],
53
+ determines: [
54
+ "Email syntax and domain mail routing",
55
+ "Consumer, disposable and role-address classifications",
56
+ "With deep=true, a mailbox deliverability observation"
57
+ ],
58
+ does_not_determine: [
59
+ "Recipient identity, consent or ownership",
60
+ "Guaranteed delivery to an inbox",
61
+ "A new mailbox probe on every request"
62
+ ],
63
+ required_context: [
64
+ "email: a complete email address",
65
+ "deep=true only when a mailbox check is needed"
66
+ ],
50
67
  freshness: {
51
68
  mode: "observation_reuse",
52
- mail_routing: { mode: "dns_ttl", positive_cache_max_seconds: 3600, negative_cache_max_seconds: 300, shorter_dns_ttl_wins: true, stale_if_error: false },
53
- mailbox_corpus_reuse_max_seconds: { deliverable: 604800, catchall: 2592e3, undeliverable: 7776e3 },
69
+ mail_routing: {
70
+ mode: "dns_ttl",
71
+ positive_cache_max_seconds: 3600,
72
+ negative_cache_max_seconds: 300,
73
+ shorter_dns_ttl_wins: true,
74
+ stale_if_error: false
75
+ },
76
+ mailbox_corpus_reuse_max_seconds: {
77
+ deliverable: 604800,
78
+ catchall: 2592e3,
79
+ undeliverable: 7776e3
80
+ },
54
81
  mailbox_response_cache_ttl_seconds: 86400,
55
82
  mailbox_local_cache_ttl_seconds: 3600,
56
83
  effective_max_age_seconds: null,
@@ -59,24 +86,63 @@ var agent_catalog_default = {
59
86
  actual_age_status: "not_exposed"
60
87
  },
61
88
  uncertainty: {
62
- valid: { true: "Syntax is valid; this does not establish mailbox existence", false: "Syntax is invalid" },
63
- domain_valid: { true: "MX or permitted A/AAAA fallback supplies a mail route", false: "When valid=true, no usable mail route, including an explicit null MX. When valid=false, routing was not checked" },
64
- domain_type: { null: "No supported reserved namespace classification" },
65
- "deep.deliverable": { true: "Mailbox likely exists", false: "Negative verification, eligible local disposable/no-route rejection, or invalid syntax that skipped verification; check valid first", null: "Mailbox check did not complete; no verification unit is charged" },
66
- "deep.catchall": { true: "Domain accepts all addresses; an individual mailbox is not established", false: "Not classified as catchall, including invalid input and local rejection where no mailbox probe ran", null: "Mailbox check did not complete" },
67
- deep: { omitted: "Not requested", empty_object: "Requested with an app key; mailbox verification is locked" }
89
+ valid: {
90
+ true: "Syntax is valid; this does not establish mailbox existence",
91
+ false: "Syntax is invalid"
92
+ },
93
+ domain_valid: {
94
+ true: "MX or permitted A/AAAA fallback supplies a mail route",
95
+ false: "When valid=true, no usable mail route, including an explicit null MX. When valid=false, routing was not checked"
96
+ },
97
+ domain_type: {
98
+ null: "No supported reserved namespace classification"
99
+ },
100
+ "deep.deliverable": {
101
+ true: "Mailbox likely exists",
102
+ false: "Negative verification, eligible local disposable/no-route rejection, or invalid syntax that skipped verification; check valid first",
103
+ null: "Mailbox check did not complete; no verification unit is charged"
104
+ },
105
+ "deep.catchall": {
106
+ true: "Domain accepts all addresses; an individual mailbox is not established",
107
+ false: "Not classified as catchall, including invalid input and local rejection where no mailbox probe ran",
108
+ null: "Mailbox check did not complete"
109
+ },
110
+ deep: {
111
+ omitted: "Not requested",
112
+ empty_object: "Requested with an app key; mailbox verification is locked"
113
+ }
68
114
  },
69
115
  billing: {
70
116
  pooled_requests_per_success: 1,
71
- metered: { name: "email", when: "deep=true and a valid-syntax eligible check completes", units_per_completed_check: 1, cache_hits_bill_units: true, incomplete_check_units: 0, eligible_local_negative_check_units: 1, invalid_syntax_check_units: 0, locked_deep_check_units: 0 },
117
+ metered: {
118
+ name: "email",
119
+ when: "deep=true and a valid-syntax eligible check completes",
120
+ units_per_completed_check: 1,
121
+ cache_hits_bill_units: true,
122
+ incomplete_check_units: 0,
123
+ eligible_local_negative_check_units: 1,
124
+ invalid_syntax_check_units: 0,
125
+ locked_deep_check_units: 0
126
+ },
72
127
  monetary_quote: null,
73
128
  account_state: "unknown; included balance, on-demand access, accepted rates and spend cap require account state"
74
129
  },
75
130
  access: {
76
131
  api_key_required: true,
77
- key_types: ["secret", "public", "app"],
78
- key_fences: { public: "Allowed browser origin required", app: "Allowed X-App-Id required" },
79
- deep: { secret_or_public: "Uses available included verifications or enabled on-demand allowance, including on Free", app: "Locked; returns deep: {} without a verification", restricted_demo_key: "Metered deep is denied" },
132
+ key_types: [
133
+ "secret",
134
+ "public",
135
+ "app"
136
+ ],
137
+ key_fences: {
138
+ public: "Allowed browser origin required",
139
+ app: "Allowed X-App-Id required"
140
+ },
141
+ deep: {
142
+ secret_or_public: "Uses available included verifications or enabled on-demand allowance, including on Free",
143
+ app: "Locked; returns deep: {} without a verification",
144
+ restricted_demo_key: "Metered deep is denied"
145
+ },
80
146
  effective_access: null,
81
147
  effective_access_status: "not_checked; key fences, account access, quotas and spending controls still apply"
82
148
  },
@@ -84,56 +150,121 @@ var agent_catalog_default = {
84
150
  client: "javascript_sdk_and_mcp",
85
151
  default_retries: 2,
86
152
  deep_default_retries: 0,
87
- retry_http_statuses: [429, 500, 502, 503, 504],
153
+ retry_http_statuses: [
154
+ 429,
155
+ 500,
156
+ 502,
157
+ 503,
158
+ 504
159
+ ],
88
160
  retry_network_errors: true,
89
161
  successful_unknown_retried: false,
90
162
  guidance: "Do not infer a retry from null. Repeated completed deep checks consume additional verification units; a transport failure does not prove the previous attempt was unbilled. DNS failures can return 503 before mailbox verification."
91
163
  },
92
- docs: { help: "https://api.parseapi.com/version/2.0.0/email/help", guide: "https://parseapi.com/docs/email" }
164
+ docs: {
165
+ help: "https://api.parseapi.com/version/2.0.0/email/help",
166
+ guide: "https://parseapi.com/docs/email"
167
+ }
93
168
  },
94
169
  domain: {
95
170
  operation: "domain",
96
171
  endpoint: "GET /domain/{domain}",
97
- determines: ["Registry registration status", "With entitled deep=true, available registration details"],
98
- does_not_determine: ["Whether a registrar will sell an unregistered domain", "DNS routing or mailbox deliverability", "A live registry query on every request"],
99
- required_context: ["domain: a hostname rather than a URL or email address"],
172
+ determines: [
173
+ "Registry registration status",
174
+ "With entitled deep=true, available registration details"
175
+ ],
176
+ does_not_determine: [
177
+ "Whether a registrar will sell an unregistered domain",
178
+ "DNS routing or mailbox deliverability",
179
+ "A live registry query on every request"
180
+ ],
181
+ required_context: [
182
+ "domain: a hostname rather than a URL or email address"
183
+ ],
100
184
  freshness: {
101
185
  mode: "observation_reuse",
102
- reuse_max_seconds: { registered: 3600, unregistered: 300 },
186
+ reuse_max_seconds: {
187
+ registered: 3600,
188
+ unregistered: 300
189
+ },
103
190
  stale_if_error: false,
104
191
  actual_age_seconds: null,
105
192
  actual_age_status: "not_exposed"
106
193
  },
107
194
  uncertainty: {
108
- available: { true: "Registry reported unregistered", false: "Registry reported registered", null: "No usable current registry observation; availability is unknown" },
109
- deep: { omitted: "Not requested", empty_object: "Plan does not unlock registration details, or registration is unavailable" },
110
- "deep.registration": { omitted: "No entitled, usable registration observation" }
195
+ available: {
196
+ true: "Registry reported unregistered",
197
+ false: "Registry reported registered",
198
+ null: "No usable current registry observation; availability is unknown"
199
+ },
200
+ deep: {
201
+ omitted: "Not requested",
202
+ empty_object: "Plan does not unlock registration details, or registration is unavailable"
203
+ },
204
+ "deep.registration": {
205
+ omitted: "No entitled, usable registration observation"
206
+ }
207
+ },
208
+ billing: {
209
+ pooled_requests_per_success: 1,
210
+ metered: null,
211
+ deep_extra_units: 0,
212
+ monetary_quote: null,
213
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
111
214
  },
112
- billing: { pooled_requests_per_success: 1, metered: null, deep_extra_units: 0, monetary_quote: null, account_state: "unknown; pooled allowance and accepted account terms are not checked" },
113
215
  access: {
114
216
  api_key_required: true,
115
- key_types: ["secret", "public", "app"],
116
- key_fences: { public: "Allowed browser origin required", app: "Allowed X-App-Id required" },
117
- deep: { entitlement: "Paid plan; app keys retain plan-deep access", locked: "Returns deep: {}" },
217
+ key_types: [
218
+ "secret",
219
+ "public",
220
+ "app"
221
+ ],
222
+ key_fences: {
223
+ public: "Allowed browser origin required",
224
+ app: "Allowed X-App-Id required"
225
+ },
226
+ deep: {
227
+ entitlement: "Paid plan; app keys retain plan-deep access",
228
+ locked: "Returns deep: {}"
229
+ },
118
230
  effective_access: null,
119
231
  effective_access_status: "not_checked; key fences, account access and quotas still apply"
120
232
  },
121
233
  retry: {
122
234
  client: "javascript_sdk_and_mcp",
123
235
  default_retries: 2,
124
- retry_http_statuses: [429, 500, 502, 503, 504],
236
+ retry_http_statuses: [
237
+ 429,
238
+ 500,
239
+ 502,
240
+ 503,
241
+ 504
242
+ ],
125
243
  retry_network_errors: true,
126
244
  successful_unknown_retried: false,
127
245
  guidance: "available=null is a completed HTTP response with an unknown fact, not evidence the domain is free. Do not retry automatically from null; respect rate and quota errors."
128
246
  },
129
- docs: { help: "https://api.parseapi.com/version/2.0.0/domain/help", guide: "https://parseapi.com/docs/domain" }
247
+ docs: {
248
+ help: "https://api.parseapi.com/version/2.0.0/domain/help",
249
+ guide: "https://parseapi.com/docs/domain"
250
+ }
130
251
  },
131
252
  dns: {
132
253
  operation: "dns",
133
254
  endpoint: "GET /dns/{domain}",
134
- determines: ["Published answer records from a recursive DNS view", "Each returned record's remaining TTL"],
135
- does_not_determine: ["Global propagation or a zone transfer", "Domain registration availability", "Whether a CNAME destination works"],
136
- required_context: ["domain: a DNS name, including supported underscore or reverse names", "type: one supported record type, or omit for all ten supported types"],
255
+ determines: [
256
+ "Published answer records from a recursive DNS view",
257
+ "Each returned record's remaining TTL"
258
+ ],
259
+ does_not_determine: [
260
+ "Global propagation or a zone transfer",
261
+ "Domain registration availability",
262
+ "Whether a CNAME destination works"
263
+ ],
264
+ required_context: [
265
+ "domain: a DNS name, including supported underscore or reverse names",
266
+ "type: one supported record type, or omit for all ten supported types"
267
+ ],
137
268
  freshness: {
138
269
  mode: "dns_ttl",
139
270
  positive_cache_max_seconds: 3600,
@@ -146,36 +277,83 @@ var agent_catalog_default = {
146
277
  actual_age_status: "not_exposed; remaining TTL is exposed"
147
278
  },
148
279
  uncertainty: {
149
- records: { empty_array: "Successful lookup with no answer records of the requested types", failure: "A failed type returns an error, never an empty or silently partial result" },
150
- "records[].value": { "MX 0 .": "Explicit null MX; this domain declines mail", CNAME: "Published alias; its target may not exist" },
151
- http_status: { "404": "DNS name does not exist", "503": "Temporary DNS failure; no negative verdict" },
152
- deep: { omitted: "Not requested", empty_object: "Requested; this product has no additional deep fields" }
280
+ records: {
281
+ empty_array: "Successful lookup with no answer records of the requested types",
282
+ failure: "A failed type returns an error, never an empty or silently partial result"
283
+ },
284
+ "records[].value": {
285
+ "MX 0 .": "Explicit null MX; this domain declines mail",
286
+ CNAME: "Published alias; its target may not exist"
287
+ },
288
+ http_status: {
289
+ "404": "DNS name does not exist",
290
+ "503": "Temporary DNS failure; no negative verdict"
291
+ },
292
+ deep: {
293
+ omitted: "Not requested",
294
+ empty_object: "Requested; this product has no additional deep fields"
295
+ }
296
+ },
297
+ billing: {
298
+ pooled_requests_per_success: 1,
299
+ metered: null,
300
+ deep_extra_units: 0,
301
+ all_record_types_extra_units: 0,
302
+ monetary_quote: null,
303
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
153
304
  },
154
- billing: { pooled_requests_per_success: 1, metered: null, deep_extra_units: 0, all_record_types_extra_units: 0, monetary_quote: null, account_state: "unknown; pooled allowance and accepted account terms are not checked" },
155
305
  access: {
156
306
  api_key_required: true,
157
- key_types: ["secret", "public", "app"],
158
- key_fences: { public: "Allowed browser origin required", app: "Allowed X-App-Id required" },
159
- deep: { entitlement: "All records are core on every plan", requested: "Returns deep: {}" },
307
+ key_types: [
308
+ "secret",
309
+ "public",
310
+ "app"
311
+ ],
312
+ key_fences: {
313
+ public: "Allowed browser origin required",
314
+ app: "Allowed X-App-Id required"
315
+ },
316
+ deep: {
317
+ entitlement: "All records are core on every plan",
318
+ requested: "Returns deep: {}"
319
+ },
160
320
  effective_access: null,
161
321
  effective_access_status: "not_checked; key fences, account access and quotas still apply"
162
322
  },
163
323
  retry: {
164
324
  client: "javascript_sdk_and_mcp",
165
325
  default_retries: 2,
166
- retry_http_statuses: [429, 500, 502, 503, 504],
326
+ retry_http_statuses: [
327
+ 429,
328
+ 500,
329
+ 502,
330
+ 503,
331
+ 504
332
+ ],
167
333
  retry_network_errors: true,
168
334
  successful_unknown_retried: false,
169
335
  guidance: "An empty records array and a DNS-name 404 are negative answers, not transient failures. Reuse records only within their remaining TTL; respect rate and quota errors."
170
336
  },
171
- docs: { help: "https://api.parseapi.com/version/2.0.0/dns/help", guide: "https://parseapi.com/docs/dns" }
337
+ docs: {
338
+ help: "https://api.parseapi.com/version/2.0.0/dns/help",
339
+ guide: "https://parseapi.com/docs/dns"
340
+ }
172
341
  },
173
342
  mx: {
174
343
  operation: "mx",
175
344
  endpoint: "GET /mx/{domain}",
176
- determines: ["Published MX hosts sorted by priority and host", "An explicit null MX that declines mail"],
177
- does_not_determine: ["Mailbox deliverability", "No mail route from an empty MX list alone", "Domain registration availability"],
178
- required_context: ["domain: a hostname rather than a URL or email address"],
345
+ determines: [
346
+ "Published MX hosts sorted by priority and host",
347
+ "An explicit null MX that declines mail"
348
+ ],
349
+ does_not_determine: [
350
+ "Mailbox deliverability",
351
+ "No mail route from an empty MX list alone",
352
+ "Domain registration availability"
353
+ ],
354
+ required_context: [
355
+ "domain: a hostname rather than a URL or email address"
356
+ ],
179
357
  freshness: {
180
358
  mode: "dns_ttl",
181
359
  positive_cache_max_seconds: 3600,
@@ -186,35 +364,75 @@ var agent_catalog_default = {
186
364
  actual_age_status: "not_exposed; use dns with type=MX for remaining record TTLs"
187
365
  },
188
366
  uncertainty: {
189
- mx: { empty_array: "No MX records; A/AAAA mail fallback may still apply", null_mx: '[{priority: 0, host: "."}] explicitly declines mail' },
190
- http_status: { "503": "Temporary DNS failure; no negative verdict" },
191
- deep: { omitted: "This product has no deep response fields" }
367
+ mx: {
368
+ empty_array: "No MX records; A/AAAA mail fallback may still apply",
369
+ null_mx: '[{priority: 0, host: "."}] explicitly declines mail'
370
+ },
371
+ http_status: {
372
+ "503": "Temporary DNS failure; no negative verdict"
373
+ },
374
+ deep: {
375
+ omitted: "This product has no deep response fields"
376
+ }
377
+ },
378
+ billing: {
379
+ pooled_requests_per_success: 1,
380
+ metered: null,
381
+ monetary_quote: null,
382
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
192
383
  },
193
- billing: { pooled_requests_per_success: 1, metered: null, monetary_quote: null, account_state: "unknown; pooled allowance and accepted account terms are not checked" },
194
384
  access: {
195
385
  api_key_required: true,
196
- key_types: ["secret", "public", "app"],
197
- key_fences: { public: "Allowed browser origin required", app: "Allowed X-App-Id required" },
198
- deep: { entitlement: "All MX records are core on every plan" },
386
+ key_types: [
387
+ "secret",
388
+ "public",
389
+ "app"
390
+ ],
391
+ key_fences: {
392
+ public: "Allowed browser origin required",
393
+ app: "Allowed X-App-Id required"
394
+ },
395
+ deep: {
396
+ entitlement: "All MX records are core on every plan"
397
+ },
199
398
  effective_access: null,
200
399
  effective_access_status: "not_checked; key fences, account access and quotas still apply"
201
400
  },
202
401
  retry: {
203
402
  client: "javascript_sdk_and_mcp",
204
403
  default_retries: 2,
205
- retry_http_statuses: [429, 500, 502, 503, 504],
404
+ retry_http_statuses: [
405
+ 429,
406
+ 500,
407
+ 502,
408
+ 503,
409
+ 504
410
+ ],
206
411
  retry_network_errors: true,
207
412
  successful_unknown_retried: false,
208
413
  guidance: "Do not retry solely because mx is empty. Use email for mail-route validation or dns for explicit A/AAAA records; respect rate and quota errors."
209
414
  },
210
- docs: { help: "https://api.parseapi.com/version/2.0.0/mx/help", guide: "https://parseapi.com/docs/mx" }
415
+ docs: {
416
+ help: "https://api.parseapi.com/version/2.0.0/mx/help",
417
+ guide: "https://parseapi.com/docs/mx"
418
+ }
211
419
  },
212
420
  country: {
213
421
  operation: "country",
214
422
  endpoint: "GET /country/{code}",
215
- determines: ["Country reference information by ISO2, ISO3 or name", "With entitled deep=true, geography, population and national reference attributes"],
216
- does_not_determine: ["A live census or uniform observation date for every field", "Tax due on a particular transaction", "Missing facts by inference"],
217
- required_context: ["code: ISO2, ISO3 or a country name", "deep=true for profile fields such as population and area"],
423
+ determines: [
424
+ "Country reference information by ISO2, ISO3 or name",
425
+ "With entitled deep=true, geography, population and national reference attributes"
426
+ ],
427
+ does_not_determine: [
428
+ "A live census or uniform observation date for every field",
429
+ "Tax due on a particular transaction",
430
+ "Missing facts by inference"
431
+ ],
432
+ required_context: [
433
+ "code: ISO2, ISO3 or a country name",
434
+ "deep=true for profile fields such as population and area"
435
+ ],
218
436
  freshness: {
219
437
  mode: "maintained_reference",
220
438
  population_period_field: "deep.population_period",
@@ -223,32 +441,399 @@ var agent_catalog_default = {
223
441
  actual_age_status: "not_exposed; population period describes that statistic only"
224
442
  },
225
443
  uncertainty: {
226
- name_local: { null: "Native name unavailable or identical to the original name before display translation" },
227
- "deep.population_period": { null: "Observation period is unknown; never infer it from an import date" },
228
- "deep.water_area": { null: "Unknown or inconsistent with the archived total", zero: "Reported zero water area" },
229
- "deep.coastline": { null: "Unknown", zero: "Reported landlocked coastline" },
230
- "deep.tax": { null: "No national consumption levy is named; local levies may still apply" },
231
- "deep.tax_rate": { null: "Unavailable or no national levy applies", zero: "Known zero national reference rate" },
232
- deep: { omitted: "Not requested", empty_object: "Requested but the plan does not unlock the profile" }
444
+ name_local: {
445
+ null: "Native name unavailable or identical to the original name before display translation"
446
+ },
447
+ "deep.population_period": {
448
+ null: "Observation period is unknown; never infer it from an import date"
449
+ },
450
+ "deep.water_area": {
451
+ null: "Unknown or inconsistent with the archived total",
452
+ zero: "Reported zero water area"
453
+ },
454
+ "deep.coastline": {
455
+ null: "Unknown",
456
+ zero: "Reported landlocked coastline"
457
+ },
458
+ "deep.tax": {
459
+ null: "No national consumption levy is named; local levies may still apply"
460
+ },
461
+ "deep.tax_rate": {
462
+ null: "Unavailable or no national levy applies",
463
+ zero: "Known zero national reference rate"
464
+ },
465
+ deep: {
466
+ omitted: "Not requested",
467
+ empty_object: "Requested but the plan does not unlock the profile"
468
+ }
469
+ },
470
+ billing: {
471
+ pooled_requests_per_success: 1,
472
+ metered: null,
473
+ deep_extra_units: 0,
474
+ monetary_quote: null,
475
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
233
476
  },
234
- billing: { pooled_requests_per_success: 1, metered: null, deep_extra_units: 0, monetary_quote: null, account_state: "unknown; pooled allowance and accepted account terms are not checked" },
235
477
  access: {
236
478
  api_key_required: true,
237
- key_types: ["secret", "public", "app"],
238
- key_fences: { public: "Allowed browser origin required", app: "Allowed X-App-Id required" },
239
- deep: { entitlement: "Paid plan; app keys retain plan-deep access", locked: "Returns deep: {}" },
479
+ key_types: [
480
+ "secret",
481
+ "public",
482
+ "app"
483
+ ],
484
+ key_fences: {
485
+ public: "Allowed browser origin required",
486
+ app: "Allowed X-App-Id required"
487
+ },
488
+ deep: {
489
+ entitlement: "Paid plan; app keys retain plan-deep access",
490
+ locked: "Returns deep: {}"
491
+ },
240
492
  effective_access: null,
241
493
  effective_access_status: "not_checked; key fences, account access and quotas still apply"
242
494
  },
243
495
  retry: {
244
496
  client: "javascript_sdk_and_mcp",
245
497
  default_retries: 2,
246
- retry_http_statuses: [429, 500, 502, 503, 504],
498
+ retry_http_statuses: [
499
+ 429,
500
+ 500,
501
+ 502,
502
+ 503,
503
+ 504
504
+ ],
247
505
  retry_network_errors: true,
248
506
  successful_unknown_retried: false,
249
507
  guidance: "Do not retry to fill null reference fields or a locked deep object. Preserve unknowns and distinguish reported zero from null; respect rate and quota errors."
250
508
  },
251
- docs: { help: "https://api.parseapi.com/version/2.0.0/country/help", guide: "https://parseapi.com/docs/country" }
509
+ docs: {
510
+ help: "https://api.parseapi.com/version/2.0.0/country/help",
511
+ guide: "https://parseapi.com/docs/country"
512
+ }
513
+ },
514
+ time: {
515
+ operation: "time",
516
+ endpoint: "GET /time or /time/{timezone}",
517
+ determines: [
518
+ "Local ISO time, integer Unix seconds, UTC offset and the timezone-rule DST flag at one instant",
519
+ "The same captured instant in one destination with to, or in 1\u201310 ordered destinations with targets",
520
+ "With deep=true, friendly name, exact total and standard offsets, signed seasonal saving, the next offset change, full applicable seasonal boundaries, actual rule edition and source wall-time resolution",
521
+ "Exact location evidence for explicit IP, city, country, airport, supported port or US address input, with ambiguity retained as candidates"
522
+ ],
523
+ does_not_determine: [
524
+ "Future government rule changes or complete early historical records",
525
+ "Clock synchronization accuracy or a latency-free current time",
526
+ "A unique timezone from an abbreviation such as CST",
527
+ "A precise or verified person/device location from IP evidence",
528
+ "Postal-delivery validity, ownership, global address coverage or complete UN/LOCODE coverage"
529
+ ],
530
+ required_context: [
531
+ "Choose one source: omitted timezone for UTC, IANA timezone, paired lat/lon, explicit IP, exact city/country/state, country alone, IATA/ICAO airport, covered UN/LOCODE port, or address with country=US",
532
+ "at accepts an ISO date or timestamp with at most three fractional digits; omit it for now. Unix seconds are output, not input",
533
+ "Without to or targets, offsetless at means UTC. With to or targets, it means source wall time",
534
+ "disambiguation defaults to compatible: earlier occurrence on overlap, forward by the actual gap. earlier, later or reject apply only to offsetless conversion; an explicit offset identifies the instant",
535
+ "targets is a comma-separated list of 1\u201310 IANA IDs, mutually exclusive with to. Duplicates remain ordered; any invalid target rejects the whole conversion",
536
+ "For location.status=ambiguous, choose a returned candidate timezone or refine context. not_found and truncated results never guess a source instant. Airport/port codes and countries are explicit selectors, not arbitrary path identifiers."
537
+ ],
538
+ freshness: {
539
+ mode: "computed_from_pinned_rules",
540
+ timezone_database: "IANA",
541
+ timezone_database_version: "2026c",
542
+ cache_control: "no-store",
543
+ next_transition_horizon_days: 400,
544
+ uniform_refresh_interval_seconds: null,
545
+ actual_age_seconds: null,
546
+ actual_age_status: "not_exposed; rule edition is pinned, current time is evaluated for each request",
547
+ answer_evidence: "deep.timezone_database_version binds a requested detailed answer to the bundled rule edition, independently of coordinate boundary and display-name data"
548
+ },
549
+ uncertainty: {
550
+ timezone: {
551
+ null: "Coordinates or explicit location input did not identify one usable timezone; clock facts and requested to/targets stay null"
552
+ },
553
+ dst: {
554
+ true: "The active timezone rule carries its DST indicator, including negative seasonal adjustments; not proof the offset is positive",
555
+ false: "The active timezone rule does not carry its DST indicator",
556
+ null: "Source timezone is unresolved"
557
+ },
558
+ "deep.name": {
559
+ null: "Friendly display name unavailable or inconsistent with the pinned rule"
560
+ },
561
+ "deep.next_dst": {
562
+ null: "No UTC offset change found within 400 days, or source timezone unresolved; not a promise of no future changes"
563
+ },
564
+ deep: {
565
+ omitted: "Not requested",
566
+ object: "Requested; optional detail is included on every plan"
567
+ },
568
+ http_status: {
569
+ "400": "Invalid input, or a repeated/nonexistent source wall time with disambiguation=reject. Supply an explicit UTC offset or choose earlier/later",
570
+ "404": "Unknown IANA timezone",
571
+ "503": "Location store or required coordinate index unavailable; no negative location verdict"
572
+ },
573
+ targets: {
574
+ omitted: "Not requested",
575
+ null: "Source is unresolved or ambiguous; no target instant was guessed",
576
+ array: "Ordered requested target objects, including duplicates; all share the same captured instant"
577
+ },
578
+ "deep.resolution": {
579
+ null: "Now, explicit-offset input, no conversion, or unresolved source; no wall-time ambiguity was evaluated",
580
+ object: "Actual unique/overlap/gap classification, applied policy, signed wall adjustment in seconds, and two chronological alternatives for overlap/gap (empty for unique)"
581
+ },
582
+ error_code: {
583
+ ambiguous_time: "HTTP 400: reject policy encountered repeated source wall time; choose earlier/later or an explicit offset",
584
+ nonexistent_time: "HTTP 400: reject policy encountered skipped source wall time; choose earlier/later or an explicit offset",
585
+ invalid_request: "HTTP 400: other invalid input; correct it before retrying"
586
+ },
587
+ location: {
588
+ omitted: "No explicit location selector was used",
589
+ resolved: "One usable location candidate selected",
590
+ ambiguous: "Multiple or truncated candidates; choose/refine explicitly",
591
+ not_found: "No usable match in the available data; not proof the place does not exist"
592
+ },
593
+ "deep.season": {
594
+ null: "No current interval or next DST-flag interval starting within 400 days, or source unresolved",
595
+ object: "Current continuous DST-flag interval, otherwise the next beginning within 400 days; nullable start/end boundaries preserve limits",
596
+ endpoint_null: "Boundary absent from pinned rules or outside supported UTC years 0001 through 9999"
597
+ }
598
+ },
599
+ billing: {
600
+ pooled_requests_per_success: 1,
601
+ metered: null,
602
+ deep_extra_units: 0,
603
+ conversion_extra_units: 0,
604
+ monetary_quote: null,
605
+ account_state: "unknown; pooled allowance and accepted account terms are not checked",
606
+ targets_extra_units: 0,
607
+ maximum_targets: 10
608
+ },
609
+ access: {
610
+ api_key_required: true,
611
+ key_types: [
612
+ "secret",
613
+ "public",
614
+ "app"
615
+ ],
616
+ key_fences: {
617
+ public: "Allowed browser origin required",
618
+ app: "Allowed X-App-Id required"
619
+ },
620
+ deep: {
621
+ entitlement: "Optional time detail on every plan"
622
+ },
623
+ effective_access: null,
624
+ effective_access_status: "not_checked; key fences, account access and quotas still apply"
625
+ },
626
+ retry: {
627
+ client: "javascript_sdk_and_mcp",
628
+ default_retries: 2,
629
+ retry_http_statuses: [
630
+ 429,
631
+ 500,
632
+ 502,
633
+ 503,
634
+ 504
635
+ ],
636
+ retry_network_errors: true,
637
+ successful_unknown_retried: false,
638
+ guidance: "Do not retry unresolved/ambiguous locations or rejected wall times automatically. Correct the input or choose a resolution. Retried calls with omitted at evaluate a later now; pin an explicit instant when repeatability matters."
639
+ },
640
+ docs: {
641
+ help: "https://api.parseapi.com/version/2.0.0/time/help",
642
+ guide: "https://parseapi.com/docs/time"
643
+ }
644
+ },
645
+ card: {
646
+ operation: "card",
647
+ endpoint: "GET /card/{bin}",
648
+ determines: [
649
+ "Network identity from reviewed prefix rules and a CDN SVG logo with a generic fallback",
650
+ "Optional Deep: longest recorded prefix, issuer, country, funding type and prepaid status where known"
651
+ ],
652
+ does_not_determine: [
653
+ "Current allocation, card validity, account existence, ownership, funds or payment acceptance",
654
+ "Complete six-digit or eight-digit coverage or a uniform observation date",
655
+ "Missing fields by inheriting from a shorter prefix"
656
+ ],
657
+ required_context: [
658
+ "bin: processor-provided leading digits as a string, with 2 to 11 ASCII digits",
659
+ "At most 64 input characters; remove only ASCII space, tab, CR, LF and hyphen separators; preserve leading zeros",
660
+ "Never send a full card number or collect one to truncate for this lookup"
661
+ ],
662
+ input_schema: {
663
+ type: "object",
664
+ required: [
665
+ "bin"
666
+ ],
667
+ properties: {
668
+ bin: {
669
+ type: "string",
670
+ maxLength: 64,
671
+ pattern: "^[ \\t\\r\\n-]*(?:[0-9][ \\t\\r\\n-]*){2,11}$"
672
+ },
673
+ deep: {
674
+ type: "boolean",
675
+ default: false,
676
+ description: "Optional recorded issuer details; included on every plan. Six or more digits enable matching."
677
+ }
678
+ }
679
+ },
680
+ freshness: {
681
+ mode: "pinned_reference",
682
+ coverage: "15 network rule families; not complete global coverage. Issuer directory coverage is partial.",
683
+ mixed_source_ages: true,
684
+ uniform_refresh_interval_seconds: null,
685
+ actual_age_seconds: null,
686
+ actual_age_status: "not_exposed; a lookup or download time is not an allocation or verification date"
687
+ },
688
+ uncertainty: {
689
+ bin: {
690
+ value: "Normalized input string; compare deep.prefix to this value when Deep is requested",
691
+ invalid: "HTTP 400; malformed input is not an unknown-prefix result"
692
+ },
693
+ brand: {
694
+ value: "Network key determined independently of issuer records; brand_name is its display name",
695
+ null: "Unknown or ambiguous among reviewed network rules; send more prefix digits when available, up to 11"
696
+ },
697
+ "deep.prefix": {
698
+ null: "HTTP 200: fewer than six digits or no recorded directory match; not a verdict about a card or account",
699
+ equals_bin: "An exact recorded-prefix match for the supplied digits; individual fields can still be null",
700
+ shorter_than_bin: "A broader reference match only; an eight-digit input matching six digits does not establish an exact eight-digit allocation"
701
+ },
702
+ "deep.metadata": {
703
+ null: "Unknown in the one matched record. A more specific record masks its parent, including null fields; never backfill from a shorter prefix"
704
+ },
705
+ "deep.prepaid": {
706
+ true: "Explicitly recorded as prepaid",
707
+ false: "Explicitly recorded as not prepaid",
708
+ null: "Unknown, not false"
709
+ },
710
+ "deep.type": {
711
+ null: "Unknown or mixed funding type"
712
+ },
713
+ logo: {
714
+ value: "CDN SVG URL; generic for unknown or ambiguous networks or unavailable reviewed artwork"
715
+ }
716
+ },
717
+ billing: {
718
+ pooled_requests_per_success: 1,
719
+ metered: null,
720
+ monetary_quote: null,
721
+ account_state: "unknown; pooled allowance and accepted account terms are not checked",
722
+ deep: "Included in the same pooled request on every plan"
723
+ },
724
+ access: {
725
+ api_key_required: true,
726
+ key_types: [
727
+ "secret",
728
+ "public",
729
+ "app"
730
+ ],
731
+ key_fences: {
732
+ public: "Allowed browser origin required",
733
+ app: "Allowed X-App-Id required"
734
+ },
735
+ effective_access: null,
736
+ effective_access_status: "not_checked; key fences, account access and quotas still apply"
737
+ },
738
+ retry: {
739
+ client: "javascript_sdk_and_mcp",
740
+ default_retries: 2,
741
+ retry_http_statuses: [
742
+ 429,
743
+ 500,
744
+ 502,
745
+ 503,
746
+ 504
747
+ ],
748
+ retry_network_errors: true,
749
+ successful_unknown_retried: false,
750
+ guidance: "Do not retry a successful unknown prefix or null fields to manufacture a match. Honor Retry-After; waits over five seconds return the API error without automatic retry."
751
+ },
752
+ docs: {
753
+ help: "https://api.parseapi.com/version/2.0.0/card/help",
754
+ guide: "https://parseapi.com/docs/card",
755
+ attribution: "https://parseapi.com/legal/attribution#bin"
756
+ }
757
+ },
758
+ time_zones: {
759
+ operation: "time_zones",
760
+ endpoint: "GET /time/zones",
761
+ determines: [
762
+ "Serving timezone identifiers and aliases supported by the bundled Time rules",
763
+ "With q, identifiers containing every case-insensitive search token; underscores and spaces match equivalently",
764
+ "At one selected instant, optional rich rows with country associations, IANA area, abbreviation, exact offset, current DST and DST observance in that UTC calendar year"
765
+ ],
766
+ does_not_determine: [
767
+ "An arbitrary place-name search or a unique winner for an ambiguous abbreviation",
768
+ "Future government rule changes or a live source refresh",
769
+ "Physical-continent or mainland/island classification"
770
+ ],
771
+ required_context: [
772
+ "q is optional, at most 64 characters after trimming. Omit or leave blank to list all identifiers; an empty search result is []",
773
+ "Optional country, area, signed offset, abbreviation, dst or observes_dst filters; at is one ISO instant, omitted for now",
774
+ "details=true adds aligned zones rows while timezones stays a string array; sort=offset orders numerically, otherwise identifiers sort lexically",
775
+ "abbreviation returns every matching candidate at the selected instant; add country/context or choose an identifier explicitly"
776
+ ],
777
+ freshness: {
778
+ mode: "pinned_reference",
779
+ timezone_database: "IANA",
780
+ timezone_database_version: "2026c",
781
+ version_field: "timezone_database_version",
782
+ uniform_refresh_interval_seconds: null,
783
+ actual_age_seconds: null,
784
+ actual_age_status: "not_exposed; the response identifies the actual bundled rule edition"
785
+ },
786
+ uncertainty: {
787
+ timezones: {
788
+ empty_array: "No supported identifier matches the search; not a statement about whether a place exists",
789
+ array: "Serving identifiers and aliases matching filters, sorted by identifier or requested numerical offset"
790
+ },
791
+ timezone_database_version: {
792
+ value: "Pinned IANA rule edition, not a live-update guarantee"
793
+ },
794
+ zones: {
795
+ omitted: "Rich rows not requested",
796
+ array: "Aligned facts at one captured instant; empty countries means no recorded association, nullable area means no known IANA naming area"
797
+ }
798
+ },
799
+ billing: {
800
+ pooled_requests_per_success: 1,
801
+ metered: null,
802
+ monetary_quote: null,
803
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
804
+ },
805
+ access: {
806
+ api_key_required: true,
807
+ key_types: [
808
+ "secret",
809
+ "public",
810
+ "app"
811
+ ],
812
+ key_fences: {
813
+ public: "Allowed browser origin required",
814
+ app: "Allowed X-App-Id required"
815
+ },
816
+ effective_access: null,
817
+ effective_access_status: "not_checked; key fences, account access and quotas still apply"
818
+ },
819
+ retry: {
820
+ client: "javascript_sdk_and_mcp",
821
+ default_retries: 2,
822
+ retry_http_statuses: [
823
+ 429,
824
+ 500,
825
+ 502,
826
+ 503,
827
+ 504
828
+ ],
829
+ retry_network_errors: true,
830
+ successful_unknown_retried: false,
831
+ guidance: "Do not retry an empty match list automatically. Correct or broaden the identifier query."
832
+ },
833
+ docs: {
834
+ help: "https://api.parseapi.com/version/2.0.0/time/help",
835
+ guide: "https://parseapi.com/docs/time"
836
+ }
252
837
  }
253
838
  }
254
839
  };
@@ -372,8 +957,9 @@ function registerPreflight(server, client, transport) {
372
957
  }
373
958
 
374
959
  // src/registry.ts
375
- var VERSION = "1.5.0";
960
+ var VERSION = "1.7.0";
376
961
  var API_VERSION = "2.0.0";
962
+ var US_ROUTING_NOTICE = "Routing reference attribution: https://parseapi.com/legal/attribution#routing-numbers";
377
963
  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";
378
964
  var deep = z3.boolean().optional().describe("Include the nested deep object when available. Pricing depends on the operation.");
379
965
  var lat = z3.number().min(-90).max(90).describe("Latitude in decimal degrees");
@@ -386,6 +972,7 @@ var languageTools = /* @__PURE__ */ new Set([
386
972
  "asn",
387
973
  "company",
388
974
  "npi",
975
+ "provider",
389
976
  "continent",
390
977
  "continent_countries",
391
978
  "bloc_countries",
@@ -452,6 +1039,9 @@ function buildServer(key, transport, options = {}) {
452
1039
  if (["postal", "postal_nearby", "postal_distance"].includes(name) && data && typeof data === "object" && "country" in data && data.country === "AU") {
453
1040
  result.content.push({ type: "text", text: AU_POSTAL_NOTICE });
454
1041
  }
1042
+ if (name === "bank_us_ach" && data && typeof data === "object" && "bank_name" in data && typeof data.bank_name === "string" && data.bank_name.length > 0) {
1043
+ result.content.push({ type: "text", text: US_ROUTING_NOTICE });
1044
+ }
455
1045
  return result;
456
1046
  } catch (err) {
457
1047
  return toErrorResult(err);
@@ -784,6 +1374,52 @@ function buildServer(key, transport, options = {}) {
784
1374
  },
785
1375
  (c, a, request) => c.npi(a.npi, { ...request, deep: a.deep })
786
1376
  );
1377
+ tool(
1378
+ "bank",
1379
+ "Send an IBAN in a POST JSON body, keeping it out of the request URL. Parse with core checks and issues for input, country, length, structure, ISO checksum and supported national checks. not_supported is not a failed national check. Known bank names and BICs are independent nullable directory facts. Deep adds check digits, branch, the BBAN account remainder and source edition/match grain when a directory lookup ran, on every plan. Does not verify account existence, ownership or payment reachability.",
1380
+ {
1381
+ iban: z3.string().describe("Original IBAN input, with or without the country prefix. Preserve characters exactly so the API can report invalid input. Do not strip punctuation or decode percent escapes."),
1382
+ country: iso2("country code when the number has no prefix").optional(),
1383
+ deep: deep.describe("Include optional detail on every plan.")
1384
+ },
1385
+ (c, a, request) => c.bank(a.iban, { ...request, deep: a.deep, country: a.country })
1386
+ );
1387
+ tool(
1388
+ "bank_us_ach",
1389
+ "Check US routing-number format and ABA checksum plus account-field syntax. Sends original strings in a POST JSON body. No universal account checksum is available. A nullable bank_name is routing-directory identity only; this does not establish ACH eligibility, account existence or ownership. No deep option.",
1390
+ {
1391
+ routing: z3.string().describe("Original US routing string. Preserve leading zeros and characters; the API validates accepted separators."),
1392
+ account: z3.string().describe("Original account string. Preserve all characters, letter case and leading zeros; do not trim, normalize or decode.")
1393
+ },
1394
+ (c, a, request) => c.bankUsAch({ routing: a.routing, account: a.account }, request)
1395
+ );
1396
+ tool(
1397
+ "bank_requirements",
1398
+ "Describe supported Bank input fields, normalization rules, check scope and limitations for a country and format. Metadata only: support does not establish directory completeness or payment reachability.",
1399
+ {
1400
+ country: iso2("country code"),
1401
+ format: z3.string().optional().describe("Input format, currently iban (default) or us_ach. Unknown formats report supported false.")
1402
+ },
1403
+ (c, a, request) => c.bankRequirements(a.country, { ...request, format: a.format })
1404
+ );
1405
+ tool(
1406
+ "card",
1407
+ "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.",
1408
+ {
1409
+ bin: z3.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."),
1410
+ deep: deep.describe("Include recorded issuer details, pooled on every plan. Omitted by default; fewer than six digits returns all-null Deep fields.")
1411
+ },
1412
+ (c, a, request) => c.card(a.bin, { ...request, deep: a.deep })
1413
+ );
1414
+ tool(
1415
+ "provider",
1416
+ "Look up an NPI in stored provider-directory sources. valid is format/checksum only; registered means found in the NPPES snapshot; active is recorded NPI activation, not licensure. excluded is an NPI-only OIG LEIE match, and false is not complete exclusion clearance. Returns identity, specialty and practice contact where held. Core sources provides nullable edition metadata on every plan. Paid deep adds all published taxonomies and reported license details, provider enumeration/update/reactivation dates, deactivation date, Medicare enrollment, opt-out and enrollment rows. Reported licenses are not verified licenses; provider update dates are not source freshness. Null means unknown. No live credential or payment-eligibility verification. Pooled request; no separate check meter.",
1417
+ {
1418
+ npi: z3.string().describe("Original NPI input as a string, normally 10 digits. Preserve the input; invalid values return valid=false with unknown provider fields. Do not URI-decode it."),
1419
+ deep: deep.describe("Include taxonomies, enumerated_at, updated_at, reactivated_at, deactivated_at, medicare, opt_out and enrollments from stored sources on paid plans. Omitted by default; Free returns {}. Null lists are unavailable; [] means the source recorded no rows.")
1420
+ },
1421
+ (c, a, request) => c.provider(a.npi, { ...request, deep: a.deep })
1422
+ );
787
1423
  tool(
788
1424
  "phone",
789
1425
  "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.",
@@ -868,9 +1504,15 @@ function buildServer(key, transport, options = {}) {
868
1504
  { ua: z3.string().describe("The User-Agent string to parse"), deep },
869
1505
  (c, a, request) => c.useragent(a.ua, { ...request, deep: a.deep })
870
1506
  );
1507
+ tool(
1508
+ "vehicle",
1509
+ "Identify a vehicle by VIN: year, make, model, trim, body and vehicle type. Paid deep adds specifications, manufacturing detail and model-level recall campaigns. These do not establish whether this VIN needs a repair.",
1510
+ { vin: z3.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
1511
+ (c, a, request) => c.vehicle(a.vin, { ...request, deep: a.deep })
1512
+ );
871
1513
  tool(
872
1514
  "vin",
873
- "Decode a VIN to year, make, model, trim, body and vehicle type. Paid deep adds specifications, manufacturing detail and recalls.",
1515
+ "Compatibility entry for vehicle. Decode a VIN to year, make, model, trim, body and vehicle type. Paid deep adds specifications, manufacturing detail and model-level recall campaigns.",
874
1516
  { vin: z3.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
875
1517
  (c, a, request) => c.vin(a.vin, { ...request, deep: a.deep })
876
1518
  );
@@ -891,20 +1533,36 @@ function buildServer(key, transport, options = {}) {
891
1533
  (c, a, request) => c.tariff.search(a.query, request)
892
1534
  );
893
1535
  tool(
894
- "naics",
1536
+ "industry",
895
1537
  "Look up a US NAICS 2022 code, title and parent hierarchy. Deep adds definition, children and exclusions on paid plans.",
896
1538
  { code: z3.string().describe("NAICS code, e.g. 541511 or sector range 31-33"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
897
- (c, a, request) => c.naics(a.code, { ...request, deep: a.deep })
1539
+ (c, a, request) => c.industry(a.code, { ...request, deep: a.deep })
898
1540
  );
899
1541
  tool(
900
- "naics_search",
1542
+ "industry_search",
901
1543
  "Search US NAICS 2022 titles and activities. Matching text and corrections stay with the result. Deep adds definition, children and exclusions inside each result on paid plans.",
902
1544
  {
903
1545
  query: z3.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
904
1546
  limit: z3.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
905
1547
  deep: deep.describe("Include the complete detail bag on a paid plan.")
906
1548
  },
907
- (c, a, request) => c.naics.search(a.query, { ...request, deep: a.deep, limit: a.limit })
1549
+ (c, a, request) => c.industry.search(a.query, { ...request, deep: a.deep, limit: a.limit })
1550
+ );
1551
+ tool(
1552
+ "naics",
1553
+ "Compatibility name for industry. Look up a US NAICS 2022 code, title and parent hierarchy. Deep adds definition, children and exclusions on paid plans.",
1554
+ { code: z3.string().describe("NAICS code, e.g. 541511 or sector range 31-33"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
1555
+ (c, a, request) => c.industry(a.code, { ...request, deep: a.deep })
1556
+ );
1557
+ tool(
1558
+ "naics_search",
1559
+ "Compatibility name for industry_search. Search US NAICS 2022 titles and activities. Matching text and corrections stay with the result. Deep adds definition, children and exclusions inside each result on paid plans.",
1560
+ {
1561
+ query: z3.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
1562
+ limit: z3.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
1563
+ deep: deep.describe("Include the complete detail bag on a paid plan.")
1564
+ },
1565
+ (c, a, request) => c.industry.search(a.query, { ...request, deep: a.deep, limit: a.limit })
908
1566
  );
909
1567
  tool(
910
1568
  "currency",
@@ -944,20 +1602,50 @@ function buildServer(key, transport, options = {}) {
944
1602
  );
945
1603
  tool(
946
1604
  "time",
947
- "Current local time, Unix seconds, exact UTC offset and DST. Omit timezone for UTC or pass both coordinates. at selects the moment; to converts it. Deep adds friendly name, numeric offsets and the next source clock transition on every plan.",
1605
+ "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 rule edition, wall-time resolution, standard/seasonal offsets and actual DST-season transitions on every plan.",
948
1606
  {
949
- timezone: z3.string().min(1).optional().describe("IANA timezone, e.g. America/New_York. Omit for UTC when coordinates are absent"),
1607
+ timezone: z3.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"),
950
1608
  lat: lat.optional(),
951
1609
  lon: lon.optional(),
952
- at: z3.string().min(1).optional().describe("ISO 8601 time, default now. With to, a time without a UTC offset is source wall time. Otherwise it is UTC. Include an offset to disambiguate a repeated local time"),
1610
+ ip: z3.string().min(1).max(45).refine((value) => Boolean(value.trim()), { message: "Time source must not be empty." }).optional().describe("Explicit IPv4 or IPv6 input. Never use a hosted server IP as the user location."),
1611
+ city: z3.string().min(1).max(200).refine((value) => Boolean(value.trim()), { message: "Time source must not be empty." }).optional().describe("Exact city name or stable city_ identifier. Country and state can narrow candidates."),
1612
+ country: z3.string().regex(/^[A-Za-z]{2}$/).optional().describe("ISO2 country as the source, or context with city/address. Multiple country timezones remain candidates."),
1613
+ state: z3.string().min(1).max(6).optional().describe("State context with city/address and country, as a bare code or matching country-prefixed code."),
1614
+ iata: z3.string().regex(/^[A-Za-z]{3}$/).optional().describe("Three-letter IATA airport identifier."),
1615
+ icao: z3.string().regex(/^[A-Za-z]{4}$/).optional().describe("Four-letter ICAO airport identifier."),
1616
+ unlocode: z3.string().regex(/^[A-Za-z]{2} ?[A-Za-z2-9]{3}$/).optional().describe("UN/LOCODE port identifier. Results use the reviewed port reference, not every assigned UN/LOCODE."),
1617
+ address: z3.string().min(1).max(200).refine((value) => Boolean(value.trim()), { message: "Time source must not be empty." }).optional().describe("Full address with explicit country. Strict point matches are currently supported for US; ambiguity stays unresolved."),
1618
+ at: z3.string().min(1).optional().describe("ISO 8601 time, default now. With to or targets, a time without a UTC offset is source wall time. Otherwise it is UTC. Include an offset to disambiguate a repeated local time"),
1619
+ disambiguation: z3.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."),
1620
+ targets: z3.array(z3.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."),
953
1621
  to: z3.string().min(1).optional().describe("Destination IANA timezone, e.g. Asia/Tokyo. Returns to.at and to.unix at the same instant"),
954
1622
  deep: deep.describe("Include optional detail on every plan.")
955
1623
  },
956
- (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 }) : c.time(a.timezone, { ...request, deep: a.deep, at: a.at, to: a.to }),
1624
+ (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 }),
957
1625
  (schema) => schema.refine(
958
- (a) => a.timezone !== void 0 ? a.lat === void 0 && a.lon === void 0 : a.lat === void 0 === (a.lon === void 0),
959
- { message: "Pass a timezone, both lat and lon, or neither for UTC." }
960
- )
1626
+ (a) => {
1627
+ const sources = [a.timezone, a.ip, a.city, a.iata, a.icao, a.unlocode, a.address].filter((value) => value !== void 0).length + (a.lat !== void 0 ? 1 : 0) + (a.country !== void 0 && a.city === void 0 && a.address === void 0 ? 1 : 0);
1628
+ return sources <= 1 && a.lat === void 0 === (a.lon === void 0) && (a.address === void 0 || a.country !== void 0) && (a.state === void 0 || a.country !== void 0 && (a.city !== void 0 || a.address !== void 0));
1629
+ },
1630
+ { message: "Pass one Time source. Country/state can narrow city or address; state and address require country." }
1631
+ ).refine((a) => a.to === void 0 || a.targets === void 0, { message: "Pass to or targets, not both." })
1632
+ );
1633
+ tool(
1634
+ "time_zones",
1635
+ "Search serving IANA timezone identifiers and their pinned rule edition. Filter by country, IANA area, exact offset, abbreviation or DST facts at one instant. Abbreviations return candidate identifiers and never choose a timezone. Empty timezones means no match. Details adds aligned rows and the evaluation instant. One pooled request.",
1636
+ {
1637
+ query: z3.string().trim().max(64).optional().describe("Identifier search, e.g. New York or Europe. Spaces and underscores match the same way."),
1638
+ country: z3.string().regex(/^[A-Za-z]{2}$/).optional().describe("ISO2 country association, e.g. US."),
1639
+ area: z3.string().min(1).max(64).optional().describe("IANA identifier prefix, e.g. America."),
1640
+ offset: z3.string().regex(/^[+-]\d{2}:\d{2}(?::\d{2})?$/).optional().describe("Exact UTC offset at the selected instant, e.g. +05:45 or +00:09:21."),
1641
+ abbreviation: z3.string().min(1).max(64).optional().describe("Timezone abbreviation to find candidates for, e.g. CST. Never infer a unique zone from an abbreviation."),
1642
+ dst: z3.boolean().optional().describe("Whether the rule DST flag is active at the selected instant. Includes negative seasonal adjustments."),
1643
+ observes_dst: z3.boolean().optional().describe("Whether a DST-flagged state occurs during the UTC calendar year containing at."),
1644
+ at: z3.string().min(1).optional().describe("ISO instant for all filters and detailed rows. Default now. Offsetless input means UTC."),
1645
+ details: z3.boolean().optional().describe("Include zones rows with country associations, area, offset, abbreviation and DST facts, plus the common evaluation instant."),
1646
+ sort: z3.enum(["timezone", "offset"]).optional().describe("Order by identifier (default) or actual UTC offset, then identifier.")
1647
+ },
1648
+ (c, a, request) => c.time.zones(a.query, { ...request, country: a.country, area: a.area, offset: a.offset, abbreviation: a.abbreviation, dst: a.dst, observes_dst: a.observes_dst, at: a.at, details: a.details, sort: a.sort })
961
1649
  );
962
1650
  tool(
963
1651
  "timezone",
package/dist/http.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-3CF6NRFS.js";
5
+ } from "./chunk-XLQITELE.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-3CF6NRFS.js";
5
+ } from "./chunk-XLQITELE.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-3CF6NRFS.js";
5
+ } from "./chunk-XLQITELE.js";
6
6
 
7
7
  // src/stdio.ts
8
8
  import { serveStdio } from "@modelcontextprotocol/server/stdio";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "parseapi-mcp",
3
- "version": "1.5.0",
3
+ "version": "1.7.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": [
@@ -48,9 +48,9 @@
48
48
  "prepublishOnly": "npm run typecheck && npm test"
49
49
  },
50
50
  "dependencies": {
51
- "@modelcontextprotocol/server": "^2.0.0",
52
51
  "@modelcontextprotocol/node": "^2.0.0",
53
- "@parseapi/sdk": "^1.5.0",
52
+ "@modelcontextprotocol/server": "^2.0.0",
53
+ "@parseapi/sdk": "^1.8.0",
54
54
  "zod": "^4.0.0"
55
55
  },
56
56
  "devDependencies": {