@uniquedomains/mcp-server 0.1.4 → 0.1.6
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 +64 -35
- package/dist/{chunk-KESCAQGG.js → chunk-4I4SFV22.js} +537 -669
- package/dist/{chunk-VLEYYUNT.js → chunk-QKLW5I3T.js} +2 -2
- package/dist/http.js +2 -2
- package/dist/index.js +2 -2
- package/dist/stdio.js +1 -1
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -1,17 +1,47 @@
|
|
|
1
|
-
# Unique
|
|
1
|
+
# Unique.domains MCP server
|
|
2
2
|
|
|
3
|
-
|
|
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` (55 tools without a key)
|
|
6
7
|
|
|
7
|
-
|
|
8
|
-
|
|
8
|
+
One question, one tool call. "Is get.plumbing taken?" gets this answer:
|
|
9
|
+
|
|
10
|
+
```json
|
|
11
|
+
{
|
|
12
|
+
"name": "get.plumbing",
|
|
13
|
+
"status": "for_sale",
|
|
14
|
+
"registry": {
|
|
15
|
+
"createdAt": "2020-06-03",
|
|
16
|
+
"expiresAt": "2027-06-03",
|
|
17
|
+
"registrar": { "name": "GoDaddy.com, LLC", "ianaId": 146 }
|
|
18
|
+
},
|
|
19
|
+
"comps": { "count": 10, "medianUsd": 2677 }
|
|
20
|
+
}
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
What the tools read:
|
|
24
|
+
|
|
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
|
+
- **A word:** the endings it is still open on. Each word exists once on each ending.
|
|
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).
|
|
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
|
+
- **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
|
+
|
|
32
|
+
No tool here registers, buys or changes a name.
|
|
33
|
+
|
|
34
|
+
Three questions to try:
|
|
35
|
+
|
|
36
|
+
- What is the registry record of get.plumbing?
|
|
37
|
+
- What are the newest registrar price changes?
|
|
38
|
+
- What is on the domain industry agenda this month?
|
|
9
39
|
|
|
10
40
|
## Connect your assistant
|
|
11
41
|
|
|
12
42
|
### Claude
|
|
13
43
|
|
|
14
|
-
In Claude (web or Desktop), open Customize, then Connectors, click "+ Add", then "Add custom connector", name it Unique
|
|
44
|
+
In Claude (web or Desktop), open Customize, then Connectors, click "+ Add", then "Add custom connector", name it Unique.domains and paste `https://mcp.unique.domains/mcp`. No sign-in is needed. On a Team or Enterprise plan, an Owner adds it in Organization settings, then Connectors, and members connect it from Customize, then Connectors.
|
|
15
45
|
|
|
16
46
|
To run it on your machine instead, add this to Claude Desktop's `claude_desktop_config.json`:
|
|
17
47
|
|
|
@@ -65,7 +95,7 @@ Or in `.vscode/mcp.json`:
|
|
|
65
95
|
|
|
66
96
|
### ChatGPT
|
|
67
97
|
|
|
68
|
-
Go to [chatgpt.com/plugins](https://chatgpt.com/plugins), select the plus button, then "Add custom MCP server". Name it Unique
|
|
98
|
+
Go to [chatgpt.com/plugins](https://chatgpt.com/plugins), select the plus button, then "Add custom MCP server". Name it Unique.domains, enter `https://mcp.unique.domains/mcp` as the server URL with no authentication, then "Create as a plugin". Install the plugin, then in a new conversation type `@` and pick it. Your account's or workspace's policies decide whether custom servers can be added.
|
|
69
99
|
|
|
70
100
|
### Any other client
|
|
71
101
|
|
|
@@ -88,13 +118,13 @@ Claude Code asks you to confirm this repository as a marketplace, then opens the
|
|
|
88
118
|
/plugin install unique-domains@uniquedomains
|
|
89
119
|
```
|
|
90
120
|
|
|
91
|
-
Three other tools read files of this repository. Grok Build reads `plugin/.grok-plugin/plugin.json`, in the same folder. Gemini CLI reads `gemini-extension.json` at the root, which adds the hosted connector
|
|
121
|
+
Three other tools read files of this repository. Grok Build reads `plugin/.grok-plugin/plugin.json`, in the same folder. Gemini CLI reads `gemini-extension.json` at the root, which adds the hosted connector and loads `GEMINI.md`, the skill's guidance, as its context file. For Devin, `npm run plugin:devin` builds the folder its marketplace takes.
|
|
92
122
|
|
|
93
123
|
## Free tools and a member key
|
|
94
124
|
|
|
95
|
-
Without a key, the server answers what the Unique
|
|
125
|
+
Without a key, the server answers what the Unique.domains website shows anyone: a name's status and registry record, an ending's facts, registrar prices, market aggregates, trends and the agenda.
|
|
96
126
|
|
|
97
|
-
A member key adds the keyed tools of its plan, the Founder or the Investor plan. Create the key in Unique
|
|
127
|
+
A member key adds the keyed tools of its plan, the Founder or the Investor plan. Create the key in Unique.domains under Settings, Account, API, then pass it to the server on your machine:
|
|
98
128
|
|
|
99
129
|
```bash
|
|
100
130
|
UD_API_KEY=ud_live_your_key npx -y @uniquedomains/mcp-server
|
|
@@ -102,20 +132,20 @@ UD_API_KEY=ud_live_your_key npx -y @uniquedomains/mcp-server
|
|
|
102
132
|
|
|
103
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).
|
|
104
134
|
|
|
105
|
-
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.
|
|
106
136
|
|
|
107
137
|
## What an answer holds
|
|
108
138
|
|
|
109
139
|
- `structuredContent`: the API's `data`, `meta` and `links`, as the tool's output schema describes them.
|
|
110
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.
|
|
111
|
-
- `links.details`: the public Unique
|
|
112
|
-
- 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),
|
|
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), 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.
|
|
113
143
|
- A list answers 20 rows by default. When `meta.cursor` is set, pass it as `cursor` to read the next page.
|
|
114
144
|
- A refusal is a sentence the assistant can act on: what was wrong, what is accepted, or when a limit resets.
|
|
115
145
|
|
|
116
146
|
## Privacy and security
|
|
117
147
|
|
|
118
|
-
- **What the connector logs.**
|
|
148
|
+
- **What the connector logs.** It passes each tool's input to the Unique.domains API, and the API's request log keeps one line per call for 12 months: the path, which holds the name or word asked about, with its time, its status and how long it took. A monthly job deletes older lines. The connector calls the API under its own name, so the API never sees your address or an account of yours. When your assistant runs on your own machine, it connects to the connector from your IP address. The connector's hosting providers see it, as they see the address behind any web request, and the connector does not store it. Section 8 of the [privacy policy](https://unique.domains/privacy#api-and-connector) says what the API keeps and why.
|
|
119
149
|
- **Registry records.** A name's registry answer repeats the registry's public record, which can include the holder's name or organization when the registry publishes it.
|
|
120
150
|
- **Every origin is accepted.** `/mcp` answers any `Origin` with `Access-Control-Allow-Origin: *`. The server is public, needs no sign-in, holds no session and never serves a member key over HTTP, so checking the origin would protect nothing, and strict origin checks break some assistants' own clients.
|
|
121
151
|
- **HTTPS only.** The hosted connector answers over HTTPS and sends `Strict-Transport-Security: max-age=31536000`.
|
|
@@ -131,21 +161,21 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
131
161
|
|
|
132
162
|
<!-- tools:start (generated by scripts/generate.mjs) -->
|
|
133
163
|
|
|
134
|
-
|
|
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.
|
|
135
165
|
|
|
136
166
|
| Tool | What it reads | Needs |
|
|
137
167
|
|---|---|---|
|
|
138
|
-
| `ud_get_name` |
|
|
139
|
-
| `ud_batch_names` |
|
|
140
|
-
| `ud_check_name` |
|
|
141
|
-
| `ud_get_name_prices` | Every
|
|
142
|
-
| `ud_get_name_registry` |
|
|
143
|
-
| `ud_get_name_registry_history` |
|
|
144
|
-
| `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 |
|
|
145
175
|
| `ud_list_name_changes` | Change events of one name, newest first | Investor key |
|
|
146
176
|
| `ud_get_name_history` | Web history of one name in bands | Investor key |
|
|
147
|
-
| `ud_get_name_value` |
|
|
148
|
-
| `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 |
|
|
149
179
|
| `ud_get_name_comps` | Similar-sales aggregate of one name and how many endings its word sold on | free |
|
|
150
180
|
| `ud_get_name_auction` | Open auction of one name, if any | free |
|
|
151
181
|
| `ud_resolve_word` | Turns what a caller typed into the catalog word it names | free |
|
|
@@ -153,11 +183,11 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
153
183
|
| `ud_batch_words` | Up to 100 word profiles in one call | Investor key |
|
|
154
184
|
| `ud_list_words` | Searches the catalog's words by text and facets | member key |
|
|
155
185
|
| `ud_get_word` | A word's profile | member key |
|
|
156
|
-
| `ud_get_word_endings` | A word's endings
|
|
186
|
+
| `ud_get_word_endings` | A word's endings | free |
|
|
157
187
|
| `ud_list_word_names` | A word's catalog names on the endings that sell, by name | member key |
|
|
158
188
|
| `ud_get_word_trademarks` | A word's trademark counts and its exact-match marks | Investor key |
|
|
159
|
-
| `ud_get_word_notability` | A word's Wikipedia and Wikidata
|
|
160
|
-
| `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 |
|
|
161
191
|
| `ud_list_related_words` | A word's synonyms then related words | Investor key |
|
|
162
192
|
| `ud_list_word_fits` | How well the word fits each ending whose keywords list it | Investor key |
|
|
163
193
|
| `ud_request_word` | Brings a word into the catalog | Investor key |
|
|
@@ -168,20 +198,20 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
168
198
|
| `ud_get_domain_drops` | Names dropping on one day, counted by ending | free |
|
|
169
199
|
| `ud_list_domain_hacks` | Domain hacks | free |
|
|
170
200
|
| `ud_list_domain_changes` | Changes across the catalog's names, newest first | Investor key |
|
|
171
|
-
| `ud_get_catalog_stats` | Catalog headline totals
|
|
201
|
+
| `ud_get_catalog_stats` | Catalog headline totals | free |
|
|
172
202
|
| `ud_list_tlds` | Every root TLD with its registry facts and launch phases | free |
|
|
173
203
|
| `ud_get_tld` | One TLD in full | free |
|
|
174
|
-
| `ud_get_tld_stats` | Ending's
|
|
204
|
+
| `ud_get_tld_stats` | Ending's market figures, and with history its daily rows | free |
|
|
175
205
|
| `ud_list_tld_phases` | Every dated launch phase of the ending, chronological | free |
|
|
176
206
|
| `ud_list_tld_changes` | Ending's public registry changes, newest first | free |
|
|
177
207
|
| `ud_list_tld_keywords` | Keywords the catalog attaches to the ending, by type | free |
|
|
178
|
-
| `ud_list_tld_applications` | 2026 new gTLD round
|
|
179
|
-
| `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 |
|
|
180
210
|
| `ud_get_tld_application_string` | One applied-for string | free |
|
|
181
211
|
| `ud_list_registrars` | Nine registrars whose daily price lists are compared | free |
|
|
182
212
|
| `ud_list_registrar_prices` | A registrar's list prices, alphabetical by ending | free |
|
|
183
213
|
| `ud_list_registrar_changes` | A registrar's confirmed list-price changes, newest first | free |
|
|
184
|
-
| `ud_get_registrar_footprint` | Names tracked under the registrar
|
|
214
|
+
| `ud_get_registrar_footprint` | Names tracked under the registrar | member key |
|
|
185
215
|
| `ud_list_tld_prices` | Every registrar's list price for one ending | free, npm only |
|
|
186
216
|
| `ud_list_tld_price_history` | Change-only price rows of one ending, newest first | Investor key |
|
|
187
217
|
| `ud_list_price_changes` | Confirmed registrar price changes across the nine | free |
|
|
@@ -189,7 +219,7 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
189
219
|
| `ud_list_cheapest_prices` | Cheapest registrar per ending for up to 100 endings | member key |
|
|
190
220
|
| `ud_list_venues` | Parking and marketplace venues with a profile and their rounded footprint | free |
|
|
191
221
|
| `ud_get_venue` | One venue's profile with its verified listing terms | free |
|
|
192
|
-
| `ud_list_iana_registrars` | IANA registrar list
|
|
222
|
+
| `ud_list_iana_registrars` | IANA registrar list, by IANA id | free |
|
|
193
223
|
| `ud_get_iana_registrar` | One IANA registrar by id | free |
|
|
194
224
|
| `ud_get_market_sales` | Domain sales pulse as headline aggregates | free |
|
|
195
225
|
| `ud_list_market_sales_series` | One sales series by day, week or month, oldest first | free |
|
|
@@ -211,7 +241,6 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
211
241
|
| `ud_get_latest_edition` | Latest daily edition of Business Ideas or Trending Domains | free |
|
|
212
242
|
| `ud_get_edition` | One dated daily edition of Business Ideas or Trending Domains | free |
|
|
213
243
|
| `ud_get_meta_enums` | Every list of values the answers use | free |
|
|
214
|
-
| `ud_get_meta_freshness` | How current each part of the stored data is | free, npm only |
|
|
215
244
|
| `ud_list_meta_datasets` | Free GitHub datasets that hold the same rows as these answers | free |
|
|
216
245
|
| `ud_list_meta_trademark_classes` | 45 Nice classes a trademark is filed under | free |
|
|
217
246
|
| `ud_get_meta_providers` | Registrar identities and the auction venue and parking service catalogs | free |
|
|
@@ -270,7 +299,7 @@ npm run smoke
|
|
|
270
299
|
- `npm run smoke` runs the MCP Inspector against both transports and a fixture API; `-- --live` uses the live API.
|
|
271
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.
|
|
272
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.
|
|
273
|
-
- 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).
|
|
274
303
|
|
|
275
304
|
## License
|
|
276
305
|
|