@uniquedomains/mcp-server 0.1.5 → 0.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -28
- package/dist/{chunk-DKMT6N3J.js → chunk-7ZS4RGD2.js} +1 -1
- package/dist/{chunk-GYZHSVAG.js → chunk-R4363ZCJ.js} +293 -457
- package/dist/http.js +2 -2
- package/dist/index.js +2 -2
- package/dist/stdio.js +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# Unique.domains MCP server
|
|
2
2
|
|
|
3
|
-
Without a tool, an assistant can only guess whether a domain name is taken. This server gives it the record: 34 million one-word names on 505 endings (TLDs), read every day
|
|
3
|
+
Without a tool, an assistant can only guess whether a domain name is taken. This server gives it the record: 34 million one-word names on 505 endings (TLDs), read every day.
|
|
4
4
|
|
|
5
5
|
- Hosted, nothing to install, no key: `https://mcp.unique.domains/mcp` (51 tools)
|
|
6
|
-
- On your machine: `npx -y @uniquedomains/mcp-server` (
|
|
6
|
+
- On your machine: `npx -y @uniquedomains/mcp-server` (55 tools without a key)
|
|
7
7
|
|
|
8
|
-
One question, one tool call. "Is get.plumbing taken?"
|
|
8
|
+
One question, one tool call. "Is get.plumbing taken?" gets this answer:
|
|
9
9
|
|
|
10
10
|
```json
|
|
11
11
|
{
|
|
@@ -25,11 +25,11 @@ What the tools read:
|
|
|
25
25
|
- **A name:** [status, price today](https://unique.domains/availability), drop day, [the registry record a WHOIS lookup shows](https://unique.domains/whois), DNS, similar sales and its open auction.
|
|
26
26
|
- **A word:** the endings it is still open on. Each word exists once on each ending.
|
|
27
27
|
- **An ending:** [registry facts, launch phases, market figures](https://unique.domains/tld), and [ICANN's 2026 new gTLD applications](https://unique.domains/tld/applications).
|
|
28
|
-
- **Registrar prices:** [nine registrars' lists](https://unique.domains/registrars), read daily, with each confirmed change and over 300 renewal traps (.agency: $3.50 the first year, $28.04 a year after
|
|
28
|
+
- **Registrar prices:** [nine registrars' lists](https://unique.domains/registrars), read daily, with each confirmed change and over 300 renewal traps (.agency: $3.50 the first year, $28.04 a year after).
|
|
29
29
|
- **The market:** [over 200,000 auctions closing a day](https://unique.domains/auctions) across seven venues, and [12 months of sales](https://unique.domains/sales) as totals.
|
|
30
30
|
- **Trends and the agenda:** the naming trends of two daily editions, [Trending Domains](https://unique.domains/trending-domains) and [Business Ideas](https://unique.domains/business-ideas), and [the month's launch dates](https://unique.domains/agenda).
|
|
31
31
|
|
|
32
|
-
No tool here registers, buys or changes a name.
|
|
32
|
+
No tool here registers, buys or changes a name.
|
|
33
33
|
|
|
34
34
|
Three questions to try:
|
|
35
35
|
|
|
@@ -132,14 +132,14 @@ UD_API_KEY=ud_live_your_key npx -y @uniquedomains/mcp-server
|
|
|
132
132
|
|
|
133
133
|
The server reads the key's plan once at start and lists the tools that plan opens. The plans are described at [unique.domains/api](https://unique.domains/api).
|
|
134
134
|
|
|
135
|
-
The hosted connector serves the free tools only and takes no key.
|
|
135
|
+
The hosted connector serves the free tools only and takes no key. Four free tools are on the npm server only. Three answer one word or one ending a caller a day, and the hosted connector is one caller for all its users: `ud_get_market_sales_word`, `ud_get_word_market`, `ud_list_tld_prices`. `ud_get_domain` answers what `ud_get_name` answers.
|
|
136
136
|
|
|
137
137
|
## What an answer holds
|
|
138
138
|
|
|
139
139
|
- `structuredContent`: the API's `data`, `meta` and `links`, as the tool's output schema describes them.
|
|
140
140
|
- `content`: one line for a reader (the name and its headline fact, or the row count and the first names), then the same JSON as text.
|
|
141
141
|
- `links.details`: the public Unique.domains page about the subject, when there is one (hosted connector).
|
|
142
|
-
- On the hosted connector, internal ids (catalog ids, row ids, UUIDs) are left out, times become their UTC day (an auction's deadline keeps its hour),
|
|
142
|
+
- On the hosted connector, internal ids (catalog ids, row ids, UUIDs) are left out, times become their UTC day (an auction's deadline keeps its hour), the stamps of when a figure was computed are dropped, and a registry record comes without its `transport` field. The npm server and the API keep them.
|
|
143
143
|
- A list answers 20 rows by default. When `meta.cursor` is set, pass it as `cursor` to read the next page.
|
|
144
144
|
- A refusal is a sentence the assistant can act on: what was wrong, what is accepted, or when a limit resets.
|
|
145
145
|
|
|
@@ -161,21 +161,21 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
161
161
|
|
|
162
162
|
<!-- tools:start (generated by scripts/generate.mjs) -->
|
|
163
163
|
|
|
164
|
-
|
|
164
|
+
55 tools answer without a key (51 on the hosted connector); a member key adds 25 more, the Investor ones for an Investor key only.
|
|
165
165
|
|
|
166
166
|
| Tool | What it reads | Needs |
|
|
167
167
|
|---|---|---|
|
|
168
|
-
| `ud_get_name` |
|
|
169
|
-
| `ud_batch_names` |
|
|
170
|
-
| `ud_check_name` |
|
|
171
|
-
| `ud_get_name_prices` | Every
|
|
172
|
-
| `ud_get_name_registry` |
|
|
173
|
-
| `ud_get_name_registry_history` |
|
|
174
|
-
| `ud_get_name_dns` |
|
|
168
|
+
| `ud_get_name` | Answer for one domain name | free |
|
|
169
|
+
| `ud_batch_names` | Answers for up to 100 domain names in one call | Investor key |
|
|
170
|
+
| `ud_check_name` | Runs a live check of one name and returns the full name answer | member key |
|
|
171
|
+
| `ud_get_name_prices` | Every registrar quote for one name | member key |
|
|
172
|
+
| `ud_get_name_registry` | Registry record of one name | free |
|
|
173
|
+
| `ud_get_name_registry_history` | Past versions of one name's registry record and what moved between them | Investor key |
|
|
174
|
+
| `ud_get_name_dns` | DNS records of one name, with its parking venue | free |
|
|
175
175
|
| `ud_list_name_changes` | Change events of one name, newest first | Investor key |
|
|
176
176
|
| `ud_get_name_history` | Web history of one name in bands | Investor key |
|
|
177
|
-
| `ud_get_name_value` |
|
|
178
|
-
| `ud_appraise_name` | Runs the appraisal of one
|
|
177
|
+
| `ud_get_name_value` | Value estimate of one name and its last 20 estimates | member key |
|
|
178
|
+
| `ud_appraise_name` | Runs the appraisal of one catalog name when its estimate is missing | Investor key |
|
|
179
179
|
| `ud_get_name_comps` | Similar-sales aggregate of one name and how many endings its word sold on | free |
|
|
180
180
|
| `ud_get_name_auction` | Open auction of one name, if any | free |
|
|
181
181
|
| `ud_resolve_word` | Turns what a caller typed into the catalog word it names | free |
|
|
@@ -183,11 +183,11 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
183
183
|
| `ud_batch_words` | Up to 100 word profiles in one call | Investor key |
|
|
184
184
|
| `ud_list_words` | Searches the catalog's words by text and facets | member key |
|
|
185
185
|
| `ud_get_word` | A word's profile | member key |
|
|
186
|
-
| `ud_get_word_endings` | A word's endings
|
|
186
|
+
| `ud_get_word_endings` | A word's endings | free |
|
|
187
187
|
| `ud_list_word_names` | A word's catalog names on the endings that sell, by name | member key |
|
|
188
188
|
| `ud_get_word_trademarks` | A word's trademark counts and its exact-match marks | Investor key |
|
|
189
|
-
| `ud_get_word_notability` | A word's Wikipedia and Wikidata
|
|
190
|
-
| `ud_get_word_market` | A word's
|
|
189
|
+
| `ud_get_word_notability` | A word's Wikipedia page and Wikidata entry | free |
|
|
190
|
+
| `ud_get_word_market` | A word's sales and auction aggregates | free, npm only |
|
|
191
191
|
| `ud_list_related_words` | A word's synonyms then related words | Investor key |
|
|
192
192
|
| `ud_list_word_fits` | How well the word fits each ending whose keywords list it | Investor key |
|
|
193
193
|
| `ud_request_word` | Brings a word into the catalog | Investor key |
|
|
@@ -198,20 +198,20 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
198
198
|
| `ud_get_domain_drops` | Names dropping on one day, counted by ending | free |
|
|
199
199
|
| `ud_list_domain_hacks` | Domain hacks | free |
|
|
200
200
|
| `ud_list_domain_changes` | Changes across the catalog's names, newest first | Investor key |
|
|
201
|
-
| `ud_get_catalog_stats` | Catalog headline totals
|
|
201
|
+
| `ud_get_catalog_stats` | Catalog headline totals | free |
|
|
202
202
|
| `ud_list_tlds` | Every root TLD with its registry facts and launch phases | free |
|
|
203
203
|
| `ud_get_tld` | One TLD in full | free |
|
|
204
|
-
| `ud_get_tld_stats` | Ending's
|
|
204
|
+
| `ud_get_tld_stats` | Ending's market figures, and with history its daily rows | free |
|
|
205
205
|
| `ud_list_tld_phases` | Every dated launch phase of the ending, chronological | free |
|
|
206
206
|
| `ud_list_tld_changes` | Ending's public registry changes, newest first | free |
|
|
207
207
|
| `ud_list_tld_keywords` | Keywords the catalog attaches to the ending, by type | free |
|
|
208
|
-
| `ud_list_tld_applications` | 2026 new gTLD round
|
|
209
|
-
| `ud_list_tld_application_changes` | Every
|
|
208
|
+
| `ud_list_tld_applications` | ICANN's 2026 new gTLD round, A to Z, with two simple bands | free |
|
|
209
|
+
| `ud_list_tld_application_changes` | Every status or contention change of the round, newest first | free |
|
|
210
210
|
| `ud_get_tld_application_string` | One applied-for string | free |
|
|
211
211
|
| `ud_list_registrars` | Nine registrars whose daily price lists are compared | free |
|
|
212
212
|
| `ud_list_registrar_prices` | A registrar's list prices, alphabetical by ending | free |
|
|
213
213
|
| `ud_list_registrar_changes` | A registrar's confirmed list-price changes, newest first | free |
|
|
214
|
-
| `ud_get_registrar_footprint` | Names tracked under the registrar
|
|
214
|
+
| `ud_get_registrar_footprint` | Names tracked under the registrar | member key |
|
|
215
215
|
| `ud_list_tld_prices` | Every registrar's list price for one ending | free, npm only |
|
|
216
216
|
| `ud_list_tld_price_history` | Change-only price rows of one ending, newest first | Investor key |
|
|
217
217
|
| `ud_list_price_changes` | Confirmed registrar price changes across the nine | free |
|
|
@@ -219,7 +219,7 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
219
219
|
| `ud_list_cheapest_prices` | Cheapest registrar per ending for up to 100 endings | member key |
|
|
220
220
|
| `ud_list_venues` | Parking and marketplace venues with a profile and their rounded footprint | free |
|
|
221
221
|
| `ud_get_venue` | One venue's profile with its verified listing terms | free |
|
|
222
|
-
| `ud_list_iana_registrars` | IANA registrar list
|
|
222
|
+
| `ud_list_iana_registrars` | IANA registrar list, by IANA id | free |
|
|
223
223
|
| `ud_get_iana_registrar` | One IANA registrar by id | free |
|
|
224
224
|
| `ud_get_market_sales` | Domain sales pulse as headline aggregates | free |
|
|
225
225
|
| `ud_list_market_sales_series` | One sales series by day, week or month, oldest first | free |
|
|
@@ -241,7 +241,6 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
241
241
|
| `ud_get_latest_edition` | Latest daily edition of Business Ideas or Trending Domains | free |
|
|
242
242
|
| `ud_get_edition` | One dated daily edition of Business Ideas or Trending Domains | free |
|
|
243
243
|
| `ud_get_meta_enums` | Every list of values the answers use | free |
|
|
244
|
-
| `ud_get_meta_freshness` | How current each part of the stored data is | free, npm only |
|
|
245
244
|
| `ud_list_meta_datasets` | Free GitHub datasets that hold the same rows as these answers | free |
|
|
246
245
|
| `ud_list_meta_trademark_classes` | 45 Nice classes a trademark is filed under | free |
|
|
247
246
|
| `ud_get_meta_providers` | Registrar identities and the auction venue and parking service catalogs | free |
|
|
@@ -300,7 +299,7 @@ npm run smoke
|
|
|
300
299
|
- `npm run smoke` runs the MCP Inspector against both transports and a fixture API; `-- --live` uses the live API.
|
|
301
300
|
- `npm run plugin` builds `dist/chatgpt-plugin.zip` from `directories/openai/review.json` (the review texts, the test cases, the release notes) and checks it against OpenAI's limits and categories; `npm run plugin:test` also builds a sheet marked as a placeholder.
|
|
302
301
|
- `npm run plugin:devin` builds `dist/devin/plugins/unique-domains/` (the manifest Devin's validator accepts, a 256 px logo and a copy of the skill) for a pull request to Devin's marketplace.
|
|
303
|
-
- The
|
|
302
|
+
- The daily contract workflow opens its pull request with the workflow token, which needs the repository setting "Allow GitHub Actions to create and approve pull requests" (Settings, Actions, General).
|
|
304
303
|
|
|
305
304
|
## License
|
|
306
305
|
|