parseapi-mcp 1.5.0 → 1.6.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
@@ -79,11 +79,18 @@ Example tool arguments:
79
79
  | `time` | `{}` (UTC now) |
80
80
  | `time` | `{"timezone":"America/New_York","at":"2026-09-05T09:00:00","to":"Asia/Tokyo"}` |
81
81
  | `time` | `{"lat":40.71,"lon":-74.01}` |
82
+ | `time` | `{"timezone":"UTC","targets":["America/New_York","Asia/Tokyo"]}` |
83
+ | `time_zones` | `{"query":"New York"}` |
84
+ | `time` | `{"timezone":"America/New_York","at":"2026-11-01T01:30:00","to":"UTC","disambiguation":"later"}` |
82
85
  | `date` | `{"date":"03/04/2026","format":"dmy"}` |
83
86
  | `elevation` | `{"lat":35.2271,"lon":-80.8431}` |
84
87
  | `elevation` | `{"points":"35.2271,-80.8431|40.7128,-74.006"}` |
85
88
  | `elevation` | `{"path":"35.2271,-80.8431|35.5951,-82.5515","samples":100}` |
86
89
 
90
+ 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.
91
+
92
+ 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.
93
+
87
94
  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
95
 
89
96
  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.
@@ -105,7 +112,7 @@ Ask `discover` what an operation can determine before making a lookup:
105
112
  { "operation": "email" }
106
113
  ```
107
114
 
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.
115
+ 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
116
 
110
117
  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
118
 
@@ -127,7 +134,7 @@ The estimate allows up to three attempts per ordinary lookup and one per Email D
127
134
  For a compact tool catalog, set `PARSEAPI_MCP_MODE=compact` on the MCP process:
128
135
 
129
136
  ```bash
130
- PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@1.5.0
137
+ PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@1.6.0
131
138
  ```
132
139
 
133
140
  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:
@@ -197,3 +204,10 @@ Pass a public hostname without a scheme, path, port or IP address. Stack returns
197
204
  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
205
 
199
206
  The `stack` tool allows 35 seconds per attempt for a first check. MCP cancellation still aborts the request.
207
+
208
+
209
+ 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: []`.
210
+
211
+ `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.
212
+
213
+ `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.
@@ -44,13 +44,34 @@ var agent_catalog_default = {
44
44
  email: {
45
45
  operation: "email",
46
46
  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"],
47
+ determines: [
48
+ "Email syntax and domain mail routing",
49
+ "Consumer, disposable and role-address classifications",
50
+ "With deep=true, a mailbox deliverability observation"
51
+ ],
52
+ does_not_determine: [
53
+ "Recipient identity, consent or ownership",
54
+ "Guaranteed delivery to an inbox",
55
+ "A new mailbox probe on every request"
56
+ ],
57
+ required_context: [
58
+ "email: a complete email address",
59
+ "deep=true only when a mailbox check is needed"
60
+ ],
50
61
  freshness: {
51
62
  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 },
63
+ mail_routing: {
64
+ mode: "dns_ttl",
65
+ positive_cache_max_seconds: 3600,
66
+ negative_cache_max_seconds: 300,
67
+ shorter_dns_ttl_wins: true,
68
+ stale_if_error: false
69
+ },
70
+ mailbox_corpus_reuse_max_seconds: {
71
+ deliverable: 604800,
72
+ catchall: 2592e3,
73
+ undeliverable: 7776e3
74
+ },
54
75
  mailbox_response_cache_ttl_seconds: 86400,
55
76
  mailbox_local_cache_ttl_seconds: 3600,
56
77
  effective_max_age_seconds: null,
@@ -59,24 +80,63 @@ var agent_catalog_default = {
59
80
  actual_age_status: "not_exposed"
60
81
  },
61
82
  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" }
83
+ valid: {
84
+ true: "Syntax is valid; this does not establish mailbox existence",
85
+ false: "Syntax is invalid"
86
+ },
87
+ domain_valid: {
88
+ true: "MX or permitted A/AAAA fallback supplies a mail route",
89
+ false: "When valid=true, no usable mail route, including an explicit null MX. When valid=false, routing was not checked"
90
+ },
91
+ domain_type: {
92
+ null: "No supported reserved namespace classification"
93
+ },
94
+ "deep.deliverable": {
95
+ true: "Mailbox likely exists",
96
+ false: "Negative verification, eligible local disposable/no-route rejection, or invalid syntax that skipped verification; check valid first",
97
+ null: "Mailbox check did not complete; no verification unit is charged"
98
+ },
99
+ "deep.catchall": {
100
+ true: "Domain accepts all addresses; an individual mailbox is not established",
101
+ false: "Not classified as catchall, including invalid input and local rejection where no mailbox probe ran",
102
+ null: "Mailbox check did not complete"
103
+ },
104
+ deep: {
105
+ omitted: "Not requested",
106
+ empty_object: "Requested with an app key; mailbox verification is locked"
107
+ }
68
108
  },
69
109
  billing: {
70
110
  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 },
111
+ metered: {
112
+ name: "email",
113
+ when: "deep=true and a valid-syntax eligible check completes",
114
+ units_per_completed_check: 1,
115
+ cache_hits_bill_units: true,
116
+ incomplete_check_units: 0,
117
+ eligible_local_negative_check_units: 1,
118
+ invalid_syntax_check_units: 0,
119
+ locked_deep_check_units: 0
120
+ },
72
121
  monetary_quote: null,
73
122
  account_state: "unknown; included balance, on-demand access, accepted rates and spend cap require account state"
74
123
  },
75
124
  access: {
76
125
  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" },
126
+ key_types: [
127
+ "secret",
128
+ "public",
129
+ "app"
130
+ ],
131
+ key_fences: {
132
+ public: "Allowed browser origin required",
133
+ app: "Allowed X-App-Id required"
134
+ },
135
+ deep: {
136
+ secret_or_public: "Uses available included verifications or enabled on-demand allowance, including on Free",
137
+ app: "Locked; returns deep: {} without a verification",
138
+ restricted_demo_key: "Metered deep is denied"
139
+ },
80
140
  effective_access: null,
81
141
  effective_access_status: "not_checked; key fences, account access, quotas and spending controls still apply"
82
142
  },
@@ -84,56 +144,121 @@ var agent_catalog_default = {
84
144
  client: "javascript_sdk_and_mcp",
85
145
  default_retries: 2,
86
146
  deep_default_retries: 0,
87
- retry_http_statuses: [429, 500, 502, 503, 504],
147
+ retry_http_statuses: [
148
+ 429,
149
+ 500,
150
+ 502,
151
+ 503,
152
+ 504
153
+ ],
88
154
  retry_network_errors: true,
89
155
  successful_unknown_retried: false,
90
156
  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
157
  },
92
- docs: { help: "https://api.parseapi.com/version/2.0.0/email/help", guide: "https://parseapi.com/docs/email" }
158
+ docs: {
159
+ help: "https://api.parseapi.com/version/2.0.0/email/help",
160
+ guide: "https://parseapi.com/docs/email"
161
+ }
93
162
  },
94
163
  domain: {
95
164
  operation: "domain",
96
165
  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"],
166
+ determines: [
167
+ "Registry registration status",
168
+ "With entitled deep=true, available registration details"
169
+ ],
170
+ does_not_determine: [
171
+ "Whether a registrar will sell an unregistered domain",
172
+ "DNS routing or mailbox deliverability",
173
+ "A live registry query on every request"
174
+ ],
175
+ required_context: [
176
+ "domain: a hostname rather than a URL or email address"
177
+ ],
100
178
  freshness: {
101
179
  mode: "observation_reuse",
102
- reuse_max_seconds: { registered: 3600, unregistered: 300 },
180
+ reuse_max_seconds: {
181
+ registered: 3600,
182
+ unregistered: 300
183
+ },
103
184
  stale_if_error: false,
104
185
  actual_age_seconds: null,
105
186
  actual_age_status: "not_exposed"
106
187
  },
107
188
  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" }
189
+ available: {
190
+ true: "Registry reported unregistered",
191
+ false: "Registry reported registered",
192
+ null: "No usable current registry observation; availability is unknown"
193
+ },
194
+ deep: {
195
+ omitted: "Not requested",
196
+ empty_object: "Plan does not unlock registration details, or registration is unavailable"
197
+ },
198
+ "deep.registration": {
199
+ omitted: "No entitled, usable registration observation"
200
+ }
201
+ },
202
+ billing: {
203
+ pooled_requests_per_success: 1,
204
+ metered: null,
205
+ deep_extra_units: 0,
206
+ monetary_quote: null,
207
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
111
208
  },
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
209
  access: {
114
210
  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: {}" },
211
+ key_types: [
212
+ "secret",
213
+ "public",
214
+ "app"
215
+ ],
216
+ key_fences: {
217
+ public: "Allowed browser origin required",
218
+ app: "Allowed X-App-Id required"
219
+ },
220
+ deep: {
221
+ entitlement: "Paid plan; app keys retain plan-deep access",
222
+ locked: "Returns deep: {}"
223
+ },
118
224
  effective_access: null,
119
225
  effective_access_status: "not_checked; key fences, account access and quotas still apply"
120
226
  },
121
227
  retry: {
122
228
  client: "javascript_sdk_and_mcp",
123
229
  default_retries: 2,
124
- retry_http_statuses: [429, 500, 502, 503, 504],
230
+ retry_http_statuses: [
231
+ 429,
232
+ 500,
233
+ 502,
234
+ 503,
235
+ 504
236
+ ],
125
237
  retry_network_errors: true,
126
238
  successful_unknown_retried: false,
127
239
  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
240
  },
129
- docs: { help: "https://api.parseapi.com/version/2.0.0/domain/help", guide: "https://parseapi.com/docs/domain" }
241
+ docs: {
242
+ help: "https://api.parseapi.com/version/2.0.0/domain/help",
243
+ guide: "https://parseapi.com/docs/domain"
244
+ }
130
245
  },
131
246
  dns: {
132
247
  operation: "dns",
133
248
  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"],
249
+ determines: [
250
+ "Published answer records from a recursive DNS view",
251
+ "Each returned record's remaining TTL"
252
+ ],
253
+ does_not_determine: [
254
+ "Global propagation or a zone transfer",
255
+ "Domain registration availability",
256
+ "Whether a CNAME destination works"
257
+ ],
258
+ required_context: [
259
+ "domain: a DNS name, including supported underscore or reverse names",
260
+ "type: one supported record type, or omit for all ten supported types"
261
+ ],
137
262
  freshness: {
138
263
  mode: "dns_ttl",
139
264
  positive_cache_max_seconds: 3600,
@@ -146,36 +271,83 @@ var agent_catalog_default = {
146
271
  actual_age_status: "not_exposed; remaining TTL is exposed"
147
272
  },
148
273
  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" }
274
+ records: {
275
+ empty_array: "Successful lookup with no answer records of the requested types",
276
+ failure: "A failed type returns an error, never an empty or silently partial result"
277
+ },
278
+ "records[].value": {
279
+ "MX 0 .": "Explicit null MX; this domain declines mail",
280
+ CNAME: "Published alias; its target may not exist"
281
+ },
282
+ http_status: {
283
+ "404": "DNS name does not exist",
284
+ "503": "Temporary DNS failure; no negative verdict"
285
+ },
286
+ deep: {
287
+ omitted: "Not requested",
288
+ empty_object: "Requested; this product has no additional deep fields"
289
+ }
290
+ },
291
+ billing: {
292
+ pooled_requests_per_success: 1,
293
+ metered: null,
294
+ deep_extra_units: 0,
295
+ all_record_types_extra_units: 0,
296
+ monetary_quote: null,
297
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
153
298
  },
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
299
  access: {
156
300
  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: {}" },
301
+ key_types: [
302
+ "secret",
303
+ "public",
304
+ "app"
305
+ ],
306
+ key_fences: {
307
+ public: "Allowed browser origin required",
308
+ app: "Allowed X-App-Id required"
309
+ },
310
+ deep: {
311
+ entitlement: "All records are core on every plan",
312
+ requested: "Returns deep: {}"
313
+ },
160
314
  effective_access: null,
161
315
  effective_access_status: "not_checked; key fences, account access and quotas still apply"
162
316
  },
163
317
  retry: {
164
318
  client: "javascript_sdk_and_mcp",
165
319
  default_retries: 2,
166
- retry_http_statuses: [429, 500, 502, 503, 504],
320
+ retry_http_statuses: [
321
+ 429,
322
+ 500,
323
+ 502,
324
+ 503,
325
+ 504
326
+ ],
167
327
  retry_network_errors: true,
168
328
  successful_unknown_retried: false,
169
329
  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
330
  },
171
- docs: { help: "https://api.parseapi.com/version/2.0.0/dns/help", guide: "https://parseapi.com/docs/dns" }
331
+ docs: {
332
+ help: "https://api.parseapi.com/version/2.0.0/dns/help",
333
+ guide: "https://parseapi.com/docs/dns"
334
+ }
172
335
  },
173
336
  mx: {
174
337
  operation: "mx",
175
338
  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"],
339
+ determines: [
340
+ "Published MX hosts sorted by priority and host",
341
+ "An explicit null MX that declines mail"
342
+ ],
343
+ does_not_determine: [
344
+ "Mailbox deliverability",
345
+ "No mail route from an empty MX list alone",
346
+ "Domain registration availability"
347
+ ],
348
+ required_context: [
349
+ "domain: a hostname rather than a URL or email address"
350
+ ],
179
351
  freshness: {
180
352
  mode: "dns_ttl",
181
353
  positive_cache_max_seconds: 3600,
@@ -186,35 +358,75 @@ var agent_catalog_default = {
186
358
  actual_age_status: "not_exposed; use dns with type=MX for remaining record TTLs"
187
359
  },
188
360
  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" }
361
+ mx: {
362
+ empty_array: "No MX records; A/AAAA mail fallback may still apply",
363
+ null_mx: '[{priority: 0, host: "."}] explicitly declines mail'
364
+ },
365
+ http_status: {
366
+ "503": "Temporary DNS failure; no negative verdict"
367
+ },
368
+ deep: {
369
+ omitted: "This product has no deep response fields"
370
+ }
371
+ },
372
+ billing: {
373
+ pooled_requests_per_success: 1,
374
+ metered: null,
375
+ monetary_quote: null,
376
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
192
377
  },
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
378
  access: {
195
379
  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" },
380
+ key_types: [
381
+ "secret",
382
+ "public",
383
+ "app"
384
+ ],
385
+ key_fences: {
386
+ public: "Allowed browser origin required",
387
+ app: "Allowed X-App-Id required"
388
+ },
389
+ deep: {
390
+ entitlement: "All MX records are core on every plan"
391
+ },
199
392
  effective_access: null,
200
393
  effective_access_status: "not_checked; key fences, account access and quotas still apply"
201
394
  },
202
395
  retry: {
203
396
  client: "javascript_sdk_and_mcp",
204
397
  default_retries: 2,
205
- retry_http_statuses: [429, 500, 502, 503, 504],
398
+ retry_http_statuses: [
399
+ 429,
400
+ 500,
401
+ 502,
402
+ 503,
403
+ 504
404
+ ],
206
405
  retry_network_errors: true,
207
406
  successful_unknown_retried: false,
208
407
  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
408
  },
210
- docs: { help: "https://api.parseapi.com/version/2.0.0/mx/help", guide: "https://parseapi.com/docs/mx" }
409
+ docs: {
410
+ help: "https://api.parseapi.com/version/2.0.0/mx/help",
411
+ guide: "https://parseapi.com/docs/mx"
412
+ }
211
413
  },
212
414
  country: {
213
415
  operation: "country",
214
416
  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"],
417
+ determines: [
418
+ "Country reference information by ISO2, ISO3 or name",
419
+ "With entitled deep=true, geography, population and national reference attributes"
420
+ ],
421
+ does_not_determine: [
422
+ "A live census or uniform observation date for every field",
423
+ "Tax due on a particular transaction",
424
+ "Missing facts by inference"
425
+ ],
426
+ required_context: [
427
+ "code: ISO2, ISO3 or a country name",
428
+ "deep=true for profile fields such as population and area"
429
+ ],
218
430
  freshness: {
219
431
  mode: "maintained_reference",
220
432
  population_period_field: "deep.population_period",
@@ -223,32 +435,286 @@ var agent_catalog_default = {
223
435
  actual_age_status: "not_exposed; population period describes that statistic only"
224
436
  },
225
437
  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" }
438
+ name_local: {
439
+ null: "Native name unavailable or identical to the original name before display translation"
440
+ },
441
+ "deep.population_period": {
442
+ null: "Observation period is unknown; never infer it from an import date"
443
+ },
444
+ "deep.water_area": {
445
+ null: "Unknown or inconsistent with the archived total",
446
+ zero: "Reported zero water area"
447
+ },
448
+ "deep.coastline": {
449
+ null: "Unknown",
450
+ zero: "Reported landlocked coastline"
451
+ },
452
+ "deep.tax": {
453
+ null: "No national consumption levy is named; local levies may still apply"
454
+ },
455
+ "deep.tax_rate": {
456
+ null: "Unavailable or no national levy applies",
457
+ zero: "Known zero national reference rate"
458
+ },
459
+ deep: {
460
+ omitted: "Not requested",
461
+ empty_object: "Requested but the plan does not unlock the profile"
462
+ }
463
+ },
464
+ billing: {
465
+ pooled_requests_per_success: 1,
466
+ metered: null,
467
+ deep_extra_units: 0,
468
+ monetary_quote: null,
469
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
233
470
  },
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
471
  access: {
236
472
  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: {}" },
473
+ key_types: [
474
+ "secret",
475
+ "public",
476
+ "app"
477
+ ],
478
+ key_fences: {
479
+ public: "Allowed browser origin required",
480
+ app: "Allowed X-App-Id required"
481
+ },
482
+ deep: {
483
+ entitlement: "Paid plan; app keys retain plan-deep access",
484
+ locked: "Returns deep: {}"
485
+ },
240
486
  effective_access: null,
241
487
  effective_access_status: "not_checked; key fences, account access and quotas still apply"
242
488
  },
243
489
  retry: {
244
490
  client: "javascript_sdk_and_mcp",
245
491
  default_retries: 2,
246
- retry_http_statuses: [429, 500, 502, 503, 504],
492
+ retry_http_statuses: [
493
+ 429,
494
+ 500,
495
+ 502,
496
+ 503,
497
+ 504
498
+ ],
247
499
  retry_network_errors: true,
248
500
  successful_unknown_retried: false,
249
501
  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
502
  },
251
- docs: { help: "https://api.parseapi.com/version/2.0.0/country/help", guide: "https://parseapi.com/docs/country" }
503
+ docs: {
504
+ help: "https://api.parseapi.com/version/2.0.0/country/help",
505
+ guide: "https://parseapi.com/docs/country"
506
+ }
507
+ },
508
+ time: {
509
+ operation: "time",
510
+ endpoint: "GET /time or /time/{timezone}",
511
+ determines: [
512
+ "Local ISO time, integer Unix seconds, UTC offset and the timezone-rule DST flag at one instant",
513
+ "The same captured instant in one destination with to, or in 1\u201310 ordered destinations with targets",
514
+ "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",
515
+ "Exact location evidence for explicit IP, city, country, airport, supported port or US address input, with ambiguity retained as candidates"
516
+ ],
517
+ does_not_determine: [
518
+ "Future government rule changes or complete early historical records",
519
+ "Clock synchronization accuracy or a latency-free current time",
520
+ "A unique timezone from an abbreviation such as CST",
521
+ "A precise or verified person/device location from IP evidence",
522
+ "Postal-delivery validity, ownership, global address coverage or complete UN/LOCODE coverage"
523
+ ],
524
+ required_context: [
525
+ "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",
526
+ "at accepts an ISO date or timestamp with at most three fractional digits; omit it for now. Unix seconds are output, not input",
527
+ "Without to or targets, offsetless at means UTC. With to or targets, it means source wall time",
528
+ "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",
529
+ "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",
530
+ "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."
531
+ ],
532
+ freshness: {
533
+ mode: "computed_from_pinned_rules",
534
+ timezone_database: "IANA",
535
+ timezone_database_version: "2026c",
536
+ cache_control: "no-store",
537
+ next_transition_horizon_days: 400,
538
+ uniform_refresh_interval_seconds: null,
539
+ actual_age_seconds: null,
540
+ actual_age_status: "not_exposed; rule edition is pinned, current time is evaluated for each request",
541
+ answer_evidence: "deep.timezone_database_version binds a requested detailed answer to the bundled rule edition, independently of coordinate boundary and display-name data"
542
+ },
543
+ uncertainty: {
544
+ timezone: {
545
+ null: "Coordinates or explicit location input did not identify one usable timezone; clock facts and requested to/targets stay null"
546
+ },
547
+ dst: {
548
+ true: "The active timezone rule carries its DST indicator, including negative seasonal adjustments; not proof the offset is positive",
549
+ false: "The active timezone rule does not carry its DST indicator",
550
+ null: "Source timezone is unresolved"
551
+ },
552
+ "deep.name": {
553
+ null: "Friendly display name unavailable or inconsistent with the pinned rule"
554
+ },
555
+ "deep.next_dst": {
556
+ null: "No UTC offset change found within 400 days, or source timezone unresolved; not a promise of no future changes"
557
+ },
558
+ deep: {
559
+ omitted: "Not requested",
560
+ object: "Requested; optional detail is included on every plan"
561
+ },
562
+ http_status: {
563
+ "400": "Invalid input, or a repeated/nonexistent source wall time with disambiguation=reject. Supply an explicit UTC offset or choose earlier/later",
564
+ "404": "Unknown IANA timezone",
565
+ "503": "Location store or required coordinate index unavailable; no negative location verdict"
566
+ },
567
+ targets: {
568
+ omitted: "Not requested",
569
+ null: "Source is unresolved or ambiguous; no target instant was guessed",
570
+ array: "Ordered requested target objects, including duplicates; all share the same captured instant"
571
+ },
572
+ "deep.resolution": {
573
+ null: "Now, explicit-offset input, no conversion, or unresolved source; no wall-time ambiguity was evaluated",
574
+ object: "Actual unique/overlap/gap classification, applied policy, signed wall adjustment in seconds, and two chronological alternatives for overlap/gap (empty for unique)"
575
+ },
576
+ error_code: {
577
+ ambiguous_time: "HTTP 400: reject policy encountered repeated source wall time; choose earlier/later or an explicit offset",
578
+ nonexistent_time: "HTTP 400: reject policy encountered skipped source wall time; choose earlier/later or an explicit offset",
579
+ invalid_request: "HTTP 400: other invalid input; correct it before retrying"
580
+ },
581
+ location: {
582
+ omitted: "No explicit location selector was used",
583
+ resolved: "One usable location candidate selected",
584
+ ambiguous: "Multiple or truncated candidates; choose/refine explicitly",
585
+ not_found: "No usable match in the available data; not proof the place does not exist"
586
+ },
587
+ "deep.season": {
588
+ null: "No current interval or next DST-flag interval starting within 400 days, or source unresolved",
589
+ object: "Current continuous DST-flag interval, otherwise the next beginning within 400 days; nullable start/end boundaries preserve limits",
590
+ endpoint_null: "Boundary absent from pinned rules or outside supported UTC years 0001 through 9999"
591
+ }
592
+ },
593
+ billing: {
594
+ pooled_requests_per_success: 1,
595
+ metered: null,
596
+ deep_extra_units: 0,
597
+ conversion_extra_units: 0,
598
+ monetary_quote: null,
599
+ account_state: "unknown; pooled allowance and accepted account terms are not checked",
600
+ targets_extra_units: 0,
601
+ maximum_targets: 10
602
+ },
603
+ access: {
604
+ api_key_required: true,
605
+ key_types: [
606
+ "secret",
607
+ "public",
608
+ "app"
609
+ ],
610
+ key_fences: {
611
+ public: "Allowed browser origin required",
612
+ app: "Allowed X-App-Id required"
613
+ },
614
+ deep: {
615
+ entitlement: "Optional time detail on every plan"
616
+ },
617
+ effective_access: null,
618
+ effective_access_status: "not_checked; key fences, account access and quotas still apply"
619
+ },
620
+ retry: {
621
+ client: "javascript_sdk_and_mcp",
622
+ default_retries: 2,
623
+ retry_http_statuses: [
624
+ 429,
625
+ 500,
626
+ 502,
627
+ 503,
628
+ 504
629
+ ],
630
+ retry_network_errors: true,
631
+ successful_unknown_retried: false,
632
+ 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."
633
+ },
634
+ docs: {
635
+ help: "https://api.parseapi.com/version/2.0.0/time/help",
636
+ guide: "https://parseapi.com/docs/time"
637
+ }
638
+ },
639
+ time_zones: {
640
+ operation: "time_zones",
641
+ endpoint: "GET /time/zones",
642
+ determines: [
643
+ "Serving timezone identifiers and aliases supported by the bundled Time rules",
644
+ "With q, identifiers containing every case-insensitive search token; underscores and spaces match equivalently",
645
+ "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"
646
+ ],
647
+ does_not_determine: [
648
+ "An arbitrary place-name search or a unique winner for an ambiguous abbreviation",
649
+ "Future government rule changes or a live source refresh",
650
+ "Physical-continent or mainland/island classification"
651
+ ],
652
+ required_context: [
653
+ "q is optional, at most 64 characters after trimming. Omit or leave blank to list all identifiers; an empty search result is []",
654
+ "Optional country, area, signed offset, abbreviation, dst or observes_dst filters; at is one ISO instant, omitted for now",
655
+ "details=true adds aligned zones rows while timezones stays a string array; sort=offset orders numerically, otherwise identifiers sort lexically",
656
+ "abbreviation returns every matching candidate at the selected instant; add country/context or choose an identifier explicitly"
657
+ ],
658
+ freshness: {
659
+ mode: "pinned_reference",
660
+ timezone_database: "IANA",
661
+ timezone_database_version: "2026c",
662
+ version_field: "timezone_database_version",
663
+ uniform_refresh_interval_seconds: null,
664
+ actual_age_seconds: null,
665
+ actual_age_status: "not_exposed; the response identifies the actual bundled rule edition"
666
+ },
667
+ uncertainty: {
668
+ timezones: {
669
+ empty_array: "No supported identifier matches the search; not a statement about whether a place exists",
670
+ array: "Serving identifiers and aliases matching filters, sorted by identifier or requested numerical offset"
671
+ },
672
+ timezone_database_version: {
673
+ value: "Pinned IANA rule edition, not a live-update guarantee"
674
+ },
675
+ zones: {
676
+ omitted: "Rich rows not requested",
677
+ array: "Aligned facts at one captured instant; empty countries means no recorded association, nullable area means no known IANA naming area"
678
+ }
679
+ },
680
+ billing: {
681
+ pooled_requests_per_success: 1,
682
+ metered: null,
683
+ monetary_quote: null,
684
+ account_state: "unknown; pooled allowance and accepted account terms are not checked"
685
+ },
686
+ access: {
687
+ api_key_required: true,
688
+ key_types: [
689
+ "secret",
690
+ "public",
691
+ "app"
692
+ ],
693
+ key_fences: {
694
+ public: "Allowed browser origin required",
695
+ app: "Allowed X-App-Id required"
696
+ },
697
+ effective_access: null,
698
+ effective_access_status: "not_checked; key fences, account access and quotas still apply"
699
+ },
700
+ retry: {
701
+ client: "javascript_sdk_and_mcp",
702
+ default_retries: 2,
703
+ retry_http_statuses: [
704
+ 429,
705
+ 500,
706
+ 502,
707
+ 503,
708
+ 504
709
+ ],
710
+ retry_network_errors: true,
711
+ successful_unknown_retried: false,
712
+ guidance: "Do not retry an empty match list automatically. Correct or broaden the identifier query."
713
+ },
714
+ docs: {
715
+ help: "https://api.parseapi.com/version/2.0.0/time/help",
716
+ guide: "https://parseapi.com/docs/time"
717
+ }
252
718
  }
253
719
  }
254
720
  };
@@ -372,7 +838,7 @@ function registerPreflight(server, client, transport) {
372
838
  }
373
839
 
374
840
  // src/registry.ts
375
- var VERSION = "1.5.0";
841
+ var VERSION = "1.6.0";
376
842
  var API_VERSION = "2.0.0";
377
843
  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
844
  var deep = z3.boolean().optional().describe("Include the nested deep object when available. Pricing depends on the operation.");
@@ -944,20 +1410,50 @@ function buildServer(key, transport, options = {}) {
944
1410
  );
945
1411
  tool(
946
1412
  "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.",
1413
+ "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
1414
  {
949
- timezone: z3.string().min(1).optional().describe("IANA timezone, e.g. America/New_York. Omit for UTC when coordinates are absent"),
1415
+ 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
1416
  lat: lat.optional(),
951
1417
  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"),
1418
+ 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."),
1419
+ 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."),
1420
+ 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."),
1421
+ 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."),
1422
+ iata: z3.string().regex(/^[A-Za-z]{3}$/).optional().describe("Three-letter IATA airport identifier."),
1423
+ icao: z3.string().regex(/^[A-Za-z]{4}$/).optional().describe("Four-letter ICAO airport identifier."),
1424
+ 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."),
1425
+ 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."),
1426
+ 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"),
1427
+ 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."),
1428
+ 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
1429
  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
1430
  deep: deep.describe("Include optional detail on every plan.")
955
1431
  },
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 }),
1432
+ (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
1433
  (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
- )
1434
+ (a) => {
1435
+ 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);
1436
+ 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));
1437
+ },
1438
+ { message: "Pass one Time source. Country/state can narrow city or address; state and address require country." }
1439
+ ).refine((a) => a.to === void 0 || a.targets === void 0, { message: "Pass to or targets, not both." })
1440
+ );
1441
+ tool(
1442
+ "time_zones",
1443
+ "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.",
1444
+ {
1445
+ query: z3.string().trim().max(64).optional().describe("Identifier search, e.g. New York or Europe. Spaces and underscores match the same way."),
1446
+ country: z3.string().regex(/^[A-Za-z]{2}$/).optional().describe("ISO2 country association, e.g. US."),
1447
+ area: z3.string().min(1).max(64).optional().describe("IANA identifier prefix, e.g. America."),
1448
+ 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."),
1449
+ 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."),
1450
+ dst: z3.boolean().optional().describe("Whether the rule DST flag is active at the selected instant. Includes negative seasonal adjustments."),
1451
+ observes_dst: z3.boolean().optional().describe("Whether a DST-flagged state occurs during the UTC calendar year containing at."),
1452
+ at: z3.string().min(1).optional().describe("ISO instant for all filters and detailed rows. Default now. Offsetless input means UTC."),
1453
+ details: z3.boolean().optional().describe("Include zones rows with country associations, area, offset, abbreviation and DST facts, plus the common evaluation instant."),
1454
+ sort: z3.enum(["timezone", "offset"]).optional().describe("Order by identifier (default) or actual UTC offset, then identifier.")
1455
+ },
1456
+ (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
1457
  );
962
1458
  tool(
963
1459
  "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-2LCFYIWI.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-2LCFYIWI.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-2LCFYIWI.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.6.0",
4
4
  "mcpName": "com.parseapi/mcp",
5
5
  "description": "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
6
6
  "keywords": [
@@ -50,7 +50,7 @@
50
50
  "dependencies": {
51
51
  "@modelcontextprotocol/server": "^2.0.0",
52
52
  "@modelcontextprotocol/node": "^2.0.0",
53
- "@parseapi/sdk": "^1.5.0",
53
+ "@parseapi/sdk": "^1.6.0",
54
54
  "zod": "^4.0.0"
55
55
  },
56
56
  "devDependencies": {