parseapi-mcp 1.8.0 → 1.9.1

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.
@@ -3,7 +3,7 @@
3
3
  // src/registry.ts
4
4
  import { McpServer } from "@modelcontextprotocol/server";
5
5
  import { parseAPI } from "@parseapi/sdk";
6
- import * as z3 from "zod";
6
+ import * as z4 from "zod";
7
7
 
8
8
  // src/errors.ts
9
9
  import { ParseAPIError } from "@parseapi/sdk";
@@ -834,6 +834,552 @@ var agent_catalog_default = {
834
834
  help: "https://api.parseapi.com/version/2.0.0/time/help",
835
835
  guide: "https://parseapi.com/docs/time"
836
836
  }
837
+ },
838
+ emoji: {
839
+ operation: "emoji",
840
+ endpoint: "GET /emoji/{emoji}",
841
+ determines: [
842
+ "Canonical loaded Unicode emoji for a glyph, qualification form, codepoint sequence, exact name or shortcode",
843
+ "Optional encoding, keywords, variant-family facts and pinned artwork"
844
+ ],
845
+ does_not_determine: [
846
+ "Native font availability on a device",
847
+ "Verified current Slack or Discord platform aliases",
848
+ "User meaning, sentiment or popularity"
849
+ ],
850
+ required_context: [
851
+ "emoji: one complete glyph, codepoint sequence, exact name or shortcode",
852
+ "shortcode_source: optional cldr, github, slack or discord preset",
853
+ "deep=true only when reference detail is needed"
854
+ ],
855
+ freshness: {
856
+ mode: "pinned_reference",
857
+ edition_field: "metadata.edition on catalog/metadata",
858
+ completeness_field: "metadata.completeness on catalog/metadata",
859
+ actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
860
+ },
861
+ uncertainty: {
862
+ deep: {
863
+ omitted: "Not requested."
864
+ },
865
+ "deep.base": {
866
+ omitted: "No available loaded parent variant"
867
+ },
868
+ "deep.artwork": {
869
+ omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
870
+ },
871
+ shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated"
872
+ },
873
+ billing: {
874
+ pooled_requests_per_success: 1,
875
+ deep_extra_units: 0,
876
+ account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
877
+ },
878
+ access: {
879
+ api_key_required: true,
880
+ key_types: [
881
+ "secret",
882
+ "public",
883
+ "app"
884
+ ],
885
+ key_fences: {
886
+ public: "Allowed browser origin required",
887
+ app: "Allowed X-App-Id required"
888
+ },
889
+ deep: {
890
+ entitlement: "Included reference detail on every plan"
891
+ },
892
+ effective_access_status: "Not checked; credential fences, account access and quotas still apply."
893
+ },
894
+ retry: {
895
+ client: "javascript_sdk_and_mcp",
896
+ default_retries: 2,
897
+ retry_http_statuses: [
898
+ 429,
899
+ 500,
900
+ 502,
901
+ 503,
902
+ 504
903
+ ],
904
+ retry_network_errors: true,
905
+ successful_unknown_retried: false,
906
+ guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
907
+ },
908
+ docs: {
909
+ help: "https://api.parseapi.com/version/2.0.0/emoji/help",
910
+ guide: "https://parseapi.com/docs/emoji"
911
+ }
912
+ },
913
+ emoji_search: {
914
+ operation: "emoji_search",
915
+ endpoint: "GET /emoji?q={query}",
916
+ determines: [
917
+ "Ranked label, keyword and shortcode matches in the loaded inventory",
918
+ "Optional collection filters and translated display labels"
919
+ ],
920
+ does_not_determine: [
921
+ "Natural-language understanding or global popularity",
922
+ "Complete translations merely from an accepted language"
923
+ ],
924
+ required_context: [
925
+ "query: 1\u2013256 characters",
926
+ "limit: 1\u201350; offset: 0\u2013100000 when paging is required",
927
+ "Filtered or explicit-offset search returns total and next_offset; legacy plain-query envelope is preserved"
928
+ ],
929
+ freshness: {
930
+ mode: "pinned_reference",
931
+ edition_field: "metadata.edition on catalog/metadata",
932
+ completeness_field: "metadata.completeness on catalog/metadata",
933
+ actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
934
+ },
935
+ uncertainty: {
936
+ deep: {
937
+ omitted: "Not requested."
938
+ },
939
+ "deep.base": {
940
+ omitted: "No available loaded parent variant"
941
+ },
942
+ "deep.artwork": {
943
+ omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
944
+ },
945
+ shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated"
946
+ },
947
+ billing: {
948
+ pooled_requests_per_success: 1,
949
+ deep_extra_units: 0,
950
+ account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
951
+ },
952
+ access: {
953
+ api_key_required: true,
954
+ key_types: [
955
+ "secret",
956
+ "public",
957
+ "app"
958
+ ],
959
+ key_fences: {
960
+ public: "Allowed browser origin required",
961
+ app: "Allowed X-App-Id required"
962
+ },
963
+ deep: {
964
+ entitlement: "Included reference detail on every plan"
965
+ },
966
+ effective_access_status: "Not checked; credential fences, account access and quotas still apply."
967
+ },
968
+ retry: {
969
+ client: "javascript_sdk_and_mcp",
970
+ default_retries: 2,
971
+ retry_http_statuses: [
972
+ 429,
973
+ 500,
974
+ 502,
975
+ 503,
976
+ 504
977
+ ],
978
+ retry_network_errors: true,
979
+ successful_unknown_retried: false,
980
+ guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
981
+ },
982
+ docs: {
983
+ help: "https://api.parseapi.com/version/2.0.0/emoji/help",
984
+ guide: "https://parseapi.com/docs/emoji"
985
+ }
986
+ },
987
+ emoji_browse: {
988
+ operation: "emoji_browse",
989
+ endpoint: "GET /emoji",
990
+ determines: [
991
+ "Catalog-order records in the selected category, subcategory, release, tone scope",
992
+ "Predictable total and next_offset pagination"
993
+ ],
994
+ does_not_determine: [
995
+ "A personalized or popularity-ranked picker"
996
+ ],
997
+ required_context: [
998
+ "Omit q to browse",
999
+ "limit: 1\u201350; offset: 0\u2013100000",
1000
+ "Stop when next_offset is null"
1001
+ ],
1002
+ freshness: {
1003
+ mode: "pinned_reference",
1004
+ edition_field: "metadata.edition on catalog/metadata",
1005
+ completeness_field: "metadata.completeness on catalog/metadata",
1006
+ actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
1007
+ },
1008
+ uncertainty: {
1009
+ deep: {
1010
+ omitted: "Not requested."
1011
+ },
1012
+ "deep.base": {
1013
+ omitted: "No available loaded parent variant"
1014
+ },
1015
+ "deep.artwork": {
1016
+ omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
1017
+ },
1018
+ shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated"
1019
+ },
1020
+ billing: {
1021
+ pooled_requests_per_success: 1,
1022
+ deep_extra_units: 0,
1023
+ account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
1024
+ },
1025
+ access: {
1026
+ api_key_required: true,
1027
+ key_types: [
1028
+ "secret",
1029
+ "public",
1030
+ "app"
1031
+ ],
1032
+ key_fences: {
1033
+ public: "Allowed browser origin required",
1034
+ app: "Allowed X-App-Id required"
1035
+ },
1036
+ deep: {
1037
+ entitlement: "Included reference detail on every plan"
1038
+ },
1039
+ effective_access_status: "Not checked; credential fences, account access and quotas still apply."
1040
+ },
1041
+ retry: {
1042
+ client: "javascript_sdk_and_mcp",
1043
+ default_retries: 2,
1044
+ retry_http_statuses: [
1045
+ 429,
1046
+ 500,
1047
+ 502,
1048
+ 503,
1049
+ 504
1050
+ ],
1051
+ retry_network_errors: true,
1052
+ successful_unknown_retried: false,
1053
+ guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1054
+ },
1055
+ docs: {
1056
+ help: "https://api.parseapi.com/version/2.0.0/emoji/help",
1057
+ guide: "https://parseapi.com/docs/emoji"
1058
+ }
1059
+ },
1060
+ emoji_categories: {
1061
+ operation: "emoji_categories",
1062
+ endpoint: "GET /emoji/categories",
1063
+ determines: [
1064
+ "Loaded category names and subcategory taxonomy"
1065
+ ],
1066
+ does_not_determine: [
1067
+ "Localized category labels",
1068
+ "Categories outside the loaded inventory"
1069
+ ],
1070
+ required_context: [
1071
+ "No required input; category and subcategory filters accept the returned taxonomy"
1072
+ ],
1073
+ freshness: {
1074
+ mode: "pinned_reference",
1075
+ edition_field: "metadata.edition on catalog/metadata",
1076
+ completeness_field: "metadata.completeness on catalog/metadata",
1077
+ actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
1078
+ },
1079
+ billing: {
1080
+ pooled_requests_per_success: 1,
1081
+ account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
1082
+ },
1083
+ access: {
1084
+ api_key_required: true,
1085
+ key_types: [
1086
+ "secret",
1087
+ "public",
1088
+ "app"
1089
+ ],
1090
+ key_fences: {
1091
+ public: "Allowed browser origin required",
1092
+ app: "Allowed X-App-Id required"
1093
+ },
1094
+ effective_access_status: "Not checked; credential fences, account access and quotas still apply."
1095
+ },
1096
+ retry: {
1097
+ client: "javascript_sdk_and_mcp",
1098
+ default_retries: 2,
1099
+ retry_http_statuses: [
1100
+ 429,
1101
+ 500,
1102
+ 502,
1103
+ 503,
1104
+ 504
1105
+ ],
1106
+ retry_network_errors: true,
1107
+ successful_unknown_retried: false,
1108
+ guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1109
+ },
1110
+ docs: {
1111
+ help: "https://api.parseapi.com/version/2.0.0/emoji/help",
1112
+ guide: "https://parseapi.com/docs/emoji"
1113
+ }
1114
+ },
1115
+ emoji_metadata: {
1116
+ operation: "emoji_metadata",
1117
+ endpoint: "GET /emoji/metadata",
1118
+ determines: [
1119
+ "Loaded inventory total, source edition, official-source completeness and provenance",
1120
+ "Loaded artwork coverage, source licenses and notices"
1121
+ ],
1122
+ does_not_determine: [
1123
+ "A guarantee that every upstream artwork source supports the newest Unicode release",
1124
+ "Account entitlement or a monetary quote"
1125
+ ],
1126
+ required_context: [
1127
+ "No required input",
1128
+ "The API and MCP return the same metadata; data notices are embedded and artwork notice files are linked"
1129
+ ],
1130
+ freshness: {
1131
+ mode: "pinned_reference",
1132
+ edition_field: "metadata.edition on catalog/metadata",
1133
+ completeness_field: "metadata.completeness on catalog/metadata",
1134
+ actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
1135
+ },
1136
+ billing: {
1137
+ pooled_requests_per_success: 1,
1138
+ account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
1139
+ },
1140
+ access: {
1141
+ api_key_required: true,
1142
+ key_types: [
1143
+ "secret",
1144
+ "public",
1145
+ "app"
1146
+ ],
1147
+ key_fences: {
1148
+ public: "Allowed browser origin required",
1149
+ app: "Allowed X-App-Id required"
1150
+ },
1151
+ effective_access_status: "Not checked; credential fences, account access and quotas still apply."
1152
+ },
1153
+ retry: {
1154
+ client: "javascript_sdk_and_mcp",
1155
+ default_retries: 2,
1156
+ retry_http_statuses: [
1157
+ 429,
1158
+ 500,
1159
+ 502,
1160
+ 503,
1161
+ 504
1162
+ ],
1163
+ retry_network_errors: true,
1164
+ successful_unknown_retried: false,
1165
+ guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1166
+ },
1167
+ docs: {
1168
+ help: "https://api.parseapi.com/version/2.0.0/emoji/help",
1169
+ guide: "https://parseapi.com/docs/emoji"
1170
+ }
1171
+ },
1172
+ emoji_catalog: {
1173
+ operation: "emoji_catalog",
1174
+ endpoint: "GET /emoji/catalog",
1175
+ determines: [
1176
+ "Downloadable JSON records within explicit inventory scope",
1177
+ "JSON qualification maps, source aliases, legacy winners and native search facts for offline clients"
1178
+ ],
1179
+ does_not_determine: [
1180
+ "A full catalog embedded in MCP model context",
1181
+ "A translated label for every row merely from a supported locale"
1182
+ ],
1183
+ required_context: [
1184
+ "JSON compact profile by default; profile=full includes artwork and encoding detail",
1185
+ "Optional filters and language; download_url requires an authenticated HTTP request",
1186
+ "Compact is the default; request profile=full for artwork. MCP metadata describes the complete inventory; the downloaded file supplies the selected total and scope."
1187
+ ],
1188
+ freshness: {
1189
+ mode: "pinned_reference",
1190
+ edition_field: "metadata.edition on catalog/metadata",
1191
+ completeness_field: "metadata.completeness on catalog/metadata",
1192
+ actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
1193
+ },
1194
+ uncertainty: {
1195
+ deep: {
1196
+ omitted: "Not requested."
1197
+ },
1198
+ "deep.base": {
1199
+ omitted: "No available loaded parent variant"
1200
+ },
1201
+ "deep.artwork": {
1202
+ omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
1203
+ },
1204
+ shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated"
1205
+ },
1206
+ billing: {
1207
+ pooled_requests_per_success: 1,
1208
+ deep_extra_units: 0,
1209
+ account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated",
1210
+ mcp_pooled_requests_per_success: 1,
1211
+ mcp_behavior: "One metadata read. Following download_url performs one separate pooled request; local operations use no pooled requests.",
1212
+ offline_operations_extra_units: 0
1213
+ },
1214
+ access: {
1215
+ api_key_required: true,
1216
+ key_types: [
1217
+ "secret",
1218
+ "public",
1219
+ "app"
1220
+ ],
1221
+ key_fences: {
1222
+ public: "Allowed browser origin required",
1223
+ app: "Allowed X-App-Id required"
1224
+ },
1225
+ deep: {
1226
+ entitlement: "Included reference detail on every plan"
1227
+ },
1228
+ effective_access_status: "Not checked; credential fences, account access and quotas still apply."
1229
+ },
1230
+ retry: {
1231
+ client: "javascript_sdk_and_mcp",
1232
+ default_retries: 2,
1233
+ retry_http_statuses: [
1234
+ 429,
1235
+ 500,
1236
+ 502,
1237
+ 503,
1238
+ 504
1239
+ ],
1240
+ retry_network_errors: true,
1241
+ successful_unknown_retried: false,
1242
+ guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1243
+ },
1244
+ docs: {
1245
+ help: "https://api.parseapi.com/version/2.0.0/emoji/help",
1246
+ guide: "https://parseapi.com/docs/emoji"
1247
+ }
1248
+ },
1249
+ emoji_parse: {
1250
+ operation: "emoji_parse",
1251
+ endpoint: "POST /emoji/parse",
1252
+ determines: [
1253
+ "Complete loaded Unicode graphemes, grouped in first-occurrence order",
1254
+ "Every occurrence as original UTF-16 positions with exclusive end"
1255
+ ],
1256
+ does_not_determine: [
1257
+ "Shortcode decoding",
1258
+ "Partial matches inside unsupported joined graphemes",
1259
+ "Sentiment, intent or native font support"
1260
+ ],
1261
+ required_context: [
1262
+ "text: JSON body string, maximum 16000 UTF-16 code units",
1263
+ "Positions use UTF-16 code units and exclusive end; they are not codepoint or byte offsets"
1264
+ ],
1265
+ freshness: {
1266
+ mode: "pinned_reference",
1267
+ edition_field: "metadata.edition on catalog/metadata",
1268
+ completeness_field: "metadata.completeness on catalog/metadata",
1269
+ actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
1270
+ },
1271
+ uncertainty: {
1272
+ deep: {
1273
+ omitted: "Not requested."
1274
+ },
1275
+ "deep.base": {
1276
+ omitted: "No available loaded parent variant"
1277
+ },
1278
+ "deep.artwork": {
1279
+ omitted_style: "Within an explicitly returned artwork object, the style has no verified asset for this glyph. Compact catalog records deliberately omit artwork."
1280
+ }
1281
+ },
1282
+ billing: {
1283
+ pooled_requests_per_success: 1,
1284
+ deep_extra_units: 0,
1285
+ account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
1286
+ },
1287
+ access: {
1288
+ api_key_required: true,
1289
+ key_types: [
1290
+ "secret",
1291
+ "public",
1292
+ "app"
1293
+ ],
1294
+ key_fences: {
1295
+ public: "Allowed browser origin required",
1296
+ app: "Allowed X-App-Id required"
1297
+ },
1298
+ deep: {
1299
+ entitlement: "Included reference detail on every plan"
1300
+ },
1301
+ effective_access_status: "Not checked; credential fences, account access and quotas still apply."
1302
+ },
1303
+ retry: {
1304
+ client: "javascript_sdk_and_mcp",
1305
+ default_retries: 2,
1306
+ retry_http_statuses: [
1307
+ 429,
1308
+ 500,
1309
+ 502,
1310
+ 503,
1311
+ 504
1312
+ ],
1313
+ retry_network_errors: true,
1314
+ successful_unknown_retried: false,
1315
+ guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1316
+ },
1317
+ docs: {
1318
+ help: "https://api.parseapi.com/version/2.0.0/emoji/help",
1319
+ guide: "https://parseapi.com/docs/emoji"
1320
+ }
1321
+ },
1322
+ emoji_convert: {
1323
+ operation: "emoji_convert",
1324
+ endpoint: "POST /emoji/convert",
1325
+ determines: [
1326
+ "Converted text using an explicitly named shortcode preset",
1327
+ "Unresolved tokens with original UTF-16 offsets and specific reasons"
1328
+ ],
1329
+ does_not_determine: [
1330
+ "Invented aliases for unsupported releases",
1331
+ "Replacement of unknown or ambiguous literal input"
1332
+ ],
1333
+ required_context: [
1334
+ "text: JSON body string, maximum 16000 UTF-16 code units",
1335
+ "direction: to_shortcodes or to_emoji",
1336
+ "shortcode_source: required cldr, github, slack or discord"
1337
+ ],
1338
+ freshness: {
1339
+ mode: "pinned_reference",
1340
+ edition_field: "metadata.edition on catalog/metadata",
1341
+ completeness_field: "metadata.completeness on catalog/metadata",
1342
+ actual_age_status: "Not exposed; a pinned source revision does not establish observation age."
1343
+ },
1344
+ uncertainty: {
1345
+ shortcode_source: "Named presets have explicit provenance and compatibility caveats; missing or ambiguous aliases are not fabricated",
1346
+ unresolved: "Unknown, ambiguous or unavailable tokens remain literal; each unresolved token includes its reason and original UTF-16 positions."
1347
+ },
1348
+ billing: {
1349
+ pooled_requests_per_success: 1,
1350
+ account_state: "unknown; account allowance, credentials, quotas and accepted terms are not evaluated"
1351
+ },
1352
+ access: {
1353
+ api_key_required: true,
1354
+ key_types: [
1355
+ "secret",
1356
+ "public",
1357
+ "app"
1358
+ ],
1359
+ key_fences: {
1360
+ public: "Allowed browser origin required",
1361
+ app: "Allowed X-App-Id required"
1362
+ },
1363
+ effective_access_status: "Not checked; credential fences, account access and quotas still apply."
1364
+ },
1365
+ retry: {
1366
+ client: "javascript_sdk_and_mcp",
1367
+ default_retries: 2,
1368
+ retry_http_statuses: [
1369
+ 429,
1370
+ 500,
1371
+ 502,
1372
+ 503,
1373
+ 504
1374
+ ],
1375
+ retry_network_errors: true,
1376
+ successful_unknown_retried: false,
1377
+ guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
1378
+ },
1379
+ docs: {
1380
+ help: "https://api.parseapi.com/version/2.0.0/emoji/help",
1381
+ guide: "https://parseapi.com/docs/emoji"
1382
+ }
837
1383
  }
838
1384
  }
839
1385
  };
@@ -932,9 +1478,9 @@ function registerDiscovery(server, operations, mode, apiVersion) {
932
1478
 
933
1479
  // src/preflight.ts
934
1480
  import * as z2 from "zod";
935
- var task = z2.strictObject({
1481
+ var preflightTaskSchema = z2.strictObject({
936
1482
  operations: z2.array(z2.strictObject({
937
- operation: z2.enum(["email", "domain", "dns", "mx", "country"]),
1483
+ operation: z2.enum(["email", "domain", "dns", "mx", "country", "vat", "carrier", "caller", "hlr", "ip", "phone", "postal"]),
938
1484
  count: z2.number().int().min(1).max(1e5),
939
1485
  deep: z2.boolean().optional()
940
1486
  })).min(1).max(20).refine((items) => items.reduce((sum, item) => sum + item.count, 0) <= 1e5, {
@@ -945,8 +1491,8 @@ var task = z2.strictObject({
945
1491
  function registerPreflight(server, client, transport) {
946
1492
  server.registerTool("preflight", {
947
1493
  title: "Estimate ParseAPI task usage",
948
- description: "Estimate whether your secret key permits a proposed Email, Domain, DNS, MX or Country task, its advisory capacity, and additional USD charges under accepted terms. Supply operation counts and optional Deep, without lookup inputs. Uses default SDK retries: up to three attempts per ordinary lookup and one per Email Deep lookup. Authenticated metadata request, no lookup units or paid checks. Reserves no units or money and does not enforce a budget. Check permitted, cost.status, capacity and budget before lookup.",
949
- inputSchema: task,
1494
+ description: "Estimate whether your secret key permits a proposed Email, VAT, Carrier, Caller, HLR, Domain, DNS, MX, Country, IP, Phone or Postal task, its advisory capacity, and additional USD charges under accepted terms. Supply operation counts and optional Deep, without lookup inputs. Uses default SDK retries: up to three attempts per ordinary lookup and one per metered lookup. Authenticated metadata request, no lookup units or paid checks. Reserves no units or money and does not enforce a budget. Check permitted, cost.status, capacity and budget before lookup.",
1495
+ inputSchema: preflightTaskSchema,
950
1496
  annotations: { readOnlyHint: true, idempotentHint: true }
951
1497
  }, async (args, context) => {
952
1498
  if (!client) return noKeyResult(transport);
@@ -959,18 +1505,65 @@ function registerPreflight(server, client, transport) {
959
1505
  });
960
1506
  }
961
1507
 
1508
+ // src/task.ts
1509
+ import * as z3 from "zod";
1510
+ function registerTasks(server, client, transport) {
1511
+ const id = z3.string().regex(/^task_[a-f0-9]{40}$/);
1512
+ const requestId = z3.string().regex(/^[A-Za-z0-9._:-]{1,128}$/).describe("Unique ID for the intended request. Reuse this exact ID and inputs on every retry. Never include private lookup values in it.");
1513
+ const call = async (action) => {
1514
+ if (!client) return noKeyResult(transport);
1515
+ try {
1516
+ const data = await action();
1517
+ return { ...ok(data), structuredContent: data };
1518
+ } catch (error) {
1519
+ return toErrorResult(error);
1520
+ }
1521
+ };
1522
+ server.registerTool("task_create", {
1523
+ title: "Authorize a bounded task",
1524
+ description: "Create a 24-hour task with allowed operations, lookup counts and an enforced USD limit on additional lookup charges. Requires already authorized user scope and a secret key. Reserves no account units and makes no lookups. Only task_lookup obeys this task budget. Ordinary lookups remain separate. Included units can make actual cost zero, but a positive-rate lookup needs budget room for its conservative full rate.",
1525
+ inputSchema: preflightTaskSchema.safeExtend({ budget_usd: z3.string().regex(/^(?:0|[1-9]\d{0,6})(?:\.\d{1,2})?$/), request_id: requestId }).refine((args) => args.operations.reduce((sum, op) => sum + op.count, 0) <= 1e3, { message: "A task can authorize at most 1000 lookups." }).refine((args) => Number(args.budget_usd) <= 1e6, { message: "The task budget cannot exceed 1000000 USD." }),
1526
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true }
1527
+ }, (args, context) => call(() => client.task({ operations: args.operations, budget_usd: args.budget_usd }, args.request_id, { signal: context.mcpReq.signal })));
1528
+ server.registerTool("task_status", {
1529
+ title: "Read task budget and progress",
1530
+ description: "Read completed and allocated lookup counts, spent and reserved USD budget and expiry. No lookup or usage unit.",
1531
+ inputSchema: z3.strictObject({ task_id: id }),
1532
+ annotations: { readOnlyHint: true, idempotentHint: true }
1533
+ }, (args, context) => call(() => client.task.get(args.task_id, { signal: context.mcpReq.signal })));
1534
+ server.registerTool("task_cancel", {
1535
+ title: "Cancel remaining task work",
1536
+ description: "Prevent new lookups in this task. Already started lookups may finish and incur their reserved charge. Saved results remain recoverable.",
1537
+ inputSchema: z3.strictObject({ task_id: id }),
1538
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true }
1539
+ }, (args, context) => call(() => client.task.cancel(args.task_id, { signal: context.mcpReq.signal })));
1540
+ server.registerTool("task_lookup", {
1541
+ title: "Run or recover a bounded lookup",
1542
+ description: "Run one lookup under an authorized task budget and count. Reuse request_id with identical inputs to recover its saved response without another lookup or usage charge. Inspect status_code and result, including nulls. task_in_progress or task_outcome_unknown means keep the same request_id; never use a new ID to repeat uncertain work. Saved results are available for 48 hours from task creation. This tool can consume pooled and metered units on its first execution.",
1543
+ inputSchema: z3.strictObject({
1544
+ task_id: id,
1545
+ request_id: requestId,
1546
+ operation: z3.enum(["email", "vat", "carrier", "caller", "hlr", "domain", "dns", "mx", "country", "ip", "phone", "postal"]),
1547
+ value: z3.string().min(1).max(2048),
1548
+ country: z3.string().regex(/^[A-Za-z]{2}$/).optional(),
1549
+ deep: z3.boolean().optional()
1550
+ }),
1551
+ annotations: { readOnlyHint: true, idempotentHint: true }
1552
+ }, ({ task_id, request_id, ...input }, context) => call(() => client.task.lookup(task_id, input, request_id, { signal: context.mcpReq.signal })));
1553
+ }
1554
+
962
1555
  // src/registry.ts
963
- var VERSION = "1.8.0";
1556
+ var VERSION = "1.9.0";
964
1557
  var API_VERSION = "2.0.0";
965
1558
  var US_ROUTING_NOTICE = "Routing reference attribution: https://parseapi.com/legal/attribution#routing-numbers";
966
1559
  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";
967
- var deep = z3.boolean().optional().describe("Include the nested deep object when available. Pricing depends on the operation.");
968
- var lat = z3.number().min(-90).max(90).describe("Latitude in decimal degrees");
969
- var lon = z3.number().min(-180).max(180).describe("Longitude in decimal degrees");
970
- var iso2 = (what) => z3.string().describe(`ISO 3166-1 alpha-2 ${what}, e.g. US`);
971
- var tariffEdition = z3.string().regex(/^[a-f0-9]{64}$/).optional().describe("Exact immutable edition fingerprint. Without date, returns undated schedule context.");
972
- var tariffDate = z3.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("YYYY-MM-DD with verified source coverage. Combine with edition only when it covers this date.");
973
- var countryOpt = z3.string().optional().describe("ISO2, ISO3, or a country name. Optional when the lookup is unique.");
1560
+ var deep = z4.boolean().optional().describe("Include the nested deep object when available. Pricing depends on the operation.");
1561
+ var lat = z4.number().min(-90).max(90).describe("Latitude in decimal degrees");
1562
+ var lon = z4.number().min(-180).max(180).describe("Longitude in decimal degrees");
1563
+ var iso2 = (what) => z4.string().describe(`ISO 3166-1 alpha-2 ${what}, e.g. US`);
1564
+ var tariffEdition = z4.string().regex(/^[a-f0-9]{64}$/).optional().describe("Exact immutable edition fingerprint. Without date, returns undated schedule context.");
1565
+ var tariffDate = z4.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("YYYY-MM-DD with verified source coverage. Combine with edition only when it covers this date.");
1566
+ var countryOpt = z4.string().optional().describe("ISO2, ISO3, or a country name. Optional when the lookup is unique.");
974
1567
  var titleWords = {
975
1568
  ip: "IP",
976
1569
  asn: "ASN",
@@ -1021,9 +1614,22 @@ var languageTools = /* @__PURE__ */ new Set([
1021
1614
  "measure_units",
1022
1615
  "emoji",
1023
1616
  "emoji_search",
1617
+ "emoji_browse",
1618
+ "emoji_parse",
1619
+ "emoji_catalog",
1024
1620
  "point"
1025
1621
  ]);
1026
- var displayLanguage = z3.string().min(2).max(64).optional().describe("Optional display language, such as fr or zh-Hant. IDs, numeric values and input parsing stay unchanged.");
1622
+ var displayLanguage = z4.string().min(2).max(64).optional().describe("Optional display language, such as fr or zh-Hant. IDs, numeric values and input parsing stay unchanged.");
1623
+ var emojiFilters = {
1624
+ limit: z4.number().int().min(1).max(50).optional().describe("Maximum results per page."),
1625
+ category: z4.string().optional().describe("Category from emoji_categories."),
1626
+ subcategory: z4.string().optional().describe("Subcategory from emoji_categories."),
1627
+ version: z4.string().optional().describe("Exact Emoji release version, such as 17.0."),
1628
+ max_version: z4.string().optional().describe("Latest Emoji release to include, such as 16.0."),
1629
+ include_skin_tones: z4.boolean().optional().describe("Include skin-tone variants. Explicit false excludes them."),
1630
+ offset: z4.number().int().min(0).max(1e5).optional().describe("Page offset. Reuse next_offset with the same filters."),
1631
+ deep: deep.describe("Include optional reference detail on every plan.")
1632
+ };
1027
1633
  function buildServer(key, transport, options = {}) {
1028
1634
  const mode = options.mode ?? "full";
1029
1635
  if (mode !== "full" && mode !== "compact") throw new Error("Unknown MCP catalog mode");
@@ -1048,7 +1654,7 @@ function buildServer(key, transport, options = {}) {
1048
1654
  }) : null;
1049
1655
  function tool(name, description, shape, fn, refine) {
1050
1656
  const localized = languageTools.has(name);
1051
- const input = z3.object(localized ? { ...shape, lang: displayLanguage } : shape);
1657
+ const input = z4.object(localized ? { ...shape, lang: displayLanguage } : shape);
1052
1658
  const schema = refine ? refine(input) : input;
1053
1659
  const invoke = async (args, signal) => {
1054
1660
  if (!parse) return noKeyResult(transport);
@@ -1088,10 +1694,10 @@ function buildServer(key, transport, options = {}) {
1088
1694
  "measure",
1089
1695
  "Parse a measurement or convert it to a target unit. Supports mixed measurements such as 5 ft 11 in. Amount is a decimal string. Without to, returns the canonical unit for its type. Ambiguous input returns valid false, reason and choices. Use measure_units to discover accepted units. Pooled request, no separate check charge.",
1090
1696
  {
1091
- measure: z3.string().min(1).max(256).describe("Measurement to parse, e.g. 5 ft 11 in or 10 kg"),
1092
- to: z3.string().min(1).max(128).optional().describe("Target unit, e.g. cm or lb"),
1093
- locale: z3.string().min(1).max(32).optional().describe("Explicit number locale, e.g. de-DE"),
1094
- system: z3.enum(["us", "imperial"]).optional().describe("Resolve an ambiguous customary unit using the stated system")
1697
+ measure: z4.string().min(1).max(256).describe("Measurement to parse, e.g. 5 ft 11 in or 10 kg"),
1698
+ to: z4.string().min(1).max(128).optional().describe("Target unit, e.g. cm or lb"),
1699
+ locale: z4.string().min(1).max(32).optional().describe("Explicit number locale, e.g. de-DE"),
1700
+ system: z4.enum(["us", "imperial"]).optional().describe("Resolve an ambiguous customary unit using the stated system")
1095
1701
  },
1096
1702
  (c, a, request) => c.measure(a.measure, { ...request, to: a.to, locale: a.locale, system: a.system })
1097
1703
  );
@@ -1099,16 +1705,16 @@ function buildServer(key, transport, options = {}) {
1099
1705
  "measure_units",
1100
1706
  "Discover the reviewed measurement units, canonical codes, types and aliases. With no filters, returns the full catalog. Pass unit to find compatible conversion targets. Combine query and type to narrow results.",
1101
1707
  {
1102
- query: z3.string().max(128).optional().describe("Search text, e.g. foot"),
1103
- type: z3.string().min(1).max(64).optional().describe("Measurement type, e.g. length"),
1104
- unit: z3.string().min(1).max(128).optional().describe("Return units compatible with this unit, e.g. m")
1708
+ query: z4.string().max(128).optional().describe("Search text, e.g. foot"),
1709
+ type: z4.string().min(1).max(64).optional().describe("Measurement type, e.g. length"),
1710
+ unit: z4.string().min(1).max(128).optional().describe("Return units compatible with this unit, e.g. m")
1105
1711
  },
1106
1712
  (c, a, request) => c.measure.units({ ...request, query: a.query, type: a.type, unit: a.unit })
1107
1713
  );
1108
1714
  tool(
1109
1715
  "ip",
1110
1716
  "Look up an IPv4 or IPv6 address: country, region, ASN, timezone. Deep adds datacenter, relay, tor and vpn flags.",
1111
- { ip: z3.string().describe("IPv4 or IPv6 address, e.g. 8.8.8.8"), deep },
1717
+ { ip: z4.string().describe("IPv4 or IPv6 address, e.g. 8.8.8.8"), deep },
1112
1718
  (c, a, request) => c.ip(a.ip, { ...request, deep: a.deep })
1113
1719
  );
1114
1720
  if (transport === "stdio") {
@@ -1122,20 +1728,20 @@ function buildServer(key, transport, options = {}) {
1122
1728
  tool(
1123
1729
  "continent",
1124
1730
  "Look up a continent by code: name, area and population.",
1125
- { code: z3.string().describe("Continent code: AF, AN, AS, EU, NA, OC, SA") },
1731
+ { code: z4.string().describe("Continent code: AF, AN, AS, EU, NA, OC, SA") },
1126
1732
  (c, a, request) => c.continent(a.code, request)
1127
1733
  );
1128
1734
  tool(
1129
1735
  "continent_countries",
1130
1736
  "List every country on a continent.",
1131
- { code: z3.string().describe("Continent code: AF, AN, AS, EU, NA, OC, SA") },
1737
+ { code: z4.string().describe("Continent code: AF, AN, AS, EU, NA, OC, SA") },
1132
1738
  (c, a, request) => c.continent.countries(a.code, request)
1133
1739
  );
1134
1740
  tool(
1135
1741
  "bloc",
1136
1742
  "Look up a country group by code: EU, EEA, Schengen, Eurozone, SEPA, NATO, and more. Returns the official name and the current member count.",
1137
1743
  {
1138
- code: z3.string().describe("Bloc code: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR")
1744
+ code: z4.string().describe("Bloc code: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR")
1139
1745
  },
1140
1746
  (c, a, request) => c.bloc(a.code, request)
1141
1747
  );
@@ -1143,7 +1749,7 @@ function buildServer(key, transport, options = {}) {
1143
1749
  "bloc_countries",
1144
1750
  "List the current members of a country group, each with name, flag, and calling code.",
1145
1751
  {
1146
- code: z3.string().describe("Bloc code: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR")
1752
+ code: z4.string().describe("Bloc code: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR")
1147
1753
  },
1148
1754
  (c, a, request) => c.bloc.countries(a.code, request)
1149
1755
  );
@@ -1163,7 +1769,7 @@ function buildServer(key, transport, options = {}) {
1163
1769
  "state",
1164
1770
  "Look up a state or province by code or name. Deep adds its demographic and tax profile on paid plans, including population_period when verified. Pass country to resolve a colliding code.",
1165
1771
  {
1166
- code: z3.string().describe("State code or name, e.g. colorado, NC"),
1772
+ code: z4.string().describe("State code or name, e.g. colorado, NC"),
1167
1773
  country: countryOpt,
1168
1774
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1169
1775
  },
@@ -1173,7 +1779,7 @@ function buildServer(key, transport, options = {}) {
1173
1779
  "state_districts",
1174
1780
  "List the districts, counties or departments of a state. Deep adds population and its reporting period to each result on paid plans.",
1175
1781
  {
1176
- code: z3.string().describe("State code or name, e.g. NC, colorado"),
1782
+ code: z4.string().describe("State code or name, e.g. NC, colorado"),
1177
1783
  country: countryOpt,
1178
1784
  deep: deep.describe("Include population and its reporting period in each district detail bag on a paid plan.")
1179
1785
  },
@@ -1183,9 +1789,9 @@ function buildServer(key, transport, options = {}) {
1183
1789
  "district",
1184
1790
  "Look up a district, county or department by code or name. Deep adds area, population and seat on paid plans. Pass state to resolve a colliding name. Population includes a reporting year or period when verified. Paid deep property_tax contains annual_median, currency and period: median annual tax payable on owner-occupied homes in the area, adjusted to the final year of that period. It is not a rate or property bill. Unsupported, missing and censored estimates are null.",
1185
1791
  {
1186
- code: z3.string().describe("District code or name, e.g. 37081, guilford county"),
1792
+ code: z4.string().describe("District code or name, e.g. 37081, guilford county"),
1187
1793
  country: countryOpt,
1188
- state: z3.string().optional().describe("ADM1 code or name to disambiguate, e.g. NC or louisiana"),
1794
+ state: z4.string().optional().describe("ADM1 code or name to disambiguate, e.g. NC or louisiana"),
1189
1795
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1190
1796
  },
1191
1797
  (c, a, request) => c.district(a.code, { ...request, deep: a.deep, country: a.country, state: a.state })
@@ -1194,9 +1800,9 @@ function buildServer(key, transport, options = {}) {
1194
1800
  "city",
1195
1801
  "Resolve a city name to coordinates, timezone and administrative context. Deep adds demographic and geographic detail on paid plans. Pass country or state for name ties. Population includes a reporting year or period when verified.",
1196
1802
  {
1197
- name: z3.string().describe("City name, e.g. charlotte"),
1803
+ name: z4.string().describe("City name, e.g. charlotte"),
1198
1804
  country: countryOpt,
1199
- state: z3.string().optional().describe("State code to disambiguate, e.g. NC"),
1805
+ state: z4.string().optional().describe("State code to disambiguate, e.g. NC"),
1200
1806
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1201
1807
  },
1202
1808
  (c, a, request) => c.city(a.name, { ...request, deep: a.deep, country: a.country, state: a.state })
@@ -1204,17 +1810,17 @@ function buildServer(key, transport, options = {}) {
1204
1810
  tool(
1205
1811
  "city_id",
1206
1812
  "Resolve a stable city id. Deep adds the city profile on paid plans.",
1207
- { id: z3.string().describe("Stable city id, e.g. city_mb8mbqrkz8zb"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
1813
+ { id: z4.string().describe("Stable city id, e.g. city_mb8mbqrkz8zb"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
1208
1814
  (c, a, request) => c.city.id(a.id, { ...request, deep: a.deep })
1209
1815
  );
1210
1816
  tool(
1211
1817
  "city_search",
1212
1818
  "Search city names. Deep adds the profile inside each returned city on paid plans.",
1213
1819
  {
1214
- query: z3.string().describe("Name prefix, e.g. char"),
1820
+ query: z4.string().describe("Name prefix, e.g. char"),
1215
1821
  country: countryOpt,
1216
- state: z3.string().optional().describe("State code filter"),
1217
- limit: z3.number().int().min(1).max(50).optional().describe("Max results"),
1822
+ state: z4.string().optional().describe("State code filter"),
1823
+ limit: z4.number().int().min(1).max(50).optional().describe("Max results"),
1218
1824
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1219
1825
  },
1220
1826
  (c, a, request) => c.city.search(a.query, { ...request, deep: a.deep, country: a.country, state: a.state, limit: a.limit })
@@ -1229,12 +1835,12 @@ function buildServer(key, transport, options = {}) {
1229
1835
  "city_nearby",
1230
1836
  "Find nearby cities with distances. Deep adds the profile inside each returned city on paid plans.",
1231
1837
  {
1232
- name: z3.string().describe("Anchor city name, e.g. denver"),
1838
+ name: z4.string().describe("Anchor city name, e.g. denver"),
1233
1839
  country: countryOpt,
1234
- state: z3.string().optional().describe("State code to disambiguate the anchor"),
1235
- radius: z3.number().positive().optional().describe("Search radius, default 40 km"),
1236
- unit: z3.enum(["km", "mi"]).optional().describe("Radius unit, default km"),
1237
- limit: z3.number().int().min(1).max(50).optional().describe("Max results, default 10"),
1840
+ state: z4.string().optional().describe("State code to disambiguate the anchor"),
1841
+ radius: z4.number().positive().optional().describe("Search radius, default 40 km"),
1842
+ unit: z4.enum(["km", "mi"]).optional().describe("Radius unit, default km"),
1843
+ limit: z4.number().int().min(1).max(50).optional().describe("Max results, default 10"),
1238
1844
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1239
1845
  },
1240
1846
  (c, a, request) => c.city.nearby(a.name, {
@@ -1251,7 +1857,7 @@ function buildServer(key, transport, options = {}) {
1251
1857
  "postal",
1252
1858
  "Resolve a postal code to its place, coordinates and timezone. Australian core localities lists suburb choices with city, state and state_name. Null or missing means unknown, and [] means no eligible choices in the reviewed reference. A single choice can coexist with city null, so do not infer a city or a user selection. These are geographic choices, not mailing-address verification. Deep adds area, population with its reporting period, tax references, neighbors and metro associations on paid plans. property_tax is a nullable area statistic with annual_median, currency and period: median annual tax payable on owner-occupied homes, adjusted to the final year of the period. It is not a rate or property bill. Unsupported, missing and censored estimates are null. Tax rates are percentages and alternative geographic references, not additive.",
1253
1859
  {
1254
- code: z3.string().describe("Postal or ZIP code, e.g. SW1A 1AA, 28202"),
1860
+ code: z4.string().describe("Postal or ZIP code, e.g. SW1A 1AA, 28202"),
1255
1861
  country: countryOpt,
1256
1862
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1257
1863
  },
@@ -1261,10 +1867,10 @@ function buildServer(key, transport, options = {}) {
1261
1867
  "postal_nearby",
1262
1868
  "Find nearby postal codes with distances. Deep adds metropolitan associations to the origin and each result on paid plans.",
1263
1869
  {
1264
- code: z3.string().describe("Postal code to search around"),
1870
+ code: z4.string().describe("Postal code to search around"),
1265
1871
  country: countryOpt,
1266
- radius: z3.number().positive().optional().describe("Search radius"),
1267
- unit: z3.enum(["km", "mi"]).optional().describe("Radius unit, default km"),
1872
+ radius: z4.number().positive().optional().describe("Search radius"),
1873
+ unit: z4.enum(["km", "mi"]).optional().describe("Radius unit, default km"),
1268
1874
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1269
1875
  },
1270
1876
  (c, a, request) => c.postal.nearby(a.code, { ...request, deep: a.deep, country: a.country, radius: a.radius, unit: a.unit })
@@ -1273,8 +1879,8 @@ function buildServer(key, transport, options = {}) {
1273
1879
  "postal_distance",
1274
1880
  "Distance between two postal codes. Deep adds metropolitan associations inside each endpoint on paid plans.",
1275
1881
  {
1276
- from: z3.string().describe("First postal code"),
1277
- to: z3.string().describe("Second postal code"),
1882
+ from: z4.string().describe("First postal code"),
1883
+ to: z4.string().describe("Second postal code"),
1278
1884
  country: countryOpt,
1279
1885
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1280
1886
  },
@@ -1284,8 +1890,8 @@ function buildServer(key, transport, options = {}) {
1284
1890
  "address",
1285
1891
  "Look up a US or French street address: house number, street, unit, city, state, postal code and registration status. Registration does not establish deliverability or verify an apartment. Deep is currently an empty object.",
1286
1892
  {
1287
- address: z3.string().describe("Street address, e.g. 1600 Pennsylvania Ave NW, Washington, DC 20500"),
1288
- country: z3.string().optional().describe("Country: US or FR. Use FR or a written France suffix for France. Defaults to US."),
1893
+ address: z4.string().describe("Street address, e.g. 1600 Pennsylvania Ave NW, Washington, DC 20500"),
1894
+ country: z4.string().optional().describe("Country: US or FR. Use FR or a written France suffix for France. Defaults to US."),
1289
1895
  deep
1290
1896
  },
1291
1897
  (c, a, request) => c.address(a.address, { ...request, country: a.country, deep: a.deep })
@@ -1294,12 +1900,12 @@ function buildServer(key, transport, options = {}) {
1294
1900
  "address_search",
1295
1901
  "Search street addresses from a partial address. Prefer postal, or city and state, from the form. An optional end-user IP hints at locality. Empty results explain themselves with reason: more_input, missing_context or no_matches. With suggestions reason is null. Operational failures use API errors. French search requires country FR and either postal or city.",
1296
1902
  {
1297
- query: z3.string().describe("Partial street address, e.g. 1600 Pennsylvania"),
1298
- country: z3.string().optional().describe("Country: US or FR. Defaults to US."),
1299
- postal: z3.string().optional().describe("Postal code from the address form, preferred for locality context"),
1300
- city: z3.string().optional().describe("City filter"),
1301
- state: z3.string().optional().describe("State code filter"),
1302
- ip: z3.string().optional().describe("End-user IP locality hint for server-side calls. Prefer explicit form context.")
1903
+ query: z4.string().describe("Partial street address, e.g. 1600 Pennsylvania"),
1904
+ country: z4.string().optional().describe("Country: US or FR. Defaults to US."),
1905
+ postal: z4.string().optional().describe("Postal code from the address form, preferred for locality context"),
1906
+ city: z4.string().optional().describe("City filter"),
1907
+ state: z4.string().optional().describe("State code filter"),
1908
+ ip: z4.string().optional().describe("End-user IP locality hint for server-side calls. Prefer explicit form context.")
1303
1909
  },
1304
1910
  (c, a, request) => c.address.search(a.query, { ...request, country: a.country, postal: a.postal, city: a.city, state: a.state, ip: a.ip })
1305
1911
  );
@@ -1307,7 +1913,7 @@ function buildServer(key, transport, options = {}) {
1307
1913
  "company",
1308
1914
  "Parse a company number and its registered identity, status and address. Paid deep adds business activity and associated identifiers. Geography lookups are separate calls.",
1309
1915
  {
1310
- number: z3.string().describe("Company registration number, e.g. 552100554 with country FR"),
1916
+ number: z4.string().describe("Company registration number, e.g. 552100554 with country FR"),
1311
1917
  country: countryOpt,
1312
1918
  deep
1313
1919
  },
@@ -1316,24 +1922,24 @@ function buildServer(key, transport, options = {}) {
1316
1922
  tool(
1317
1923
  "company_id",
1318
1924
  "Look up a company directory profile by its stable co_ ID. Deep adds legal/reference details and selected description, logo, domains, social_profiles (platform, url, handle), phone_numbers and email_addresses (with source-reported type), founding precision, reported employees and field-level sources when available. Employee counts retain their measurement date, organization scope and approximation flag; null means unknown. A website claim is not legal ownership proof. National registration numbers use company.",
1319
- { id: z3.string().min(1).describe("Stable company directory ID returned by company_search"), deep },
1925
+ { id: z4.string().min(1).describe("Stable company directory ID returned by company_search"), deep },
1320
1926
  (c, a, request) => c.company.id(a.id, { ...request, deep: a.deep })
1321
1927
  );
1322
1928
  tool(
1323
1929
  "company_search",
1324
1930
  "Find company directory candidates using at most one of query, domain, ticker or identifier, or discover by country, an exact industry pair. Returns companies and an opaque next cursor without choosing a match. Deep belongs to each result. Keep the same selector, filters and limit when sending cursor. Empty listings do not establish private ownership.",
1325
1931
  {
1326
- query: z3.string().min(1).optional().describe("Company name search, sent as q"),
1327
- domain: z3.string().min(1).optional().describe("Company website domain or URL"),
1328
- ticker: z3.string().min(1).optional().describe("Security ticker, optionally scoped by exchange"),
1329
- identifier: z3.string().min(1).optional().describe("Business identifier, preserving leading zeros"),
1330
- country: z3.string().regex(/^[A-Za-z]{2}$/).optional().describe("ISO2 profile-country filter; does not mean headquarters or operating presence"),
1331
- industry: z3.string().regex(/^[0-9]{4}$/).optional().describe("Exact four-digit SIC code string, preserving leading zeros; requires industry_type"),
1332
- industry_type: z3.literal("sic").optional().describe("Industry namespace; currently sic; requires industry"),
1333
- exchange: z3.string().optional().describe("Exchange filter for ticker searches"),
1334
- authority: z3.string().optional().describe("Issuing authority filter for identifier searches"),
1335
- limit: z3.number().int().min(1).max(50).optional().describe("Maximum candidates on this page, from 1 to 50"),
1336
- cursor: z3.string().optional().describe("Opaque next cursor returned by the same search"),
1932
+ query: z4.string().min(1).optional().describe("Company name search, sent as q"),
1933
+ domain: z4.string().min(1).optional().describe("Company website domain or URL"),
1934
+ ticker: z4.string().min(1).optional().describe("Security ticker, optionally scoped by exchange"),
1935
+ identifier: z4.string().min(1).optional().describe("Business identifier, preserving leading zeros"),
1936
+ country: z4.string().regex(/^[A-Za-z]{2}$/).optional().describe("ISO2 profile-country filter; does not mean headquarters or operating presence"),
1937
+ industry: z4.string().regex(/^[0-9]{4}$/).optional().describe("Exact four-digit SIC code string, preserving leading zeros; requires industry_type"),
1938
+ industry_type: z4.literal("sic").optional().describe("Industry namespace; currently sic; requires industry"),
1939
+ exchange: z4.string().optional().describe("Exchange filter for ticker searches"),
1940
+ authority: z4.string().optional().describe("Issuing authority filter for identifier searches"),
1941
+ limit: z4.number().int().min(1).max(50).optional().describe("Maximum candidates on this page, from 1 to 50"),
1942
+ cursor: z4.string().optional().describe("Opaque next cursor returned by the same search"),
1337
1943
  deep
1338
1944
  },
1339
1945
  (c, a, request) => c.company.search({ ...request, query: a.query, domain: a.domain, ticker: a.ticker, identifier: a.identifier, country: a.country, industry: a.industry, industry_type: a.industry_type, exchange: a.exchange, authority: a.authority, limit: a.limit, cursor: a.cursor, deep: a.deep }),
@@ -1360,9 +1966,9 @@ function buildServer(key, transport, options = {}) {
1360
1966
  {
1361
1967
  lat: lat.optional(),
1362
1968
  lon: lon.optional(),
1363
- points: z3.string().min(1).max(12e3).optional().describe("lat,lon pairs separated by |, or enc: followed by a Google polyline. At most 512 points and 12000 characters. Omit lat and lon."),
1364
- path: z3.string().min(1).max(12e3).optional().describe("Path with 2-512 vertices as lat,lon pairs separated by |, or enc: followed by a Google polyline. At most 12000 characters. Segments follow the shortest great-circle arc. Segments with antipodal endpoints are invalid. Requires samples. Omit lat, lon and points."),
1365
- samples: z3.number().int().min(2).max(512).optional().describe("Number of evenly spaced samples along the path, including both endpoints. Required with path and invalid without it.")
1969
+ points: z4.string().min(1).max(12e3).optional().describe("lat,lon pairs separated by |, or enc: followed by a Google polyline. At most 512 points and 12000 characters. Omit lat and lon."),
1970
+ path: z4.string().min(1).max(12e3).optional().describe("Path with 2-512 vertices as lat,lon pairs separated by |, or enc: followed by a Google polyline. At most 12000 characters. Segments follow the shortest great-circle arc. Segments with antipodal endpoints are invalid. Requires samples. Omit lat, lon and points."),
1971
+ samples: z4.number().int().min(2).max(512).optional().describe("Number of evenly spaced samples along the path, including both endpoints. Required with path and invalid without it.")
1366
1972
  },
1367
1973
  (c, a, request) => {
1368
1974
  if (a.path !== void 0) {
@@ -1385,23 +1991,23 @@ function buildServer(key, transport, options = {}) {
1385
1991
  lat,
1386
1992
  lon,
1387
1993
  deep,
1388
- date: z3.string().optional().describe("A past UTC day, YYYY-MM-DD. Requires paid deep. Adds deep.history alongside current conditions.")
1994
+ date: z4.string().optional().describe("A past UTC day, YYYY-MM-DD. Requires paid deep. Adds deep.history alongside current conditions.")
1389
1995
  },
1390
1996
  (c, a, request) => c.weather(a.lat, a.lon, { ...request, deep: a.deep, date: a.date })
1391
1997
  );
1392
1998
  tool(
1393
1999
  "email",
1394
2000
  "Validate an email address: syntax, domain, mail routing, consumer mailbox, disposable, role, reserved domain type and typo suggestion. Deep adds mailbox deliverability, catch-all, status and the reason for the result, such as mailbox_full or mailbox_not_found. It also includes a suggested first name, no-reply flag, plus-address tag and mail service, such as Google or Microsoft. The suggested name is not a verified identity. Unavailable details are null.",
1395
- { email: z3.string().describe("Email address to validate"), deep },
2001
+ { email: z4.string().describe("Email address to validate"), deep },
1396
2002
  (c, a, request) => c.email(a.email, { ...request, deep: a.deep })
1397
2003
  );
1398
2004
  tool(
1399
2005
  "vat",
1400
2006
  "Validate a VAT number: format and checksum on every call. Deep asks the live EU registry for registered, legal name, and address. Pass from with your own VAT for a consultation identifier.",
1401
2007
  {
1402
- number: z3.string().describe("VAT number, with or without the country prefix"),
2008
+ number: z4.string().describe("VAT number, with or without the country prefix"),
1403
2009
  country: iso2("country code when the number has no prefix").optional(),
1404
- from: z3.string().optional().describe("Your own VAT number. Returns a consultation identifier for your audit file"),
2010
+ from: z4.string().optional().describe("Your own VAT number. Returns a consultation identifier for your audit file"),
1405
2011
  deep
1406
2012
  },
1407
2013
  (c, a, request) => c.vat(a.number, { ...request, country: a.country, from: a.from, deep: a.deep })
@@ -1410,7 +2016,7 @@ function buildServer(key, transport, options = {}) {
1410
2016
  "iban",
1411
2017
  "Parse an IBAN and check its format, ISO checksum, and published national BBAN checks, with known bank identifiers. Deep adds check digits, branch and account decomposition on every plan. Does not verify an account exists.",
1412
2018
  {
1413
- iban: z3.string().describe("IBAN, with or without spaces, with or without the country prefix"),
2019
+ iban: z4.string().describe("IBAN, with or without spaces, with or without the country prefix"),
1414
2020
  country: iso2("country code when the number has no prefix").optional(),
1415
2021
  deep: deep.describe("Include optional detail on every plan.")
1416
2022
  },
@@ -1420,8 +2026,8 @@ function buildServer(key, transport, options = {}) {
1420
2026
  "bin",
1421
2027
  "Look up a 6-11 digit payment-card prefix. Returns the actual longest matched prefix, issuer, country, brand key, brand name, card type and prepaid status where known. Unknown fields are null. Does not confirm a card or account exists. Pooled request on every plan.",
1422
2028
  {
1423
- bin: z3.string().describe("Card prefix as a string, 6-11 digits. Preserve leading zeros. Spaces and hyphens are accepted."),
1424
- deep: z3.boolean().optional().describe("Include an empty deep object. No extra fields or separate charge.")
2029
+ bin: z4.string().describe("Card prefix as a string, 6-11 digits. Preserve leading zeros. Spaces and hyphens are accepted."),
2030
+ deep: z4.boolean().optional().describe("Include an empty deep object. No extra fields or separate charge.")
1425
2031
  },
1426
2032
  (c, a, request) => c.bin(a.bin, { ...request, deep: a.deep })
1427
2033
  );
@@ -1429,7 +2035,7 @@ function buildServer(key, transport, options = {}) {
1429
2035
  "npi",
1430
2036
  "Validate an NPI and identify the registered provider, active/exclusion status, specialty and practice contact. Paid deep adds deactivation date and Medicare enrollment evidence.",
1431
2037
  {
1432
- npi: z3.string().describe("10-digit NPI number"),
2038
+ npi: z4.string().describe("10-digit NPI number"),
1433
2039
  deep
1434
2040
  },
1435
2041
  (c, a, request) => c.npi(a.npi, { ...request, deep: a.deep })
@@ -1438,7 +2044,7 @@ function buildServer(key, transport, options = {}) {
1438
2044
  "bank",
1439
2045
  "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.",
1440
2046
  {
1441
- 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."),
2047
+ iban: z4.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."),
1442
2048
  country: iso2("country code when the number has no prefix").optional(),
1443
2049
  deep: deep.describe("Include optional detail on every plan.")
1444
2050
  },
@@ -1448,8 +2054,8 @@ function buildServer(key, transport, options = {}) {
1448
2054
  "bank_us_ach",
1449
2055
  "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.",
1450
2056
  {
1451
- routing: z3.string().describe("Original US routing string. Preserve leading zeros and characters; the API validates accepted separators."),
1452
- account: z3.string().describe("Original account string. Preserve all characters, letter case and leading zeros; do not trim, normalize or decode.")
2057
+ routing: z4.string().describe("Original US routing string. Preserve leading zeros and characters; the API validates accepted separators."),
2058
+ account: z4.string().describe("Original account string. Preserve all characters, letter case and leading zeros; do not trim, normalize or decode.")
1453
2059
  },
1454
2060
  (c, a, request) => c.bankUsAch({ routing: a.routing, account: a.account }, request)
1455
2061
  );
@@ -1458,7 +2064,7 @@ function buildServer(key, transport, options = {}) {
1458
2064
  "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.",
1459
2065
  {
1460
2066
  country: iso2("country code"),
1461
- format: z3.string().optional().describe("Input format, currently iban (default) or us_ach. Unknown formats report supported false.")
2067
+ format: z4.string().optional().describe("Input format, currently iban (default) or us_ach. Unknown formats report supported false.")
1462
2068
  },
1463
2069
  (c, a, request) => c.bankRequirements(a.country, { ...request, format: a.format })
1464
2070
  );
@@ -1466,7 +2072,7 @@ function buildServer(key, transport, options = {}) {
1466
2072
  "card",
1467
2073
  "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.",
1468
2074
  {
1469
- 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."),
2075
+ bin: z4.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."),
1470
2076
  deep: deep.describe("Include recorded issuer details, pooled on every plan. Omitted by default; fewer than six digits returns all-null Deep fields.")
1471
2077
  },
1472
2078
  (c, a, request) => c.card(a.bin, { ...request, deep: a.deep })
@@ -1475,7 +2081,7 @@ function buildServer(key, transport, options = {}) {
1475
2081
  "provider",
1476
2082
  "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.",
1477
2083
  {
1478
- 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."),
2084
+ npi: z4.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."),
1479
2085
  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.")
1480
2086
  },
1481
2087
  (c, a, request) => c.provider(a.npi, { ...request, deep: a.deep })
@@ -1484,7 +2090,7 @@ function buildServer(key, transport, options = {}) {
1484
2090
  "phone",
1485
2091
  "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.",
1486
2092
  {
1487
- number: z3.string().describe("Phone number, e.g. +14155552671"),
2093
+ number: z4.string().describe("Phone number, e.g. +14155552671"),
1488
2094
  country: iso2("country code for national-format numbers").optional(),
1489
2095
  deep
1490
2096
  },
@@ -1494,7 +2100,7 @@ function buildServer(key, transport, options = {}) {
1494
2100
  "carrier",
1495
2101
  "Look up current carrier, real line type and burner flag. Deep adds issuing city and state in the same metered lookup, including Free allowance units. No extra check or second paid gate.",
1496
2102
  {
1497
- number: z3.string().describe("Phone number, e.g. +14155552671"),
2103
+ number: z4.string().describe("Phone number, e.g. +14155552671"),
1498
2104
  country: iso2("country code for national-format numbers").optional(),
1499
2105
  deep: deep.describe("Include available detail within the same metered core unit. No extra charge or paid-plan gate.")
1500
2106
  },
@@ -1504,7 +2110,7 @@ function buildServer(key, transport, options = {}) {
1504
2110
  "caller",
1505
2111
  "Look up the caller ID name (CNAM) for a NANP (+1) phone number. caller is the record verbatim, null when no record or outside NANP. Metered per lookup on a NANP number.",
1506
2112
  {
1507
- number: z3.string().describe("Phone number, e.g. +18004633339"),
2113
+ number: z4.string().describe("Phone number, e.g. +18004633339"),
1508
2114
  country: iso2("country code for national-format numbers").optional()
1509
2115
  },
1510
2116
  (c, a, request) => c.caller(a.number, { ...request, country: a.country })
@@ -1513,7 +2119,7 @@ function buildServer(key, transport, options = {}) {
1513
2119
  "hlr",
1514
2120
  "Phone status at the last check: live means assigned and connected means reachable at that check. Cached results may be returned. Deep adds available roaming and network diagnostics in the same metered lookup, including Free allowance units. Null is unconfirmed.",
1515
2121
  {
1516
- number: z3.string().describe("Phone number, e.g. +447712345678"),
2122
+ number: z4.string().describe("Phone number, e.g. +447712345678"),
1517
2123
  country: iso2("country code for national-format numbers").optional(),
1518
2124
  deep: deep.describe("Include available detail within the same metered core unit. No extra charge or paid-plan gate.")
1519
2125
  },
@@ -1522,65 +2128,65 @@ function buildServer(key, transport, options = {}) {
1522
2128
  tool(
1523
2129
  "stack",
1524
2130
  "Identify website technologies and available versions by category. Requires a hostname only. CMS, servers, frameworks, ecommerce, analytics, chat, payments and hosting are arrays of technology, name and nullable version. checked_at gives the check time. Scope is homepage or site; pages counts successfully checked HTML pages. Partial is true for homepage-only or incomplete bounded checks, false only when known in-scope candidates finished, never a guarantee every page was visited. When no page could be checked, checked_at and all categories are null, pages is 0 and partial is null. Empty arrays mean no matches. Missing detections do not prove absence. Uses one request from the plan allowance. Successful checks may be reused for up to 24 hours.",
1525
- { domain: z3.string().min(1).max(253).describe("Public website hostname only, e.g. example.com. No scheme, path, port or IP address."), pretty: z3.boolean().optional().describe("Format the JSON response.") },
2131
+ { domain: z4.string().min(1).max(253).describe("Public website hostname only, e.g. example.com. No scheme, path, port or IP address."), pretty: z4.boolean().optional().describe("Format the JSON response.") },
1526
2132
  (c, a, request) => c.stack(a.domain, { ...request, pretty: a.pretty })
1527
2133
  );
1528
2134
  tool(
1529
2135
  "domain",
1530
2136
  "Check whether a domain is registered. Deep adds registration dates, registrar, status and DNSSEC, included on paid plans. Use dns for DNS records and mx for mail routing.",
1531
- { domain: z3.string().describe("Domain name, e.g. example.com"), deep: deep.describe("Include registration details on a paid plan.") },
2137
+ { domain: z4.string().describe("Domain name, e.g. example.com"), deep: deep.describe("Include registration details on a paid plan.") },
1532
2138
  (c, a, request) => c.domain(a.domain, { ...request, deep: a.deep })
1533
2139
  );
1534
2140
  tool(
1535
2141
  "asn",
1536
2142
  "Network name and country for an autonomous system number.",
1537
- { asn: z3.string().describe("Autonomous system number, such as AS13335 or 13335") },
2143
+ { asn: z4.string().describe("Autonomous system number, such as AS13335 or 13335") },
1538
2144
  (c, a, request) => c.asn(a.asn, request)
1539
2145
  );
1540
2146
  tool(
1541
2147
  "mac",
1542
2148
  "Normalize a 48-bit MAC address and return its registered assignment holder, local flag, and multicast flag. Vendor is null for local or multicast addresses.",
1543
- { mac: z3.string().describe("MAC address") },
2149
+ { mac: z4.string().describe("MAC address") },
1544
2150
  (c, a, request) => c.mac(a.mac, request)
1545
2151
  );
1546
2152
  tool(
1547
2153
  "dns",
1548
2154
  "Look up published DNS records with TTLs. Pooled on every plan. Omit type to check all ten supported types. The selected question may include its CNAME chain. Values retain DNS presentation syntax, including TXT quoting.",
1549
2155
  {
1550
- domain: z3.string().describe("Domain or DNS name, including service names such as _dmarc.example.com"),
1551
- type: z3.enum(["A", "AAAA", "CNAME", "MX", "NS", "TXT", "SOA", "CAA", "SRV", "PTR"]).optional().describe("DNS question type. Omit to check all supported types.")
2156
+ domain: z4.string().describe("Domain or DNS name, including service names such as _dmarc.example.com"),
2157
+ type: z4.enum(["A", "AAAA", "CNAME", "MX", "NS", "TXT", "SOA", "CAA", "SRV", "PTR"]).optional().describe("DNS question type. Omit to check all supported types.")
1552
2158
  },
1553
2159
  (c, a, request) => c.dns(a.domain, { ...request, type: a.type })
1554
2160
  );
1555
2161
  tool(
1556
2162
  "mx",
1557
2163
  "MX records for a domain.",
1558
- { domain: z3.string().describe("Domain name") },
2164
+ { domain: z4.string().describe("Domain name") },
1559
2165
  (c, a, request) => c.mx(a.domain, request)
1560
2166
  );
1561
2167
  tool(
1562
2168
  "useragent",
1563
2169
  "Parse a User-Agent string: browser, OS, device, bot detection.",
1564
- { ua: z3.string().describe("The User-Agent string to parse"), deep },
2170
+ { ua: z4.string().describe("The User-Agent string to parse"), deep },
1565
2171
  (c, a, request) => c.useragent(a.ua, { ...request, deep: a.deep })
1566
2172
  );
1567
2173
  tool(
1568
2174
  "vehicle",
1569
2175
  "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.",
1570
- { vin: z3.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
2176
+ { vin: z4.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
1571
2177
  (c, a, request) => c.vehicle(a.vin, { ...request, deep: a.deep })
1572
2178
  );
1573
2179
  tool(
1574
2180
  "vin",
1575
2181
  "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.",
1576
- { vin: z3.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
2182
+ { vin: z4.string().describe("The VIN as you have it. Spaces and punctuation fold out"), deep },
1577
2183
  (c, a, request) => c.vin(a.vin, { ...request, deep: a.deep })
1578
2184
  );
1579
2185
  tool(
1580
2186
  "tariff",
1581
2187
  "Look up a US tariff code, description, lineage, published base general rate, exact edition and answering date. Paid deep adds schedule columns, units and matched Chapter 99 measures. Origin is the country where goods originate, not the shipping country. Optional edition pins immutable source bytes. Optional date requires verified source coverage; edition without date returns date null and no effective rate. Default requests use today. deep.reason explains a null effective_rate, including incomplete_coverage; null never means zero. Matched measures are inspectable candidates, not complete duty or landed cost.",
1582
2188
  {
1583
- code: z3.string().describe("US HTS code: 4, 6, 8 or 10 ASCII digits, dots and whitespace optional, e.g. 8471.30.01.00"),
2189
+ code: z4.string().describe("US HTS code: 4, 6, 8 or 10 ASCII digits, dots and whitespace optional, e.g. 8471.30.01.00"),
1584
2190
  origin: iso2("country where the goods originate, not the shipping country; only read with deep").optional(),
1585
2191
  edition: tariffEdition,
1586
2192
  date: tariffDate,
@@ -1591,21 +2197,21 @@ function buildServer(key, transport, options = {}) {
1591
2197
  tool(
1592
2198
  "tariff_search",
1593
2199
  "Search US tariff schedule descriptions by product words. Returns up to 20 candidate lines with hts, description, general rate and parent lineage, plus the exact edition and answering date. Optional edition pins immutable source bytes. Optional date requires verified source coverage; combine only when that edition covers the date. Edition without date returns date null. Description search is not product classification.",
1594
- { query: z3.string().describe("Product words, e.g. sunglasses, laptop, coffee"), edition: tariffEdition, date: tariffDate },
2200
+ { query: z4.string().describe("Product words, e.g. sunglasses, laptop, coffee"), edition: tariffEdition, date: tariffDate },
1595
2201
  (c, a, request) => c.tariff.search(a.query, { ...request, edition: a.edition, date: a.date })
1596
2202
  );
1597
2203
  tool(
1598
2204
  "industry",
1599
2205
  "Look up a US NAICS 2022 code, title and parent hierarchy. Deep adds definition, children and exclusions on paid plans.",
1600
- { 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.") },
2206
+ { code: z4.string().describe("NAICS code, e.g. 541511 or sector range 31-33"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
1601
2207
  (c, a, request) => c.industry(a.code, { ...request, deep: a.deep })
1602
2208
  );
1603
2209
  tool(
1604
2210
  "industry_search",
1605
2211
  "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.",
1606
2212
  {
1607
- query: z3.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
1608
- limit: z3.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
2213
+ query: z4.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
2214
+ limit: z4.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
1609
2215
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1610
2216
  },
1611
2217
  (c, a, request) => c.industry.search(a.query, { ...request, deep: a.deep, limit: a.limit })
@@ -1613,15 +2219,15 @@ function buildServer(key, transport, options = {}) {
1613
2219
  tool(
1614
2220
  "naics",
1615
2221
  "Compatibility name for industry. Look up a US NAICS 2022 code, title and parent hierarchy. Deep adds definition, children and exclusions on paid plans.",
1616
- { 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.") },
2222
+ { code: z4.string().describe("NAICS code, e.g. 541511 or sector range 31-33"), deep: deep.describe("Include the complete detail bag on a paid plan.") },
1617
2223
  (c, a, request) => c.industry(a.code, { ...request, deep: a.deep })
1618
2224
  );
1619
2225
  tool(
1620
2226
  "naics_search",
1621
2227
  "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.",
1622
2228
  {
1623
- query: z3.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
1624
- limit: z3.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
2229
+ query: z4.string().min(1).max(100).describe("Industry keywords, e.g. coffee shop"),
2230
+ limit: z4.number().int().min(1).max(50).optional().describe("Maximum results, 1-50. Default 10."),
1625
2231
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1626
2232
  },
1627
2233
  (c, a, request) => c.industry.search(a.query, { ...request, deep: a.deep, limit: a.limit })
@@ -1629,35 +2235,35 @@ function buildServer(key, transport, options = {}) {
1629
2235
  tool(
1630
2236
  "currency",
1631
2237
  "Currency name, symbols and decimal places. Deep adds numeric code, plural name and using countries on every plan.",
1632
- { code: z3.string().describe("ISO 4217 code, e.g. USD"), deep: deep.describe("Include optional detail on every plan.") },
2238
+ { code: z4.string().describe("ISO 4217 code, e.g. USD"), deep: deep.describe("Include optional detail on every plan.") },
1633
2239
  (c, a, request) => c.currency(a.code, { ...request, deep: a.deep })
1634
2240
  );
1635
2241
  tool(
1636
2242
  "currency_rate",
1637
2243
  "Reference exchange rate between two currencies. Pass date for a past business day, amount to convert.",
1638
2244
  {
1639
- base: z3.string().describe("Base currency ISO 4217 code, e.g. USD"),
1640
- quote: z3.string().describe("Quote currency ISO 4217 code, e.g. EUR"),
1641
- date: z3.string().optional().describe(
2245
+ base: z4.string().describe("Base currency ISO 4217 code, e.g. USD"),
2246
+ quote: z4.string().describe("Quote currency ISO 4217 code, e.g. EUR"),
2247
+ date: z4.string().optional().describe(
1642
2248
  "YYYY-MM-DD. Official rate for that business day. A weekend or holiday resolves to the last published day on or before it"
1643
2249
  ),
1644
- amount: z3.number().optional().describe("Appends amount and converted, rounded to the quote currency minor-unit digits")
2250
+ amount: z4.number().optional().describe("Appends amount and converted, rounded to the quote currency minor-unit digits")
1645
2251
  },
1646
2252
  (c, a, request) => c.currency.rate(a.base, a.quote, { ...request, date: a.date, amount: a.amount })
1647
2253
  );
1648
2254
  tool(
1649
2255
  "language",
1650
2256
  "Language names, script and writing direction. Deep adds ISO3 and country associations on every plan.",
1651
- { code: z3.string().describe("Language code, e.g. en, ja, gsw"), deep: deep.describe("Include optional detail on every plan.") },
2257
+ { code: z4.string().describe("Language code, e.g. en, ja, gsw"), deep: deep.describe("Include optional detail on every plan.") },
1652
2258
  (c, a, request) => c.language(a.code, { ...request, deep: a.deep })
1653
2259
  );
1654
2260
  tool(
1655
2261
  "name",
1656
2262
  "Parse a name into prefix, first, middle, last and suffix. Paid deep adds gender evidence, salutation, short and directory formats, and initials. Country scopes gender evidence. name_locale selects formatting rules. Junk returns valid false.",
1657
2263
  {
1658
- name: z3.string().describe("The name to parse, e.g. Smith, John or BILLY OSHALL"),
1659
- country: z3.string().optional().describe("ISO2 country context for gender, e.g. IT"),
1660
- name_locale: z3.string().min(2).max(64).optional().describe("Name-formatting locale, e.g. en or ja. Defaults to en. Changes formatting only, not parsing or gender evidence."),
2264
+ name: z4.string().describe("The name to parse, e.g. Smith, John or BILLY OSHALL"),
2265
+ country: z4.string().optional().describe("ISO2 country context for gender, e.g. IT"),
2266
+ name_locale: z4.string().min(2).max(64).optional().describe("Name-formatting locale, e.g. en or ja. Defaults to en. Changes formatting only, not parsing or gender evidence."),
1661
2267
  deep: deep.describe("Include the complete detail bag on a paid plan.")
1662
2268
  },
1663
2269
  (c, a, request) => c.name(a.name, { ...request, deep: a.deep, country: a.country, name_locale: a.name_locale })
@@ -1666,21 +2272,21 @@ function buildServer(key, transport, options = {}) {
1666
2272
  "time",
1667
2273
  "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.",
1668
2274
  {
1669
- 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"),
2275
+ timezone: z4.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"),
1670
2276
  lat: lat.optional(),
1671
2277
  lon: lon.optional(),
1672
- 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."),
1673
- 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."),
1674
- 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."),
1675
- 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."),
1676
- iata: z3.string().regex(/^[A-Za-z]{3}$/).optional().describe("Three-letter IATA airport identifier."),
1677
- icao: z3.string().regex(/^[A-Za-z]{4}$/).optional().describe("Four-letter ICAO airport identifier."),
1678
- 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."),
1679
- 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."),
1680
- 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"),
1681
- 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."),
1682
- 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."),
1683
- to: z3.string().min(1).optional().describe("Destination IANA timezone, e.g. Asia/Tokyo. Returns to.at and to.unix at the same instant"),
2278
+ ip: z4.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."),
2279
+ city: z4.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."),
2280
+ country: z4.string().regex(/^[A-Za-z]{2}$/).optional().describe("ISO2 country as the source, or context with city/address. Multiple country timezones remain candidates."),
2281
+ state: z4.string().min(1).max(6).optional().describe("State context with city/address and country, as a bare code or matching country-prefixed code."),
2282
+ iata: z4.string().regex(/^[A-Za-z]{3}$/).optional().describe("Three-letter IATA airport identifier."),
2283
+ icao: z4.string().regex(/^[A-Za-z]{4}$/).optional().describe("Four-letter ICAO airport identifier."),
2284
+ unlocode: z4.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."),
2285
+ address: z4.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."),
2286
+ at: z4.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"),
2287
+ disambiguation: z4.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."),
2288
+ targets: z4.array(z4.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."),
2289
+ to: z4.string().min(1).optional().describe("Destination IANA timezone, e.g. Asia/Tokyo. Returns to.at and to.unix at the same instant"),
1684
2290
  deep: deep.describe("Include optional detail on every plan.")
1685
2291
  },
1686
2292
  (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 }),
@@ -1696,16 +2302,16 @@ function buildServer(key, transport, options = {}) {
1696
2302
  "time_zones",
1697
2303
  "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.",
1698
2304
  {
1699
- query: z3.string().trim().max(64).optional().describe("Identifier search, e.g. New York or Europe. Spaces and underscores match the same way."),
1700
- country: z3.string().regex(/^[A-Za-z]{2}$/).optional().describe("ISO2 country association, e.g. US."),
1701
- area: z3.string().min(1).max(64).optional().describe("IANA identifier prefix, e.g. America."),
1702
- 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."),
1703
- 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."),
1704
- dst: z3.boolean().optional().describe("Whether the rule DST flag is active at the selected instant. Includes negative seasonal adjustments."),
1705
- observes_dst: z3.boolean().optional().describe("Whether a DST-flagged state occurs during the UTC calendar year containing at."),
1706
- at: z3.string().min(1).optional().describe("ISO instant for all filters and detailed rows. Default now. Offsetless input means UTC."),
1707
- details: z3.boolean().optional().describe("Include zones rows with country associations, area, offset, abbreviation and DST facts, plus the common evaluation instant."),
1708
- sort: z3.enum(["timezone", "offset"]).optional().describe("Order by identifier (default) or actual UTC offset, then identifier.")
2305
+ query: z4.string().trim().max(64).optional().describe("Identifier search, e.g. New York or Europe. Spaces and underscores match the same way."),
2306
+ country: z4.string().regex(/^[A-Za-z]{2}$/).optional().describe("ISO2 country association, e.g. US."),
2307
+ area: z4.string().min(1).max(64).optional().describe("IANA identifier prefix, e.g. America."),
2308
+ offset: z4.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."),
2309
+ abbreviation: z4.string().min(1).max(64).optional().describe("Timezone abbreviation to find candidates for, e.g. CST. Never infer a unique zone from an abbreviation."),
2310
+ dst: z4.boolean().optional().describe("Whether the rule DST flag is active at the selected instant. Includes negative seasonal adjustments."),
2311
+ observes_dst: z4.boolean().optional().describe("Whether a DST-flagged state occurs during the UTC calendar year containing at."),
2312
+ at: z4.string().min(1).optional().describe("ISO instant for all filters and detailed rows. Default now. Offsetless input means UTC."),
2313
+ details: z4.boolean().optional().describe("Include zones rows with country associations, area, offset, abbreviation and DST facts, plus the common evaluation instant."),
2314
+ sort: z4.enum(["timezone", "offset"]).optional().describe("Order by identifier (default) or actual UTC offset, then identifier.")
1709
2315
  },
1710
2316
  (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 })
1711
2317
  );
@@ -1713,13 +2319,13 @@ function buildServer(key, transport, options = {}) {
1713
2319
  "timezone",
1714
2320
  "Compatibility tool; use time for new integrations. Look up a timezone from an IANA id or from lat and lon. Offset, DST, local time. Pass at for a specific instant. Pass to with another IANA id to convert a time between zones: the response appends at (wall time in the from zone) and to.at (the converted time). Open ocean answers the nautical Etc/GMT zone.",
1715
2321
  {
1716
- timezone: z3.string().min(1).optional().describe("IANA timezone id, e.g. America/New_York"),
2322
+ timezone: z4.string().min(1).optional().describe("IANA timezone id, e.g. America/New_York"),
1717
2323
  lat: lat.optional(),
1718
2324
  lon: lon.optional(),
1719
- at: z3.string().optional().describe(
2325
+ at: z4.string().optional().describe(
1720
2326
  "ISO 8601 time, default now. With to and no UTC offset, reads as wall time in the from zone"
1721
2327
  ),
1722
- to: z3.string().optional().describe("Convert: the other IANA zone, e.g. Asia/Tokyo. Requires timezone, not lat/lon")
2328
+ to: z4.string().optional().describe("Convert: the other IANA zone, e.g. Asia/Tokyo. Requires timezone, not lat/lon")
1723
2329
  },
1724
2330
  (c, a, request) => {
1725
2331
  if (a.lat != null && a.lon != null) {
@@ -1739,9 +2345,9 @@ function buildServer(key, transport, options = {}) {
1739
2345
  "date",
1740
2346
  "Parse a date to ISO date, validity and Unix midnight. Ambiguous numeric dates need format. to adds signed days between; omit date for UTC today. Deep adds calendar details on every plan.",
1741
2347
  {
1742
- date: z3.string().min(1).optional().describe("The date as you have it, any common format. Omit for today (UTC)"),
1743
- format: z3.enum(["mdy", "dmy"]).optional().describe("Breaks the month-first / day-first tie on numeric dates like 03/04/2026"),
1744
- to: z3.string().optional().describe("Another date. Appends to (normalized ISO) and days (signed days between)"),
2348
+ date: z4.string().min(1).optional().describe("The date as you have it, any common format. Omit for today (UTC)"),
2349
+ format: z4.enum(["mdy", "dmy"]).optional().describe("Breaks the month-first / day-first tie on numeric dates like 03/04/2026"),
2350
+ to: z4.string().optional().describe("Another date. Appends to (normalized ISO) and days (signed days between)"),
1745
2351
  deep: deep.describe("Include optional detail on every plan.")
1746
2352
  },
1747
2353
  (c, a, request) => {
@@ -1758,34 +2364,83 @@ function buildServer(key, transport, options = {}) {
1758
2364
  "Public holidays and cultural observances for a country and year. Each row carries type: public or observance.",
1759
2365
  {
1760
2366
  country: iso2("country code"),
1761
- year: z3.number().int().optional().describe("Year, default current")
2367
+ year: z4.number().int().optional().describe("Year, default current")
1762
2368
  },
1763
2369
  (c, a, request) => c.holiday(a.country, { ...request, year: a.year })
1764
2370
  );
1765
2371
  tool(
1766
2372
  "holiday_date",
1767
2373
  "Whether a specific date is a holiday or observance in a country. holiday is null when it is not.",
1768
- { country: iso2("country code"), date: z3.string().describe("Date as YYYY-MM-DD") },
2374
+ { country: iso2("country code"), date: z4.string().describe("Date as YYYY-MM-DD") },
1769
2375
  (c, a, request) => c.holiday.date(a.country, a.date, request)
1770
2376
  );
1771
2377
  tool(
1772
2378
  "emoji",
1773
- "Resolve an emoji character, shortcode or name. Deep adds encoding, keywords and skin variants on every plan.",
1774
- { emoji: z3.string().describe("Emoji name or the character itself, e.g. rocket"), deep: deep.describe("Include optional detail on every plan.") },
1775
- (c, a, request) => c.emoji(a.emoji, { ...request, deep: a.deep })
2379
+ 'Resolve an emoji character, shortcode, name or codepoint sequence. Deep adds encoding, keywords, tone relationships and artwork on every plan. Artwork is keyed by style: deep.artwork.openmoji.svg and deep.artwork.openmoji.png["72"].',
2380
+ { emoji: z4.string().describe("Emoji input, e.g. rocket, :rocket:, \u{1F680} or U+1F680"), shortcode_source: z4.enum(["cldr", "github", "slack", "discord"]).optional().describe("Resolve the shortcode within this source."), deep: deep.describe("Include optional detail on every plan.") },
2381
+ (c, a, request) => c.emoji(a.emoji, { ...request, deep: a.deep, shortcodeSource: a.shortcode_source })
1776
2382
  );
1777
2383
  tool(
1778
2384
  "emoji_search",
1779
- "Search emoji by keyword. Deep adds encoding and skin-variant detail inside each result on every plan.",
2385
+ "Search emoji by keyword with optional catalog filters. Explicit offset or filters return total and next_offset. Deep belongs to each result.",
1780
2386
  {
1781
- query: z3.string().describe("Search keyword, e.g. fire"),
1782
- limit: z3.number().int().min(1).max(50).optional().describe("Max results"),
1783
- deep: deep.describe("Include optional detail on every plan.")
2387
+ query: z4.string().describe("Search keyword, e.g. fire"),
2388
+ ...emojiFilters
1784
2389
  },
1785
- (c, a, request) => c.emoji.search(a.query, { ...request, deep: a.deep, limit: a.limit })
2390
+ (c, a, request) => c.emoji.search(a.query, { ...request, ...a, maxVersion: a.max_version, includeSkinTones: a.include_skin_tones })
2391
+ );
2392
+ tool(
2393
+ "emoji_browse",
2394
+ "Browse the emoji catalog by category, subcategory or Emoji release. Returns total and next_offset for pagination; omit a search query.",
2395
+ emojiFilters,
2396
+ (c, a, request) => c.emoji.browse({ ...request, ...a, maxVersion: a.max_version, includeSkinTones: a.include_skin_tones })
2397
+ );
2398
+ tool(
2399
+ "emoji_metadata",
2400
+ "Get actual emoji inventory total, content edition, official-source completeness, provenance and artwork coverage. Artwork notice files are linked; data notices travel with the snapshot. One pooled read.",
2401
+ {},
2402
+ async (c, _a, request) => c.emoji.metadata(request)
2403
+ );
2404
+ tool(
2405
+ "emoji_catalog",
2406
+ "Get a JSON catalog download URL and current coverage. One pooled metadata read; the download is a separate request with your API key. The full snapshot stays out of model context.",
2407
+ {
2408
+ category: emojiFilters.category,
2409
+ subcategory: emojiFilters.subcategory,
2410
+ version: emojiFilters.version,
2411
+ max_version: emojiFilters.max_version,
2412
+ include_skin_tones: emojiFilters.include_skin_tones,
2413
+ profile: z4.enum(["full", "compact"]).optional().describe("JSON download profile. Compact retains offline lookup, search and parse facts while omitting bulky artwork details.")
2414
+ },
2415
+ async (c, a, request) => {
2416
+ const metadata = await c.emoji.metadata(request);
2417
+ const url = new URL("https://api.parseapi.com/emoji/catalog");
2418
+ for (const [key2, value] of Object.entries({ category: a.category, subcategory: a.subcategory, version: a.version, max_version: a.max_version, include_skin_tones: a.include_skin_tones, lang: request.lang })) if (value !== void 0) url.searchParams.set(key2, String(value));
2419
+ if (a.profile) url.searchParams.set("profile", a.profile);
2420
+ return { metadata, download_url: url.href };
2421
+ }
2422
+ );
2423
+ tool(
2424
+ "emoji_categories",
2425
+ "List emoji categories and their subcategories for search and browsing filters.",
2426
+ {},
2427
+ (c, _a, request) => c.emoji.categories(request)
2428
+ );
2429
+ tool(
2430
+ "emoji_parse",
2431
+ "Extract complete Unicode emoji sequences from text. Results group repeated emoji in first-occurrence order, and positions use UTF-16 code units with an exclusive end. Text is sent in the POST body.",
2432
+ { text: z4.string().max(16e3).describe("Text to inspect for native Unicode emoji, up to 16000 UTF-16 code units."), deep: deep.describe("Include optional reference detail inside each result.") },
2433
+ (c, a, request) => c.emoji.parse(a.text, { ...request, deep: a.deep })
2434
+ );
2435
+ tool(
2436
+ "emoji_convert",
2437
+ "Convert Unicode emoji to a named shortcode preset or decode that preset. Unknown, unavailable and ambiguous inputs remain literal with reasons and original UTF-16 offsets. Text is sent in the POST body.",
2438
+ { text: z4.string().max(16e3), direction: z4.enum(["to_shortcodes", "to_emoji"]), shortcode_source: z4.enum(["cldr", "github", "slack", "discord"]) },
2439
+ (c, a, request) => c.emoji.convert(a.text, { ...request, direction: a.direction, shortcodeSource: a.shortcode_source })
1786
2440
  );
1787
2441
  registerDiscovery(server, operations, mode, API_VERSION);
1788
2442
  registerPreflight(server, parse, transport);
2443
+ registerTasks(server, parse, transport);
1789
2444
  return server;
1790
2445
  }
1791
2446