@uniquedomains/mcp-server 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -42,11 +42,6 @@ var tldPage = (input, data) => {
42
42
  const tld = segment(raw);
43
43
  return publicSet && tld !== null ? `${WEBSITE}/tld/${tld}` : `${WEBSITE}/tld`;
44
44
  };
45
- var domainPage = (input, data) => {
46
- const fromData = isObject(data) ? segment(data.name) : null;
47
- const name = fromData ?? (typeof input.nameOrId === "string" && input.nameOrId.includes(".") ? segment(input.nameOrId) : null);
48
- return name === null ? `${WEBSITE}/domains` : `${WEBSITE}/availability/${name}`;
49
- };
50
45
  var EDITION_PAGES = { founder: "/business-ideas", investor: "/trending-domains" };
51
46
  var editionPage = (input) => {
52
47
  const path = typeof input.persona === "string" ? EDITION_PAGES[input.persona] : void 0;
@@ -67,10 +62,8 @@ var DETAILS_RULES = {
67
62
  list_word_categories: none,
68
63
  get_word_endings: none,
69
64
  get_word_notability: none,
70
- get_word_market: none,
71
65
  // The catalog: its lists on /domains, one name on its availability page, the drops on the WHOIS hub.
72
66
  list_domains: page("/domains"),
73
- get_domain: domainPage,
74
67
  get_domain_drops: page("/whois"),
75
68
  list_domain_hacks: page("/domains"),
76
69
  get_catalog_stats: page("/domains"),
@@ -88,7 +81,6 @@ var DETAILS_RULES = {
88
81
  list_registrars: page("/registrars"),
89
82
  list_registrar_prices: registrarPage,
90
83
  list_registrar_changes: registrarPage,
91
- list_tld_prices: page("/registrars"),
92
84
  list_price_changes: page("/registrars"),
93
85
  list_price_traps: page("/registrars"),
94
86
  list_venues: page("/registrars"),
@@ -101,7 +93,6 @@ var DETAILS_RULES = {
101
93
  list_market_sales_endings: page("/sales"),
102
94
  get_market_sales_lengths: page("/sales"),
103
95
  list_market_sales_movers: page("/sales"),
104
- get_market_sales_word: page("/sales"),
105
96
  get_market_auctions: page("/auctions"),
106
97
  list_market_auctions_sample: page("/auctions"),
107
98
  list_market_auction_venues: page("/auctions"),
@@ -117,7 +108,6 @@ var DETAILS_RULES = {
117
108
  get_agenda: page("/agenda"),
118
109
  // Reference lists: no page of their own.
119
110
  get_meta_enums: none,
120
- get_meta_freshness: none,
121
111
  list_meta_datasets: none,
122
112
  list_meta_trademark_classes: none,
123
113
  get_meta_providers: none
@@ -158,7 +148,8 @@ var selectTools = (tools, profile, plan) => {
158
148
  };
159
149
  var STRIPPED_LINKS = ["register", "product"];
160
150
  var isKeyless = (profile, plan) => profile === "hosted" || plan === "none";
161
- var KEYLESS_LIMIT_DESCRIPTION = "Page size, 20 at most.";
151
+ var KEYLESS_LIMIT_MAX = 20;
152
+ var KEYLESS_LIMIT_DESCRIPTION = `Page size, ${KEYLESS_LIMIT_MAX} at most.`;
162
153
  var PLAN_TALK = /\bpaid\b|\bsubscriptions?\b|\bkeyed\b|\bfree (?:tier|grade)\b|\bmember key\b|\b(?:founder|investor) (?:plan|key)\b/iu;
163
154
  var inputSchemaFor = (tool, profile, plan) => {
164
155
  if (!isKeyless(profile, plan)) return tool.inputSchema;
@@ -168,7 +159,11 @@ var inputSchemaFor = (tool, profile, plan) => {
168
159
  for (const [name, schema] of Object.entries(properties)) {
169
160
  if (schema === void 0 || tool.keyedParameters.includes(name)) continue;
170
161
  if (name === "limit" && isObject(schema)) {
171
- kept[name] = { ...schema, description: KEYLESS_LIMIT_DESCRIPTION };
162
+ kept[name] = { ...schema, maximum: KEYLESS_LIMIT_MAX, description: KEYLESS_LIMIT_DESCRIPTION };
163
+ } else if (profile === "hosted" && name === "fields" && isObject(schema) && typeof schema.description === "string") {
164
+ kept[name] = { ...schema, description: hostedFieldsDescription(tool.operationId, schema.description) };
165
+ } else if (profile === "hosted" && isObject(schema) && typeof schema.description === "string" && WORD_ID_CLAUSE.test(schema.description)) {
166
+ kept[name] = { ...schema, description: schema.description.replace(WORD_ID_CLAUSE, " or the word") };
172
167
  } else if (profile === "hosted" && isObject(schema) && typeof schema.description === "string" && PLAN_TALK.test(schema.description)) {
173
168
  const { description: _dropped, ...rest } = schema;
174
169
  kept[name] = rest;
@@ -178,16 +173,116 @@ var inputSchemaFor = (tool, profile, plan) => {
178
173
  }
179
174
  return { ...tool.inputSchema, properties: kept };
180
175
  };
176
+ var ISO_DATETIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?$/u;
177
+ var HOSTED_DROPPED_STAMPS = ["computedAt", "rollupAt"];
178
+ var HOSTED_KEPT_TIMES = ["endsAt"];
179
+ var INTERNAL_ID_VALUE = /^(?:dom|wrd)_|^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
180
+ var ROW_NUMBER = /^\d+$/u;
181
+ var isIdKey = (key) => key === "id" || /[a-z]Id$/u.test(key);
182
+ var isInternalId = (key, value) => key === "id" && value === null || isIdKey(key) && typeof value === "string" && (INTERNAL_ID_VALUE.test(value) || key === "id" && ROW_NUMBER.test(value));
183
+ var utcDay = (value) => {
184
+ const time = Date.parse(/(?:Z|[+-]\d{2}:?\d{2})$/u.test(value) ? value : `${value}Z`);
185
+ return Number.isNaN(time) ? value.slice(0, 10) : new Date(time).toISOString().slice(0, 10);
186
+ };
187
+ var HOSTED_INTERNAL_ID_PATHS = {
188
+ get_name: ["data.id", "data.word.id"],
189
+ resolve_word: ["data.match.id", "data.candidates[].id"],
190
+ list_domains: ["data[].id"],
191
+ get_domain_drops: ["data[].id"],
192
+ list_domain_hacks: ["data[].id"],
193
+ list_tlds: ["data[].phases[].id"],
194
+ get_tld: ["data.phases[].id"],
195
+ list_tld_phases: ["data[].id"],
196
+ list_registrar_changes: ["data[].id"],
197
+ list_price_changes: ["data[].id"],
198
+ list_events: ["data[].id"],
199
+ get_event: ["data.id"],
200
+ get_agenda: ["data.entries[].id", "data.recentlyAdded[].id", "data.undated[].id"]
201
+ };
202
+ var HOSTED_PUBLIC_ID_PATHS = {
203
+ get_name: ["data.registry.registrar.ianaId"],
204
+ get_name_registry: ["data.registrar.ianaId", "data.eppStatuses[].id"],
205
+ get_word_notability: ["data.wikidataId"],
206
+ list_tld_applications: ["data[].applicationId"],
207
+ list_tld_application_changes: ["data[].applicationId"],
208
+ get_tld_application_string: ["data.applications[].applicationId", "data.changes[].applicationId"],
209
+ list_registrars: ["data[].ianaId"],
210
+ list_venues: ["data[].ianaId"],
211
+ get_venue: ["data.ianaId"],
212
+ list_iana_registrars: ["data[].id"],
213
+ get_iana_registrar: ["data.id"],
214
+ get_market_sales: ["data.pulse.windows[].id"],
215
+ list_market_auction_venues: ["data[].id"],
216
+ get_meta_enums: ["data.auctionVenues[].id", "data.parkingServices[].id"],
217
+ list_meta_datasets: ["data[].id"],
218
+ get_meta_providers: ["data.registrars[].ianaId", "data.auctionVenues[].id", "data.parkingServices[].id"]
219
+ };
220
+ var trimHosted = (value, key = null) => {
221
+ if (Array.isArray(value)) return value.map((item) => trimHosted(item, key) ?? null);
222
+ if (typeof value === "string") return ISO_DATETIME.test(value) && (key === null || !HOSTED_KEPT_TIMES.includes(key)) ? utcDay(value) : value;
223
+ if (!isObject(value)) return value;
224
+ const out = {};
225
+ for (const [name, child] of Object.entries(value)) {
226
+ if (child === void 0 || HOSTED_DROPPED_STAMPS.includes(name) || isInternalId(name, child)) continue;
227
+ out[name] = trimHosted(child, name) ?? null;
228
+ }
229
+ return out;
230
+ };
231
+ var dropSchemaPaths = (node, path, dropped) => {
232
+ if (!isObject(node)) return node;
233
+ const out = {};
234
+ for (const [key, child] of Object.entries(node)) {
235
+ if (child === void 0) continue;
236
+ if (key === "properties" && isObject(child)) {
237
+ const kept = {};
238
+ for (const [name, schema] of Object.entries(child)) {
239
+ if (schema === void 0) continue;
240
+ const at = path === "" ? name : `${path}.${name}`;
241
+ if (dropped.has(at) || HOSTED_DROPPED_STAMPS.includes(name)) continue;
242
+ kept[name] = dropSchemaPaths(schema, at, dropped);
243
+ }
244
+ out[key] = kept;
245
+ } else if (key === "items") {
246
+ out[key] = dropSchemaPaths(child, `${path}[]`, dropped);
247
+ } else if ((key === "anyOf" || key === "allOf") && Array.isArray(child)) {
248
+ out[key] = child.map((branch) => dropSchemaPaths(branch, path, dropped));
249
+ } else {
250
+ out[key] = child;
251
+ }
252
+ }
253
+ return out;
254
+ };
181
255
  var outputSchemaFor = (tool, profile) => {
182
256
  if (profile === "local") return tool.outputSchema;
183
257
  const properties = tool.outputSchema.properties;
184
258
  if (!isObject(properties)) return tool.outputSchema;
259
+ const dropped = new Set(HOSTED_INTERNAL_ID_PATHS[tool.operationId] ?? []);
260
+ const data = properties.data === void 0 ? void 0 : dropSchemaPaths(properties.data, "data", dropped);
261
+ const meta = properties.meta === void 0 ? void 0 : dropSchemaPaths(properties.meta, "meta", dropped);
262
+ const trimmed = { ...properties, ...data !== void 0 ? { data } : {}, ...meta !== void 0 ? { meta } : {} };
185
263
  const links = properties.links;
186
- if (!isObject(links)) return tool.outputSchema;
187
- const linkProperties = links.properties;
188
- if (!isObject(linkProperties)) return tool.outputSchema;
189
- const kept = Object.fromEntries(Object.entries(linkProperties).filter(([name]) => !STRIPPED_LINKS.includes(name)));
190
- return { ...tool.outputSchema, properties: { ...properties, links: { ...links, properties: kept } } };
264
+ if (isObject(links) && isObject(links.properties)) {
265
+ const kept = Object.fromEntries(Object.entries(links.properties).filter(([name]) => !STRIPPED_LINKS.includes(name)));
266
+ trimmed.links = { ...links, properties: kept };
267
+ }
268
+ return { ...tool.outputSchema, properties: trimmed };
269
+ };
270
+ var hostedDroppedTopKeys = (operationId) => {
271
+ const keys = new Set(HOSTED_DROPPED_STAMPS);
272
+ for (const path of HOSTED_INTERNAL_ID_PATHS[operationId] ?? []) {
273
+ const match = /^data(?:\[\])?\.([A-Za-z]+)$/u.exec(path);
274
+ if (match?.[1]) keys.add(match[1]);
275
+ }
276
+ return keys;
277
+ };
278
+ var WORD_ID_CLAUSE = /, the word, or `wrd_<id>`/u;
279
+ var FIELDS_LIST = /^(Comma-separated top-level keys to keep: )(.+)\.$/u;
280
+ var hostedFieldsDescription = (operationId, description) => {
281
+ const match = FIELDS_LIST.exec(description);
282
+ if (!match?.[1] || !match[2]) return description;
283
+ const dropped = hostedDroppedTopKeys(operationId);
284
+ const kept = match[2].split(", ").filter((key) => !dropped.has(key));
285
+ return `${match[1]}${kept.join(", ")}.`;
191
286
  };
192
287
  var stripLinks = (value) => {
193
288
  if (Array.isArray(value)) return value.map((item) => stripLinks(item) ?? null);
@@ -207,11 +302,11 @@ var stripLinks = (value) => {
207
302
  };
208
303
  var shapeAnswer = (profile, operationId, input, envelope) => {
209
304
  if (profile === "local") return { data: envelope.data, meta: envelope.meta, links: envelope.links };
210
- const data = stripLinks(envelope.data) ?? null;
305
+ const data = trimHosted(stripLinks(envelope.data)) ?? null;
211
306
  const links = {};
212
307
  for (const [name, link] of Object.entries(envelope.links)) if (!STRIPPED_LINKS.includes(name) && link !== void 0) links[name] = link;
213
308
  links.details = detailsFor(operationId, input, envelope.data, envelope.links.details);
214
- const meta = stripLinks(envelope.meta);
309
+ const meta = trimHosted(stripLinks(envelope.meta));
215
310
  return { data, meta: isObject(meta) ? meta : {}, links };
216
311
  };
217
312
  var LABEL_KEYS = ["name", "domain", "word", "tld", "ending", "string", "phrase", "title", "label", "slug", "registrar", "venue"];
@@ -373,6 +468,8 @@ var sentence = (text) => {
373
468
  const trimmed = text.trim();
374
469
  return trimmed === "" || /[.?!]$/u.test(trimmed) ? trimmed : `${trimmed}.`;
375
470
  };
471
+ var HOSTED_RATE_SPENT = "This connector has reached the API's limit of calls.";
472
+ var HOSTED_DAY_SPENT = "This connector's daily allowance is spent.";
376
473
  var HOSTED_FREE_ONLY = "This connector serves the free answers only, and that input or page is not one of them. Call the tool again without it.";
377
474
  var refusalText = (error, profile, now) => {
378
475
  const detail = sentence(error.detail || error.title || `The API refused the call (${error.code}).`);
@@ -401,8 +498,9 @@ var refusalText = (error, profile, now) => {
401
498
  case "consumer_day_cap":
402
499
  case "intake_day_cap": {
403
500
  const shared = profile === "hosted" && error.code !== "rate_limited" ? " This connector shares one daily allowance among its users." : "";
404
- if (error.retryAfter === null) return `${detail}${shared} Try again later.`;
405
- return `${detail}${shared} It resets ${resetPhrase(error.retryAfter, now)}.`;
501
+ const said = profile !== "hosted" ? detail : error.code !== "rate_limited" ? HOSTED_DAY_SPENT : PLAN_TALK.test(detail) ? HOSTED_RATE_SPENT : detail;
502
+ if (error.retryAfter === null) return `${said}${shared} Try again later.`;
503
+ return `${said}${shared} It resets ${resetPhrase(error.retryAfter, now)}.`;
406
504
  }
407
505
  case "invalid_key":
408
506
  return `${detail} Check UD_API_KEY: a member key is created in Unique Domains under Settings, Account, API.`;
@@ -503,7 +601,7 @@ var TOOLS = [
503
601
  "name": "ud_get_name",
504
602
  "operationId": "get_name",
505
603
  "title": "Stored answer for one domain name",
506
- "description": "The stored answer for one domain name: status, drop day, price today, registry facts, word facts and similar sales. Pass `name` (such as get.plumbing).",
604
+ "description": "The stored answer for one domain name: status, drop day, price today, registry facts, word facts and similar sales. Use it when someone asks about one specific domain name: whether it is open or for sale, what it costs, when it drops. Stored data as of its day, not a live reading. Pass `name` (such as get.plumbing).",
507
605
  "tier": "free",
508
606
  "plan": null,
509
607
  "metered": null,
@@ -965,8 +1063,8 @@ var TOOLS = [
965
1063
  {
966
1064
  "name": "ud_batch_names",
967
1065
  "operationId": "batch_names",
968
- "title": "Keyed name resource for up to 100 names in one call",
969
- "description": "The keyed name resource for up to 100 names in one call. Pass `names` (a list).",
1066
+ "title": "Stored answers for up to 100 domain names in one call",
1067
+ "description": "The stored answers for up to 100 domain names in one call. Use it when screening a list of names at once; each name is read as stored, not live. Pass `names` (a list).",
970
1068
  "tier": "keyed",
971
1069
  "plan": "investor",
972
1070
  "metered": null,
@@ -1546,7 +1644,7 @@ var TOOLS = [
1546
1644
  "name": "ud_check_name",
1547
1645
  "operationId": "check_name",
1548
1646
  "title": "Reads one name live from its registry and a registrar",
1549
- "description": "Reads one name live from its registry and a registrar, stores the answer and returns the keyed name resource. Pass `name` (such as get.plumbing).",
1647
+ "description": "Reads one name live from its registry and a registrar, stores the reading and returns the full name answer. Use it when the stored answer is too old for a decision about one name; each call spends one live check of the month. Pass `name` (such as get.plumbing).",
1550
1648
  "tier": "keyed",
1551
1649
  "plan": null,
1552
1650
  "metered": "Live",
@@ -2112,7 +2210,7 @@ var TOOLS = [
2112
2210
  "name": "ud_get_name_prices",
2113
2211
  "operationId": "get_name_prices",
2114
2212
  "title": "Every stored registrar quote for one name",
2115
- "description": "Every stored registrar quote for one name, and the renewal-trap flag. Pass `name` (such as get.plumbing).",
2213
+ "description": "Every stored registrar quote for one name, and the renewal-trap flag. Use it when someone wants every registrar's price for one name, or asks whether its renewal jumps after the first year. Pass `name` (such as get.plumbing).",
2116
2214
  "tier": "keyed",
2117
2215
  "plan": null,
2118
2216
  "metered": null,
@@ -2347,7 +2445,7 @@ var TOOLS = [
2347
2445
  "name": "ud_get_name_registry",
2348
2446
  "operationId": "get_name_registry",
2349
2447
  "title": "Latest stored registry record of one name",
2350
- "description": "The latest stored registry record of one name: dates, registrar, status codes, nameservers, DNSSEC and holder. Pass `name` (such as get.plumbing).",
2448
+ "description": "The latest stored registry record of one name: dates, registrar, status codes, nameservers, DNSSEC and holder. Use it when someone asks who holds a name, when it was registered or when it expires. A stored record, not a live lookup. Pass `name` (such as get.plumbing).",
2351
2449
  "tier": "free",
2352
2450
  "plan": null,
2353
2451
  "metered": null,
@@ -2661,7 +2759,7 @@ var TOOLS = [
2661
2759
  "name": "ud_get_name_registry_history",
2662
2760
  "operationId": "get_name_registry_history",
2663
2761
  "title": "Stored registry record versions of one name and what moved between them",
2664
- "description": "The stored registry record versions of one name and what moved between them. Pass `name` (such as get.plumbing).",
2762
+ "description": "The stored registry record versions of one name and what moved between them. Use it when someone asks how a name's registration changed over time, such as a new registrar or a new expiry. Pass `name` (such as get.plumbing).",
2665
2763
  "tier": "keyed",
2666
2764
  "plan": "investor",
2667
2765
  "metered": null,
@@ -2905,7 +3003,7 @@ var TOOLS = [
2905
3003
  "name": "ud_get_name_dns",
2906
3004
  "operationId": "get_name_dns",
2907
3005
  "title": "Latest stored DNS reading of one name",
2908
- "description": "The latest stored DNS reading of one name, with its parking venue. Pass `name` (such as get.plumbing).",
3006
+ "description": "The latest stored DNS reading of one name, with its parking venue. Use it when someone asks whether a name points anywhere or is parked, and with which parking service. Pass `name` (such as get.plumbing).",
2909
3007
  "tier": "free",
2910
3008
  "plan": null,
2911
3009
  "metered": null,
@@ -3117,7 +3215,7 @@ var TOOLS = [
3117
3215
  "name": "ud_list_name_changes",
3118
3216
  "operationId": "list_name_changes",
3119
3217
  "title": "Change events of one name, newest first",
3120
- "description": "The change events of one name, newest first. Pass `name` (such as get.plumbing); the other inputs are optional.",
3218
+ "description": "The change events of one name, newest first. Use it when someone wants the timeline of one name's events; it answers one page at a time. Pass `name` (such as get.plumbing); the other inputs are optional.",
3121
3219
  "tier": "keyed",
3122
3220
  "plan": "investor",
3123
3221
  "metered": null,
@@ -3342,8 +3440,8 @@ var TOOLS = [
3342
3440
  {
3343
3441
  "name": "ud_get_name_history",
3344
3442
  "operationId": "get_name_history",
3345
- "title": "Web history of one name as our bands",
3346
- "description": "The web history of one name as our bands: archive captures, authority band and language. Pass `name` (such as get.plumbing).",
3443
+ "title": "Web history of one name in bands",
3444
+ "description": "The web history of one name in bands: archive captures, authority band and language. Use it when someone asks whether a name carried a website before and how established it was. Pass `name` (such as get.plumbing).",
3347
3445
  "tier": "keyed",
3348
3446
  "plan": "investor",
3349
3447
  "metered": null,
@@ -3554,7 +3652,7 @@ var TOOLS = [
3554
3652
  "name": "ud_get_name_value",
3555
3653
  "operationId": "get_name_value",
3556
3654
  "title": "Stored value estimate of one name and its last 20 estimates",
3557
- "description": "The stored value estimate of one name and its last 20 estimates. Pass `name` (such as get.plumbing).",
3655
+ "description": "The stored value estimate of one name and its last 20 estimates. Use it when someone asks what a name is worth; it reads the stored estimate and runs no new one. Pass `name` (such as get.plumbing).",
3558
3656
  "tier": "keyed",
3559
3657
  "plan": null,
3560
3658
  "metered": null,
@@ -3737,7 +3835,7 @@ var TOOLS = [
3737
3835
  "name": "ud_appraise_name",
3738
3836
  "operationId": "appraise_name",
3739
3837
  "title": "Runs the appraisal of one stored name when its estimate is missing",
3740
- "description": "Runs the appraisal of one stored name when its estimate is missing, and returns the value resource. Pass `name` (such as get.plumbing).",
3838
+ "description": "Runs the appraisal of one stored name when its estimate is missing, and returns the value estimate. Use it when a name has no stored estimate yet; each call spends one appraisal of the month. Pass `name` (such as get.plumbing).",
3741
3839
  "tier": "keyed",
3742
3840
  "plan": "investor",
3743
3841
  "metered": "Appraisal",
@@ -3919,8 +4017,8 @@ var TOOLS = [
3919
4017
  {
3920
4018
  "name": "ud_get_name_comps",
3921
4019
  "operationId": "get_name_comps",
3922
- "title": "Similar-sales aggregate of one name and the endings its word sold on",
3923
- "description": "The similar-sales aggregate of one name and the endings its word sold on. Pass `name` (such as get.plumbing).",
4020
+ "title": "Similar-sales aggregate of one name and how many endings its word sold on",
4021
+ "description": "The similar-sales aggregate of one name and how many endings its word sold on. Use it when someone asks what similar names sold for, or on how many endings the word sold. Pass `name` (such as get.plumbing).",
3924
4022
  "tier": "free",
3925
4023
  "plan": null,
3926
4024
  "metered": null,
@@ -4098,7 +4196,7 @@ var TOOLS = [
4098
4196
  "name": "ud_get_name_auction",
4099
4197
  "operationId": "get_name_auction",
4100
4198
  "title": "Open auction of one name, if any",
4101
- "description": "The open auction of one name, if any: venue, deadline, bid and the first-year cost. Pass `name` (such as get.plumbing).",
4199
+ "description": "The open auction of one name, if any: venue, deadline, bid and the first-year cost. Use it when someone asks whether a name is at auction now, its current bid or its deadline. Pass `name` (such as get.plumbing).",
4102
4200
  "tier": "free",
4103
4201
  "plan": null,
4104
4202
  "metered": null,
@@ -4301,7 +4399,7 @@ var TOOLS = [
4301
4399
  "name": "ud_resolve_word",
4302
4400
  "operationId": "resolve_word",
4303
4401
  "title": "Turns what a caller typed into the catalog word it names",
4304
- "description": "Turns what a caller typed into the catalog word it names, or up to five candidates. Pass `q` (such as harbors).",
4402
+ "description": "Turns what a caller typed into the catalog word it names, or up to five candidates. Use it first when a word is misspelled, plural or unclear, to find the catalog word the word tools take. Pass `q` (such as harbors).",
4305
4403
  "tier": "free",
4306
4404
  "plan": null,
4307
4405
  "metered": null,
@@ -4528,7 +4626,7 @@ var TOOLS = [
4528
4626
  "name": "ud_list_word_categories",
4529
4627
  "operationId": "list_word_categories",
4530
4628
  "title": "Catalog's word categories, by name",
4531
- "description": "The catalog's word categories, by name. Takes no input.",
4629
+ "description": "The catalog's word categories, by name. Use it when someone wants the word categories to browse or filter by. Takes no input.",
4532
4630
  "tier": "free",
4533
4631
  "plan": null,
4534
4632
  "metered": null,
@@ -4688,7 +4786,7 @@ var TOOLS = [
4688
4786
  "name": "ud_batch_words",
4689
4787
  "operationId": "batch_words",
4690
4788
  "title": "Up to 100 word profiles in one call",
4691
- "description": "Up to 100 word profiles in one call. Pass `words` (a list).",
4789
+ "description": "Up to 100 word profiles in one call. Use it when comparing a list of words at once. Pass `words` (a list).",
4692
4790
  "tier": "keyed",
4693
4791
  "plan": "investor",
4694
4792
  "metered": null,
@@ -5237,7 +5335,7 @@ var TOOLS = [
5237
5335
  "name": "ud_list_words",
5238
5336
  "operationId": "list_words",
5239
5337
  "title": "Searches the catalog's words by text and facets",
5240
- "description": "Searches the catalog's words by text and facets, alphabetically. Every input is optional; `limit` sets the page size.",
5338
+ "description": "Searches the catalog's words by text and facets, alphabetically. Use it when looking for words by meaning, length, style or category; it answers one page at a time. Every input is optional; `limit` sets the page size.",
5241
5339
  "tier": "keyed",
5242
5340
  "plan": null,
5243
5341
  "metered": null,
@@ -5535,7 +5633,7 @@ var TOOLS = [
5535
5633
  "name": "ud_get_word",
5536
5634
  "operationId": "get_word",
5537
5635
  "title": "A word's profile",
5538
- "description": "A word's profile: definition, facets, categories, origin and linguistics. Pass `word` (such as harbor).",
5636
+ "description": "A word's profile: definition, facets, categories, origin and linguistics. Use it when someone asks what a word means, where it comes from or how it is used. Pass `word` (such as harbor).",
5539
5637
  "tier": "keyed",
5540
5638
  "plan": null,
5541
5639
  "metered": null,
@@ -6062,8 +6160,8 @@ var TOOLS = [
6062
6160
  {
6063
6161
  "name": "ud_get_word_endings",
6064
6162
  "operationId": "get_word_endings",
6065
- "title": "A word's endings as the nightly update holds them",
6066
- "description": "A word's endings as the nightly update holds them: counts, the key endings and open names per ending. Pass `word` (such as harbor); the other inputs are optional.",
6163
+ "title": "A word's endings as stored on the latest day",
6164
+ "description": "A word's endings as stored on the latest day: counts, the key endings and the open names per ending. Use it when someone has a word and asks which endings are still open for it, such as harbor.ai or harbor.io. Pass `word` (such as harbor); the other inputs are optional.",
6067
6165
  "tier": "free",
6068
6166
  "plan": null,
6069
6167
  "metered": null,
@@ -6275,7 +6373,7 @@ var TOOLS = [
6275
6373
  "name": "ud_list_word_names",
6276
6374
  "operationId": "list_word_names",
6277
6375
  "title": "A word's catalog names on the endings that sell, by name",
6278
- "description": "A word's catalog names on the endings that sell, by name. Pass `word` (such as harbor); the other inputs are optional.",
6376
+ "description": "A word's catalog names on the endings that sell, by name. Use it when someone wants every catalog name built on one word; it answers one page at a time. Pass `word` (such as harbor); the other inputs are optional.",
6279
6377
  "tier": "keyed",
6280
6378
  "plan": null,
6281
6379
  "metered": null,
@@ -6533,7 +6631,7 @@ var TOOLS = [
6533
6631
  "name": "ud_get_word_trademarks",
6534
6632
  "operationId": "get_word_trademarks",
6535
6633
  "title": "A word's trademark counts and its exact-match marks",
6536
- "description": "A word's trademark counts and its exact-match marks. Pass `word` (such as harbor); the other inputs are optional.",
6634
+ "description": "A word's trademark counts and its exact-match marks. Use it when someone asks whether a word is a registered trademark before choosing a name. Pass `word` (such as harbor); the other inputs are optional.",
6537
6635
  "tier": "keyed",
6538
6636
  "plan": "investor",
6539
6637
  "metered": null,
@@ -6822,7 +6920,7 @@ var TOOLS = [
6822
6920
  "name": "ud_get_word_notability",
6823
6921
  "operationId": "get_word_notability",
6824
6922
  "title": "A word's Wikipedia and Wikidata facts",
6825
- "description": "A word's Wikipedia and Wikidata facts. Pass `word` (such as harbor).",
6923
+ "description": "A word's Wikipedia and Wikidata facts. Use it when someone asks how widely known a word is as a public topic. Pass `word` (such as harbor).",
6826
6924
  "tier": "free",
6827
6925
  "plan": "investor",
6828
6926
  "metered": null,
@@ -7022,8 +7120,8 @@ var TOOLS = [
7022
7120
  {
7023
7121
  "name": "ud_get_word_market",
7024
7122
  "operationId": "get_word_market",
7025
- "title": "A word's sales and auction aggregates from the nightly update",
7026
- "description": "A word's sales and auction aggregates from the nightly update. Pass `word` (such as harbor).",
7123
+ "title": "A word's stored sales and auction aggregates",
7124
+ "description": "A word's stored sales and auction aggregates. Use it when someone asks how a word sells across endings: counts, prices and auctions. Pass `word` (such as harbor).",
7027
7125
  "tier": "free",
7028
7126
  "plan": "investor",
7029
7127
  "metered": null,
@@ -7201,7 +7299,7 @@ var TOOLS = [
7201
7299
  "name": "ud_list_related_words",
7202
7300
  "operationId": "list_related_words",
7203
7301
  "title": "A word's synonyms then related words",
7204
- "description": "A word's synonyms then related words, closest first, with their open names. Pass `word` (such as harbor); the other inputs are optional.",
7302
+ "description": "A word's synonyms then related words, closest first, with their open names. Use it when the first word is taken and someone wants close alternatives that still have open names. Pass `word` (such as harbor); the other inputs are optional.",
7205
7303
  "tier": "keyed",
7206
7304
  "plan": "investor",
7207
7305
  "metered": null,
@@ -7389,7 +7487,7 @@ var TOOLS = [
7389
7487
  "name": "ud_list_word_fits",
7390
7488
  "operationId": "list_word_fits",
7391
7489
  "title": "How well the word fits each ending whose keywords list it",
7392
- "description": "How well the word fits each ending whose keywords list it. Pass `word` (such as harbor); the other inputs are optional.",
7490
+ "description": "How well the word fits each ending whose keywords list it. Use it when someone asks which endings suit a word. Pass `word` (such as harbor); the other inputs are optional.",
7393
7491
  "tier": "keyed",
7394
7492
  "plan": "investor",
7395
7493
  "metered": null,
@@ -7563,7 +7661,7 @@ var TOOLS = [
7563
7661
  "name": "ud_request_word",
7564
7662
  "operationId": "request_word",
7565
7663
  "title": "Brings a word into the catalog",
7566
- "description": "Brings a word into the catalog: checks it now and queues an accepted word for the intake. Pass `word` (such as glimmerly).",
7664
+ "description": "Brings a word into the catalog: checks it now and queues an accepted word for the intake. Use it when a word is missing from the catalog and should join it; each call counts against the month's word requests. Pass `word` (such as glimmerly).",
7567
7665
  "tier": "keyed",
7568
7666
  "plan": "investor",
7569
7667
  "metered": "Intake",
@@ -7744,7 +7842,7 @@ var TOOLS = [
7744
7842
  "name": "ud_get_word_request",
7745
7843
  "operationId": "get_word_request",
7746
7844
  "title": "State of a word request",
7747
- "description": "The state of a word request: queued, ready with its catalog word, refused or failed. Pass `requestId` (such as 6b0f6e3c-1d2a-4f6e-9a51-0c7d3b8e2f44).",
7845
+ "description": "The state of a word request: queued, ready with its catalog word, refused or failed. Use it to follow a word request until its word is ready. Pass `requestId` (such as 6b0f6e3c-1d2a-4f6e-9a51-0c7d3b8e2f44).",
7748
7846
  "tier": "keyed",
7749
7847
  "plan": "investor",
7750
7848
  "metered": null,
@@ -7950,7 +8048,7 @@ var TOOLS = [
7950
8048
  "name": "ud_list_domains",
7951
8049
  "operationId": "list_domains",
7952
8050
  "title": "One-word catalog names under filters",
7953
- "description": "One-word catalog names under filters. Every input is optional; `limit` sets the page size.",
8051
+ "description": "One-word catalog names under filters. Use it when someone wants one-word names matching filters such as ending, length or price. Neutral order, one page at a time. Every input is optional; `limit` sets the page size.",
7954
8052
  "tier": "free",
7955
8053
  "plan": null,
7956
8054
  "metered": null,
@@ -8286,12 +8384,12 @@ var TOOLS = [
8286
8384
  {
8287
8385
  "name": "ud_get_domain",
8288
8386
  "operationId": "get_domain",
8289
- "title": "One catalog name, by name or id",
8290
- "description": "One catalog name, by name or id. Pass `nameOrId` (such as get.plumbing).",
8387
+ "title": "One catalog name, by name or catalog id",
8388
+ "description": "One catalog name, by name or catalog id. Use it when someone asks about one catalog name and holds its name or its catalog id. Pass `nameOrId` (such as get.plumbing).",
8291
8389
  "tier": "free",
8292
8390
  "plan": null,
8293
8391
  "metered": null,
8294
- "hosted": true,
8392
+ "hosted": false,
8295
8393
  "inputSchema": {
8296
8394
  "type": "object",
8297
8395
  "properties": {
@@ -8750,7 +8848,7 @@ var TOOLS = [
8750
8848
  "name": "ud_list_expiring_domains",
8751
8849
  "operationId": "list_expiring_domains",
8752
8850
  "title": "Catalog names expiring or expired, by expiry day",
8753
- "description": "Catalog names expiring or expired, by expiry day. Every input is optional; `limit` sets the page size.",
8851
+ "description": "Catalog names expiring or expired, by expiry day. Use it when someone wants names whose registration is about to run out, by day. Every input is optional; `limit` sets the page size.",
8754
8852
  "tier": "keyed",
8755
8853
  "plan": "investor",
8756
8854
  "metered": null,
@@ -8964,8 +9062,8 @@ var TOOLS = [
8964
9062
  {
8965
9063
  "name": "ud_get_domain_drops",
8966
9064
  "operationId": "get_domain_drops",
8967
- "title": "Names dropping on one day",
8968
- "description": "Names dropping on one day. Every input is optional; `limit` sets the page size.",
9065
+ "title": "Names dropping on one day, counted by ending",
9066
+ "description": "The names dropping on one day, counted by ending. Use it when someone asks how many names drop on a given day, and on which endings. Every input is optional; `limit` sets the page size.",
8969
9067
  "tier": "free",
8970
9068
  "plan": null,
8971
9069
  "metered": null,
@@ -9188,7 +9286,7 @@ var TOOLS = [
9188
9286
  "name": "ud_list_domain_hacks",
9189
9287
  "operationId": "list_domain_hacks",
9190
9288
  "title": "Domain hacks",
9191
- "description": "Domain hacks: names whose ending completes the word. Every input is optional; `limit` sets the page size.",
9289
+ "description": "Domain hacks: names whose ending completes the word. Use it when someone wants a short name in which the ending spells the last letters of the word. Every input is optional; `limit` sets the page size.",
9192
9290
  "tier": "free",
9193
9291
  "plan": null,
9194
9292
  "metered": null,
@@ -9516,8 +9614,8 @@ var TOOLS = [
9516
9614
  {
9517
9615
  "name": "ud_list_domain_changes",
9518
9616
  "operationId": "list_domain_changes",
9519
- "title": "Catalog's change feed, newest first",
9520
- "description": "The catalog's change feed, newest first. Every input is optional; `limit` sets the page size.",
9617
+ "title": "Changes across the catalog's names, newest first",
9618
+ "description": "Changes across the catalog's names, newest first. Use it when following what changed across names since a day; it answers one page at a time. Every input is optional; `limit` sets the page size.",
9521
9619
  "tier": "keyed",
9522
9620
  "plan": "investor",
9523
9621
  "metered": null,
@@ -9747,7 +9845,7 @@ var TOOLS = [
9747
9845
  "name": "ud_get_catalog_stats",
9748
9846
  "operationId": "get_catalog_stats",
9749
9847
  "title": "Catalog headline totals for the latest day",
9750
- "description": "Catalog headline totals for the latest day. Takes no input.",
9848
+ "description": "Catalog headline totals for the latest day. Use it when someone asks how many names the catalog tracks and how many are open. Takes no input.",
9751
9849
  "tier": "free",
9752
9850
  "plan": null,
9753
9851
  "metered": null,
@@ -9933,7 +10031,7 @@ var TOOLS = [
9933
10031
  "name": "ud_list_tlds",
9934
10032
  "operationId": "list_tlds",
9935
10033
  "title": "Every root TLD with its registry facts and launch phases",
9936
- "description": "Every root TLD with its registry facts and launch phases, alphabetical. Every input is optional; `limit` sets the page size.",
10034
+ "description": "Every root TLD with its registry facts and launch phases, alphabetical. Use it when someone wants to browse endings by type, country or status; it answers one page at a time. Every input is optional; `limit` sets the page size.",
9937
10035
  "tier": "free",
9938
10036
  "plan": null,
9939
10037
  "metered": null,
@@ -10366,7 +10464,7 @@ var TOOLS = [
10366
10464
  "name": "ud_get_tld",
10367
10465
  "operationId": "get_tld",
10368
10466
  "title": "One TLD in full",
10369
- "description": "One TLD in full: registry facts, phases, market, quality band and registrar prices. Pass `tld` (such as ai).",
10467
+ "description": "One TLD in full: registry facts, phases, market, quality band and registrar prices. Use it when someone asks about one ending: who runs it, its launch phases, its market and its prices. Pass `tld` (such as ai).",
10370
10468
  "tier": "free",
10371
10469
  "plan": null,
10372
10470
  "metered": null,
@@ -10831,7 +10929,7 @@ var TOOLS = [
10831
10929
  "name": "ud_get_tld_stats",
10832
10930
  "operationId": "get_tld_stats",
10833
10931
  "title": "Ending's latest market figures",
10834
- "description": "The ending's latest market figures, and with history its last daily rows. Pass `tld` (such as ai); the other inputs are optional.",
10932
+ "description": "The ending's latest market figures, and with history its last daily rows. Use it when someone asks how one ending's market is doing, such as its registrations or sales over time. Pass `tld` (such as ai); the other inputs are optional.",
10835
10933
  "tier": "free",
10836
10934
  "plan": null,
10837
10935
  "metered": null,
@@ -11330,7 +11428,7 @@ var TOOLS = [
11330
11428
  "name": "ud_list_tld_phases",
11331
11429
  "operationId": "list_tld_phases",
11332
11430
  "title": "Every dated launch phase of the ending, chronological",
11333
- "description": "Every dated launch phase of the ending, chronological. Pass `tld` (such as ai).",
11431
+ "description": "Every dated launch phase of the ending, chronological. Use it when someone asks when an ending opens, such as its sunrise or general availability dates. Pass `tld` (such as ai).",
11334
11432
  "tier": "free",
11335
11433
  "plan": null,
11336
11434
  "metered": null,
@@ -11515,7 +11613,7 @@ var TOOLS = [
11515
11613
  "name": "ud_list_tld_changes",
11516
11614
  "operationId": "list_tld_changes",
11517
11615
  "title": "Ending's public registry changes, newest first",
11518
- "description": "The ending's public registry changes, newest first. Pass `tld` (such as ai); the other inputs are optional.",
11616
+ "description": "The ending's public registry changes, newest first. Use it when someone asks what changed at an ending's registry lately. Pass `tld` (such as ai); the other inputs are optional.",
11519
11617
  "tier": "free",
11520
11618
  "plan": null,
11521
11619
  "metered": null,
@@ -11696,7 +11794,7 @@ var TOOLS = [
11696
11794
  "name": "ud_list_tld_keywords",
11697
11795
  "operationId": "list_tld_keywords",
11698
11796
  "title": "Keywords the catalog attaches to the ending, by type",
11699
- "description": "The keywords the catalog attaches to the ending, by type. Pass `tld` (such as ai); the other inputs are optional.",
11797
+ "description": "The keywords the catalog attaches to the ending, by type. Use it when someone asks which words or topics an ending suits. Pass `tld` (such as ai); the other inputs are optional.",
11700
11798
  "tier": "free",
11701
11799
  "plan": null,
11702
11800
  "metered": null,
@@ -11873,7 +11971,7 @@ var TOOLS = [
11873
11971
  "name": "ud_list_tld_applications",
11874
11972
  "operationId": "list_tld_applications",
11875
11973
  "title": "2026 new gTLD round as ICANN publishes it",
11876
- "description": "The 2026 new gTLD round as ICANN publishes it, A to Z, with two simple bands. Every input is optional; `limit` sets the page size.",
11974
+ "description": "The 2026 new gTLD round as ICANN publishes it, A to Z, with two simple bands. Use it when someone asks who applied for new endings in the 2026 round, or which strings are contested. Every input is optional; `limit` sets the page size.",
11877
11975
  "tier": "free",
11878
11976
  "plan": null,
11879
11977
  "metered": null,
@@ -12213,7 +12311,7 @@ var TOOLS = [
12213
12311
  "name": "ud_list_tld_application_changes",
12214
12312
  "operationId": "list_tld_application_changes",
12215
12313
  "title": "Every recorded status or contention change of the round",
12216
- "description": "Every recorded status or contention change of the round, newest first. Every input is optional; `limit` sets the page size.",
12314
+ "description": "Every recorded status or contention change of the round, newest first. Use it when someone asks what moved in the 2026 round lately, such as a withdrawal or a contention change. Every input is optional; `limit` sets the page size.",
12217
12315
  "tier": "free",
12218
12316
  "plan": null,
12219
12317
  "metered": null,
@@ -12414,7 +12512,7 @@ var TOOLS = [
12414
12512
  "name": "ud_get_tld_application_string",
12415
12513
  "operationId": "get_tld_application_string",
12416
12514
  "title": "One applied-for string",
12417
- "description": "One applied-for string: its applications and its change history. Pass `string` (such as studio).",
12515
+ "description": "One applied-for string: its applications and its change history. Use it when someone asks about one applied-for ending, such as who applied for it. Pass `string` (such as account).",
12418
12516
  "tier": "free",
12419
12517
  "plan": null,
12420
12518
  "metered": null,
@@ -12742,7 +12840,7 @@ var TOOLS = [
12742
12840
  "name": "ud_list_registrars",
12743
12841
  "operationId": "list_registrars",
12744
12842
  "title": "Nine registrars whose daily price lists are compared",
12745
- "description": "The nine registrars whose daily price lists are compared, in catalog order. Takes no input.",
12843
+ "description": "The nine registrars whose daily price lists are compared, in catalog order. Use it when someone asks which registrars the price comparisons cover. Takes no input.",
12746
12844
  "tier": "free",
12747
12845
  "plan": null,
12748
12846
  "metered": null,
@@ -12952,7 +13050,7 @@ var TOOLS = [
12952
13050
  "name": "ud_list_registrar_prices",
12953
13051
  "operationId": "list_registrar_prices",
12954
13052
  "title": "A registrar's list prices, alphabetical by ending",
12955
- "description": "A registrar's list prices, alphabetical by ending. Pass `registrar` (such as namecheap); the other inputs are optional.",
13053
+ "description": "A registrar's list prices, alphabetical by ending. Use it when someone asks what one registrar charges for its endings, first year and renewal. Pass `registrar` (such as namecheap); the other inputs are optional.",
12956
13054
  "tier": "free",
12957
13055
  "plan": null,
12958
13056
  "metered": null,
@@ -13196,7 +13294,7 @@ var TOOLS = [
13196
13294
  "name": "ud_list_registrar_changes",
13197
13295
  "operationId": "list_registrar_changes",
13198
13296
  "title": "A registrar's confirmed list-price changes, newest first",
13199
- "description": "A registrar's confirmed list-price changes, newest first. Pass `registrar` (such as namecheap).",
13297
+ "description": "A registrar's confirmed list-price changes, newest first. Use it when someone asks how one registrar's prices changed lately. Pass `registrar` (such as namecheap).",
13200
13298
  "tier": "free",
13201
13299
  "plan": null,
13202
13300
  "metered": null,
@@ -13410,7 +13508,7 @@ var TOOLS = [
13410
13508
  "name": "ud_get_registrar_footprint",
13411
13509
  "operationId": "get_registrar_footprint",
13412
13510
  "title": "Names tracked under the registrar on the latest footprint day",
13413
- "description": "Names tracked under the registrar on the latest footprint day, rounded, with its top endings. Pass `registrar` (such as namecheap).",
13511
+ "description": "Names tracked under the registrar on the latest footprint day, rounded, with its top endings. Use it when someone asks how many names a registrar holds and on which endings. Pass `registrar` (such as namecheap).",
13414
13512
  "tier": "keyed",
13415
13513
  "plan": null,
13416
13514
  "metered": null,
@@ -13604,7 +13702,7 @@ var TOOLS = [
13604
13702
  "name": "ud_list_tld_prices",
13605
13703
  "operationId": "list_tld_prices",
13606
13704
  "title": "Every registrar's list price for one ending",
13607
- "description": "Every registrar's list price for one ending, with the cheapest and trap marks. Pass `tld` (such as io).",
13705
+ "description": "Every registrar's list price for one ending, with the cheapest and trap marks. Use it when someone asks where one ending is cheapest to register or to renew. Pass `tld` (such as io).",
13608
13706
  "tier": "free",
13609
13707
  "plan": null,
13610
13708
  "metered": null,
@@ -13844,7 +13942,7 @@ var TOOLS = [
13844
13942
  "name": "ud_list_tld_price_history",
13845
13943
  "operationId": "list_tld_price_history",
13846
13944
  "title": "Change-only price rows of one ending, newest first",
13847
- "description": "Change-only price rows of one ending, newest first. Pass `tld` (such as io); the other inputs are optional.",
13945
+ "description": "Change-only price rows of one ending, newest first. Use it when someone asks how one ending's price moved over time. Pass `tld` (such as io); the other inputs are optional.",
13848
13946
  "tier": "keyed",
13849
13947
  "plan": "investor",
13850
13948
  "metered": null,
@@ -14088,7 +14186,7 @@ var TOOLS = [
14088
14186
  "name": "ud_list_price_changes",
14089
14187
  "operationId": "list_price_changes",
14090
14188
  "title": "Confirmed registrar price changes across the nine",
14091
- "description": "Confirmed registrar price changes across the nine, newest first. Every input is optional.",
14189
+ "description": "Confirmed registrar price changes across the nine, newest first. Use it when someone asks which registrar prices changed lately. Every input is optional.",
14092
14190
  "tier": "free",
14093
14191
  "plan": null,
14094
14192
  "metered": null,
@@ -14320,7 +14418,7 @@ var TOOLS = [
14320
14418
  "name": "ud_list_price_traps",
14321
14419
  "operationId": "list_price_traps",
14322
14420
  "title": "Endings whose cheapest first year renews at a trap price",
14323
- "description": "Endings whose cheapest first year renews at a trap price, alphabetical. Every input is optional.",
14421
+ "description": "Endings whose cheapest first year renews at a trap price, alphabetical. Use it when someone wants to avoid endings that are cheap the first year and costly to renew. Every input is optional.",
14324
14422
  "tier": "free",
14325
14423
  "plan": null,
14326
14424
  "metered": null,
@@ -14521,7 +14619,7 @@ var TOOLS = [
14521
14619
  "name": "ud_list_cheapest_prices",
14522
14620
  "operationId": "list_cheapest_prices",
14523
14621
  "title": "Cheapest registrar per ending for up to 100 endings",
14524
- "description": "The cheapest registrar per ending for up to 100 endings. Pass `tlds` (such as ai,io).",
14622
+ "description": "The cheapest registrar per ending for up to 100 endings. Use it when comparing where a list of endings is cheapest, all at once. Pass `tlds` (such as ai,io).",
14525
14623
  "tier": "keyed",
14526
14624
  "plan": null,
14527
14625
  "metered": null,
@@ -14742,7 +14840,7 @@ var TOOLS = [
14742
14840
  "name": "ud_list_venues",
14743
14841
  "operationId": "list_venues",
14744
14842
  "title": "Parking and marketplace venues with a profile and their rounded footprint",
14745
- "description": "The parking and marketplace venues with a profile and their rounded footprint. Takes no input.",
14843
+ "description": "The parking and marketplace venues with a profile and their rounded footprint. Use it when someone asks which marketplaces or parking services list names, and how many. Takes no input.",
14746
14844
  "tier": "free",
14747
14845
  "plan": null,
14748
14846
  "metered": null,
@@ -14994,7 +15092,7 @@ var TOOLS = [
14994
15092
  "name": "ud_get_venue",
14995
15093
  "operationId": "get_venue",
14996
15094
  "title": "One venue's profile with its verified listing terms",
14997
- "description": "One venue's profile with its verified listing terms. Pass `id` (such as afternic).",
15095
+ "description": "One venue's profile with its verified listing terms. Use it when someone asks about one marketplace's or parking service's terms, such as its commission. Pass `id` (such as afternic).",
14998
15096
  "tier": "free",
14999
15097
  "plan": null,
15000
15098
  "metered": null,
@@ -15270,8 +15368,8 @@ var TOOLS = [
15270
15368
  {
15271
15369
  "name": "ud_list_iana_registrars",
15272
15370
  "operationId": "list_iana_registrars",
15273
- "title": "IANA registrar list as the registry sync stores it",
15274
- "description": "The IANA registrar list as the registry sync stores it, by id. Every input is optional; `limit` sets the page size.",
15371
+ "title": "IANA registrar list as stored, by IANA id",
15372
+ "description": "The IANA registrar list as stored, by IANA id. Use it when someone asks for accredited registrars beyond the nine compared; it answers one page at a time. Every input is optional; `limit` sets the page size.",
15275
15373
  "tier": "free",
15276
15374
  "plan": null,
15277
15375
  "metered": null,
@@ -15458,7 +15556,7 @@ var TOOLS = [
15458
15556
  "name": "ud_get_iana_registrar",
15459
15557
  "operationId": "get_iana_registrar",
15460
15558
  "title": "One IANA registrar by id",
15461
- "description": "One IANA registrar by id. Pass `id` (such as 1861).",
15559
+ "description": "One IANA registrar by id. Use it when someone holds an IANA registrar number and asks who it is. Pass `id` (such as 1861).",
15462
15560
  "tier": "free",
15463
15561
  "plan": null,
15464
15562
  "metered": null,
@@ -15630,7 +15728,7 @@ var TOOLS = [
15630
15728
  "name": "ud_get_market_sales",
15631
15729
  "operationId": "get_market_sales",
15632
15730
  "title": "Domain sales pulse as headline aggregates",
15633
- "description": "The domain sales pulse as headline aggregates: windows, price bands and the sold-before count. Takes no input.",
15731
+ "description": "The domain sales pulse as headline aggregates: windows, price bands and the sold-before count. Use it when someone asks how the domain sales market is doing overall. Takes no input.",
15634
15732
  "tier": "free",
15635
15733
  "plan": null,
15636
15734
  "metered": null,
@@ -15866,7 +15964,7 @@ var TOOLS = [
15866
15964
  "name": "ud_list_market_sales_series",
15867
15965
  "operationId": "list_market_sales_series",
15868
15966
  "title": "One sales series by day, week or month, oldest first",
15869
- "description": "One sales series by day, week or month, oldest first. Pass `kind` (such as week).",
15967
+ "description": "One sales series by day, week or month, oldest first. Use it when someone wants sales over time, to chart them or compare periods. Pass `kind` (such as week).",
15870
15968
  "tier": "free",
15871
15969
  "plan": null,
15872
15970
  "metered": null,
@@ -16057,7 +16155,7 @@ var TOOLS = [
16057
16155
  "name": "ud_list_market_sales_endings",
16058
16156
  "operationId": "list_market_sales_endings",
16059
16157
  "title": "Each ending's 12-month and 30-day sales figures",
16060
- "description": "Each ending's 12-month and 30-day sales figures, alphabetical. Takes no input.",
16158
+ "description": "Each ending's 12-month and 30-day sales figures, alphabetical. Use it when someone asks which endings sell and at what median price. Takes no input.",
16061
16159
  "tier": "free",
16062
16160
  "plan": null,
16063
16161
  "metered": null,
@@ -16249,7 +16347,7 @@ var TOOLS = [
16249
16347
  "name": "ud_get_market_sales_lengths",
16250
16348
  "operationId": "get_market_sales_lengths",
16251
16349
  "title": "Sales by label length for .com, .ai, .io and .co",
16252
- "description": "Sales by label length for .com, .ai, .io and .co. Takes no input.",
16350
+ "description": "Sales by label length for .com, .ai, .io and .co. Use it when someone asks how the length of a name relates to its sale price. Takes no input.",
16253
16351
  "tier": "free",
16254
16352
  "plan": null,
16255
16353
  "metered": null,
@@ -16593,7 +16691,7 @@ var TOOLS = [
16593
16691
  "name": "ud_list_market_sales_movers",
16594
16692
  "operationId": "list_market_sales_movers",
16595
16693
  "title": "Up to ten words whose sales moved over the last 30 days",
16596
- "description": "Up to ten words whose sales moved over the last 30 days. Takes no input.",
16694
+ "description": "Up to ten words whose sales moved over the last 30 days. Use it when someone asks which words are selling more or less lately. Takes no input.",
16597
16695
  "tier": "free",
16598
16696
  "plan": null,
16599
16697
  "metered": null,
@@ -16781,7 +16879,7 @@ var TOOLS = [
16781
16879
  "name": "ud_get_market_sales_word",
16782
16880
  "operationId": "get_market_sales_word",
16783
16881
  "title": "One word's sales market over 12 months",
16784
- "description": "One word's sales market over 12 months: count, median, endings sold on and the latest sale's month. Pass `word` (such as hive).",
16882
+ "description": "One word's sales market over 12 months: count, median, endings sold on and the latest sale's month. Use it when someone asks how one word has sold over the last year. Pass `word` (such as hive).",
16785
16883
  "tier": "free",
16786
16884
  "plan": null,
16787
16885
  "metered": null,
@@ -16965,7 +17063,7 @@ var TOOLS = [
16965
17063
  "name": "ud_get_market_auctions",
16966
17064
  "operationId": "get_market_auctions",
16967
17065
  "title": "Today's domain auctions by venue",
16968
- "description": "Today's domain auctions by venue, ending and length, the next seven days and the tracked counts. Takes no input.",
17066
+ "description": "Today's domain auctions by venue, ending and length, the next seven days and the tracked counts. Use it when someone asks about today's auction market as a whole. Takes no input.",
16969
17067
  "tier": "free",
16970
17068
  "plan": null,
16971
17069
  "metered": null,
@@ -17249,7 +17347,7 @@ var TOOLS = [
17249
17347
  "name": "ud_list_market_auctions_sample",
17250
17348
  "operationId": "list_market_auctions_sample",
17251
17349
  "title": "Day's fixed sample of up to 20 single-word names at auction",
17252
- "description": "The day's fixed sample of up to 20 single-word names at auction, by deadline. Takes no input.",
17350
+ "description": "The day's fixed sample of up to 20 single-word names at auction, by deadline. Use it when someone wants examples of single-word names at auction today. A fixed daily sample, not every auction. Takes no input.",
17253
17351
  "tier": "free",
17254
17352
  "plan": null,
17255
17353
  "metered": null,
@@ -17465,7 +17563,7 @@ var TOOLS = [
17465
17563
  "name": "ud_list_market_auction_venues",
17466
17564
  "operationId": "list_market_auction_venues",
17467
17565
  "title": "Seven auction venues with their verified rules and today's counts",
17468
- "description": "The seven auction venues with their verified rules and today's counts. Takes no input.",
17566
+ "description": "The seven auction venues with their verified rules and today's counts. Use it when someone asks how an auction venue works, or how many auctions it runs today. Takes no input.",
17469
17567
  "tier": "free",
17470
17568
  "plan": null,
17471
17569
  "metered": null,
@@ -17739,7 +17837,7 @@ var TOOLS = [
17739
17837
  "name": "ud_list_market_auction_outcomes",
17740
17838
  "operationId": "list_market_auction_outcomes",
17741
17839
  "title": "Confirmed auction outcomes by venue",
17742
- "description": "Confirmed auction outcomes by venue, day and currency, as counts and medians. Every input is optional; `limit` sets the page size.",
17840
+ "description": "Confirmed auction outcomes by venue, day and currency, as counts and medians. Use it when someone asks how auctions end at a venue, such as how many sell and at what median. Every input is optional; `limit` sets the page size.",
17743
17841
  "tier": "keyed",
17744
17842
  "plan": "investor",
17745
17843
  "metered": null,
@@ -17936,7 +18034,7 @@ var TOOLS = [
17936
18034
  "name": "ud_list_trends",
17937
18035
  "operationId": "list_trends",
17938
18036
  "title": "Every published trend with its latest edition figures and its first and last edition day",
17939
- "description": "Every published trend with its latest edition figures and its first and last edition day. Every input is optional; `limit` sets the page size.",
18037
+ "description": "Every published trend with its latest edition figures and its first and last edition day. Use it when someone looks for rising topics to name a project after; it answers one page at a time. Every input is optional; `limit` sets the page size.",
17940
18038
  "tier": "free",
17941
18039
  "plan": null,
17942
18040
  "metered": null,
@@ -18206,7 +18304,7 @@ var TOOLS = [
18206
18304
  "name": "ud_get_trend",
18207
18305
  "operationId": "get_trend",
18208
18306
  "title": "One trend",
18209
- "description": "One trend: its latest row, its head words, its figures at every edition and its latest observations. Pass `slug` (such as padel).",
18307
+ "description": "One trend: its latest row, its head words, its figures at every edition and its latest observations. Use it when someone asks about one trend: how it grew and its key words. Pass `slug` (such as ambient-lights).",
18210
18308
  "tier": "free",
18211
18309
  "plan": null,
18212
18310
  "metered": null,
@@ -18524,8 +18622,8 @@ var TOOLS = [
18524
18622
  {
18525
18623
  "name": "ud_list_trend_categories",
18526
18624
  "operationId": "list_trend_categories",
18527
- "title": "Trend categories, the `category` filter of `GET /trends`",
18528
- "description": "The trend categories, the `category` filter of `GET /trends`. Takes no input.",
18625
+ "title": "Trend categories, to narrow the trends by",
18626
+ "description": "The trend categories, to narrow the trends by. Use it when someone wants trends from one field only, such as business or health. Takes no input.",
18529
18627
  "tier": "free",
18530
18628
  "plan": null,
18531
18629
  "metered": null,
@@ -18677,8 +18775,8 @@ var TOOLS = [
18677
18775
  {
18678
18776
  "name": "ud_list_trend_pool",
18679
18777
  "operationId": "list_trend_pool",
18680
- "title": "Admitted trend candidates the editions draw from",
18681
- "description": "The admitted trend candidates the editions draw from, with their observations. Every input is optional; `limit` sets the page size.",
18778
+ "title": "Trend candidates the daily editions draw from",
18779
+ "description": "The trend candidates the daily editions draw from, with their observations. Use it when someone wants trends before the editions publish them; it answers one page at a time. Every input is optional; `limit` sets the page size.",
18682
18780
  "tier": "keyed",
18683
18781
  "plan": null,
18684
18782
  "metered": null,
@@ -18922,7 +19020,7 @@ var TOOLS = [
18922
19020
  "name": "ud_list_events",
18923
19021
  "operationId": "list_events",
18924
19022
  "title": "Industry events of one month",
18925
- "description": "The industry events of one month, in date order, then the events still without a date. Every input is optional.",
19023
+ "description": "The industry events of one month, in date order, then the events still without a date. Use it when someone asks about domain or internet industry events in a month. Every input is optional.",
18926
19024
  "tier": "free",
18927
19025
  "plan": null,
18928
19026
  "metered": null,
@@ -19172,7 +19270,7 @@ var TOOLS = [
19172
19270
  "name": "ud_get_event",
19173
19271
  "operationId": "get_event",
19174
19272
  "title": "One industry event with its organizer",
19175
- "description": "One industry event with its organizer, location and description. Pass `slug` (such as namescon-global-2026).",
19273
+ "description": "One industry event with its organizer, location and description. Use it when someone asks for the details of one event. Pass `slug` (such as registrar-day-afnic-2027).",
19176
19274
  "tier": "free",
19177
19275
  "plan": null,
19178
19276
  "metered": null,
@@ -19433,7 +19531,7 @@ var TOOLS = [
19433
19531
  "name": "ud_get_agenda",
19434
19532
  "operationId": "get_agenda",
19435
19533
  "title": "Whole public agenda of one month",
19436
- "description": "The whole public agenda of one month: industry events, TLD launch phases and registry changes. Every input is optional.",
19534
+ "description": "The whole public agenda of one month: industry events, TLD launch phases and registry changes. Use it when someone asks what happens in a month: events, ending launches and registry changes. Every input is optional.",
19437
19535
  "tier": "free",
19438
19536
  "plan": null,
19439
19537
  "metered": null,
@@ -19892,8 +19990,8 @@ var TOOLS = [
19892
19990
  {
19893
19991
  "name": "ud_get_latest_edition",
19894
19992
  "operationId": "get_latest_edition",
19895
- "title": "Latest published daily edition of one page",
19896
- "description": "The latest published daily edition of one page. Pass `persona` (such as founder).",
19993
+ "title": "Latest daily edition of Business Ideas or Trending Domains",
19994
+ "description": "The latest daily edition of Business Ideas or Trending Domains: trends with open names, for founders or for investors. Use it when someone wants today's name ideas from rising topics; it carries the edition's open names only. Pass `persona` (such as founder).",
19897
19995
  "tier": "free",
19898
19996
  "plan": null,
19899
19997
  "metered": null,
@@ -20363,8 +20461,8 @@ var TOOLS = [
20363
20461
  {
20364
20462
  "name": "ud_get_edition",
20365
20463
  "operationId": "get_edition",
20366
- "title": "One dated published edition of one page",
20367
- "description": "One dated published edition of one page. Pass `persona` (such as founder) and `date` (such as 2026-11-02).",
20464
+ "title": "One dated daily edition of Business Ideas or Trending Domains",
20465
+ "description": "One dated daily edition of Business Ideas or Trending Domains: founders read the first, investors the second. Use it when someone asks about a past day's edition. Pass `persona` (such as founder) and `date` (such as 2026-11-10).",
20368
20466
  "tier": "free",
20369
20467
  "plan": null,
20370
20468
  "metered": null,
@@ -20839,8 +20937,8 @@ var TOOLS = [
20839
20937
  {
20840
20938
  "name": "ud_get_meta_enums",
20841
20939
  "operationId": "get_meta_enums",
20842
- "title": "Every enum the payloads use, read from the code catalogs",
20843
- "description": "Every enum the payloads use, read from the code catalogs. Takes no input.",
20940
+ "title": "Every list of values the answers use",
20941
+ "description": "Every list of values the answers use, such as statuses, venues and bands. Use it when an answer holds a code and someone needs its meaning. Takes no input.",
20844
20942
  "tier": "free",
20845
20943
  "plan": null,
20846
20944
  "metered": null,
@@ -21086,12 +21184,12 @@ var TOOLS = [
21086
21184
  {
21087
21185
  "name": "ud_get_meta_freshness",
21088
21186
  "operationId": "get_meta_freshness",
21089
- "title": "How current the scanner's passes are",
21090
- "description": "How current the scanner's passes are: the day's counts and each lane's state. Takes no input.",
21187
+ "title": "How current each part of the stored data is",
21188
+ "description": "How current each part of the stored data is, with the day's counts. Use it when someone asks how fresh the stored data is. Takes no input.",
21091
21189
  "tier": "free",
21092
21190
  "plan": null,
21093
21191
  "metered": null,
21094
- "hosted": true,
21192
+ "hosted": false,
21095
21193
  "inputSchema": {
21096
21194
  "type": "object",
21097
21195
  "properties": {
@@ -21270,8 +21368,8 @@ var TOOLS = [
21270
21368
  {
21271
21369
  "name": "ud_list_meta_datasets",
21272
21370
  "operationId": "list_meta_datasets",
21273
- "title": "GitHub datasets and the API path serving the same rows",
21274
- "description": "The GitHub datasets and the API path serving the same rows. Takes no input.",
21371
+ "title": "Free GitHub datasets that hold the same rows as these answers",
21372
+ "description": "The free GitHub datasets that hold the same rows as these answers. Use it when someone wants the data in bulk, as files. Takes no input.",
21275
21373
  "tier": "free",
21276
21374
  "plan": null,
21277
21375
  "metered": null,
@@ -21447,7 +21545,7 @@ var TOOLS = [
21447
21545
  "name": "ud_list_meta_trademark_classes",
21448
21546
  "operationId": "list_meta_trademark_classes",
21449
21547
  "title": "45 Nice classes a trademark is filed under",
21450
- "description": "The 45 Nice classes a trademark is filed under. Takes no input.",
21548
+ "description": "The 45 Nice classes a trademark is filed under. Use it when a trademark answer names a class number and someone needs what it covers. Takes no input.",
21451
21549
  "tier": "free",
21452
21550
  "plan": null,
21453
21551
  "metered": null,
@@ -21603,7 +21701,7 @@ var TOOLS = [
21603
21701
  "name": "ud_get_meta_providers",
21604
21702
  "operationId": "get_meta_providers",
21605
21703
  "title": "Registrar identities and the auction venue and parking service catalogs",
21606
- "description": "Registrar identities and the auction venue and parking service catalogs. Takes no input.",
21704
+ "description": "Registrar identities and the auction venue and parking service catalogs. Use it when someone needs every registrar, auction venue and parking service an answer may name. Takes no input.",
21607
21705
  "tier": "free",
21608
21706
  "plan": null,
21609
21707
  "metered": null,
@@ -21811,8 +21909,8 @@ var TOOLS = [
21811
21909
  {
21812
21910
  "name": "ud_get_key",
21813
21911
  "operationId": "get_key",
21814
- "title": "Calling key's own plan, allowances and month",
21815
- "description": "The calling key's own plan, allowances and month. Takes no input.",
21912
+ "title": "What the calling member key opens",
21913
+ "description": "What the calling member key opens: its allowances and its month. Use it when someone asks how many calls or checks are left this month. Takes no input.",
21816
21914
  "tier": "keyed",
21817
21915
  "plan": null,
21818
21916
  "metered": null,
@@ -22101,13 +22199,13 @@ var TOOLS = [
22101
22199
 
22102
22200
  // src/server.ts
22103
22201
  import { Server } from "@modelcontextprotocol/sdk/server/index.js";
22104
- import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
22202
+ import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError } from "@modelcontextprotocol/sdk/types.js";
22105
22203
  import { ApiProblemError as ApiProblemError2, createClient } from "@uniquedomains/sdk";
22106
22204
 
22107
22205
  // package.json
22108
22206
  var package_default = {
22109
22207
  name: "@uniquedomains/mcp-server",
22110
- version: "0.1.2",
22208
+ version: "0.1.4",
22111
22209
  description: "MCP server for the Unique Domains API: domain names, words, TLDs, registrar prices, the domain market, trends and the agenda.",
22112
22210
  license: "MIT",
22113
22211
  author: "Unique Domains (https://unique.domains)",
@@ -22156,6 +22254,7 @@ var package_default = {
22156
22254
  "check:text": "node scripts/check-text.mjs",
22157
22255
  plugin: "node scripts/plugin-manifest.mjs",
22158
22256
  "plugin:test": "node scripts/plugin-manifest.mjs --allow-placeholder",
22257
+ "plugin:devin": "node scripts/devin-plugin.mjs",
22159
22258
  smoke: "node scripts/smoke.mjs",
22160
22259
  prepack: "npm run build"
22161
22260
  },
@@ -22175,11 +22274,12 @@ var package_default = {
22175
22274
  // src/server.ts
22176
22275
  var SERVER_NAME = "uniquedomains";
22177
22276
  var SERVER_VERSION = package_default.version;
22178
- var INSTRUCTIONS = [
22277
+ var instructionsFor = (profile) => [
22179
22278
  "Unique Domains reads its own catalog of domain names, words, TLDs, registrar prices, the domain market, trends and the industry agenda.",
22180
- "Answers are stored data as of their day, unless a tool says it reads live; `links.details` points at the public page about the subject when there is one.",
22279
+ `Answers are stored data as of their day${profile === "local" ? ", unless a tool says it reads live" : ""}; \`links.details\` points at the public page about the subject when there is one.`,
22181
22280
  "Pass a full domain name such as get.plumbing to the name tools, and an ending without its dot such as ai to the TLD tools."
22182
22281
  ].join(" ");
22282
+ var INSTRUCTIONS = instructionsFor("local");
22183
22283
  var userAgent = (config) => `uniquedomains-mcp-server/${SERVER_VERSION} (${config.profile})`;
22184
22284
  var createApiClient = (config, fetchImpl) => createClient({
22185
22285
  // null, never undefined: the SDK would otherwise read UD_API_KEY from the environment (the hosted profile ignores it).
@@ -22224,7 +22324,7 @@ var toListedTool = (tool, profile, plan) => ({
22224
22324
  annotations: { title: tool.title, ...tool.annotations }
22225
22325
  });
22226
22326
  var createMcpServer = (prepared, overrides = {}) => {
22227
- const server = new Server({ name: SERVER_NAME, title: "Unique Domains", version: SERVER_VERSION }, { capabilities: { tools: { listChanged: false } }, instructions: INSTRUCTIONS });
22327
+ const server = new Server({ name: SERVER_NAME, title: "Unique Domains", version: SERVER_VERSION }, { capabilities: { tools: { listChanged: false } }, instructions: instructionsFor(prepared.config.profile) });
22228
22328
  const byName = new Map(prepared.tools.map((tool) => [tool.name, tool]));
22229
22329
  const context = {
22230
22330
  client: prepared.client,
@@ -22236,9 +22336,7 @@ var createMcpServer = (prepared, overrides = {}) => {
22236
22336
  server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: [...prepared.listed] }));
22237
22337
  server.setRequestHandler(CallToolRequestSchema, async (request) => {
22238
22338
  const tool = byName.get(request.params.name);
22239
- if (tool === void 0) {
22240
- return { isError: true, content: [{ type: "text", text: `There is no tool named ${request.params.name}. Call tools/list for the tools this server offers.` }] };
22241
- }
22339
+ if (tool === void 0) throw new McpError(ErrorCode.InvalidParams, `There is no tool named ${request.params.name}. Call tools/list for the tools this server offers.`);
22242
22340
  return runTool(context, tool, request.params.arguments);
22243
22341
  });
22244
22342
  return server;
@@ -22257,7 +22355,15 @@ export {
22257
22355
  detailsFor,
22258
22356
  DETAILS_SAMPLES,
22259
22357
  selectTools,
22358
+ KEYLESS_LIMIT_MAX,
22260
22359
  PLAN_TALK,
22360
+ inputSchemaFor,
22361
+ HOSTED_DROPPED_STAMPS,
22362
+ HOSTED_KEPT_TIMES,
22363
+ isInternalId,
22364
+ HOSTED_INTERNAL_ID_PATHS,
22365
+ HOSTED_PUBLIC_ID_PATHS,
22366
+ trimHosted,
22261
22367
  outputSchemaFor,
22262
22368
  shapeAnswer,
22263
22369
  textLine,
@@ -22271,6 +22377,7 @@ export {
22271
22377
  TOOLS,
22272
22378
  SERVER_NAME,
22273
22379
  SERVER_VERSION,
22380
+ instructionsFor,
22274
22381
  INSTRUCTIONS,
22275
22382
  createApiClient,
22276
22383
  readKeyPlan,