@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 CHANGED
@@ -1,17 +1,47 @@
1
- # Unique Domains MCP server
1
+ # Unique.domains MCP server
2
2
 
3
- An MCP server for the [Unique Domains API](https://unique.domains/api). It lets an AI assistant read domain names, words, TLDs, registrar prices, the domain market, trends and the industry agenda from the Unique Domains catalog.
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
- Every tool reads stored data as of its day. None registers, buys or changes a name.
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
- - Hosted, no install and no key: `https://mcp.unique.domains/mcp`
8
- - On your machine: `npx -y @uniquedomains/mcp-server`
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 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.
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 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.
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 without the skill. For Devin, `npm run plugin:devin` builds the folder its marketplace takes.
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 Domains website shows anyone: a name's status and registry record, an ending's facts, registrar prices, market aggregates, trends and the agenda.
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 Domains under Settings, Account, API, then pass it to the server on your machine:
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. Five 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, and `ud_get_meta_freshness` reports how current each part of the data is, which every answer's `meta` already dates.
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 Domains page about the subject, when there is one (hosted connector).
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), and the stamps of when a figure was computed are dropped. The npm server and the API keep them.
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.** Nothing of its own. It stores no question, no answer and no caller. 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.
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
- 56 tools answer without a key (51 on the hosted connector); a member key adds 25 more, the Investor ones for an Investor key only.
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` | Stored answer for one domain name | free |
139
- | `ud_batch_names` | Stored answers for up to 100 domain names in one call | Investor key |
140
- | `ud_check_name` | Reads one name live from its registry and a registrar | member key |
141
- | `ud_get_name_prices` | Every stored registrar quote for one name | member key |
142
- | `ud_get_name_registry` | Latest stored registry record of one name | free |
143
- | `ud_get_name_registry_history` | Stored registry record versions of one name and what moved between them | Investor key |
144
- | `ud_get_name_dns` | Latest stored DNS reading of one name | free |
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` | Stored value estimate of one name and its last 20 estimates | member key |
148
- | `ud_appraise_name` | Runs the appraisal of one stored name when its estimate is missing | Investor key |
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 as stored on the latest day | free |
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 facts | free |
160
- | `ud_get_word_market` | A word's stored sales and auction aggregates | free, npm only |
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 for the latest day | free |
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 latest market figures | free |
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 as ICANN publishes it | free |
179
- | `ud_list_tld_application_changes` | Every recorded status or contention change of the round | free |
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 on the latest footprint day | member key |
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 as stored, by IANA id | free |
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 nightly 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).
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