@uniquedomains/mcp-server 0.1.4 → 0.1.5
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 +42 -12
- package/dist/{chunk-VLEYYUNT.js → chunk-DKMT6N3J.js} +2 -2
- package/dist/{chunk-KESCAQGG.js → chunk-GYZHSVAG.js} +440 -400
- 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, each with its dates.
|
|
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` (56 tools without a key)
|
|
6
7
|
|
|
7
|
-
|
|
8
|
-
|
|
8
|
+
One question, one tool call. "Is get.plumbing taken?" on 2026-11-11:
|
|
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, on 2026-11-11).
|
|
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. An answer carries its day where the record has one, so your assistant can say how fresh it is.
|
|
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
|
|
@@ -108,14 +138,14 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
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
|
|
141
|
+
- `links.details`: the public Unique.domains page about the subject, when there is one (hosted connector).
|
|
112
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), and the stamps of when a figure was computed are dropped. 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`.
|
|
@@ -6,7 +6,7 @@ import {
|
|
|
6
6
|
createMcpServer,
|
|
7
7
|
prepareServer,
|
|
8
8
|
readConfig
|
|
9
|
-
} from "./chunk-
|
|
9
|
+
} from "./chunk-GYZHSVAG.js";
|
|
10
10
|
|
|
11
11
|
// src/httpApp.ts
|
|
12
12
|
import { createServer as createHttpServer } from "http";
|
|
@@ -117,7 +117,7 @@ var createRequestHandler = (prepared, options) => async (req, res) => {
|
|
|
117
117
|
return send(res, 404, "Not found.\n", "text/plain; charset=utf-8");
|
|
118
118
|
}
|
|
119
119
|
if (path === "/") {
|
|
120
|
-
return send(res, 200, "Unique
|
|
120
|
+
return send(res, 200, "Unique.domains MCP server. Connect an MCP client to /mcp. Documentation: https://github.com/UniqueDomains/mcp-server\n", "text/plain; charset=utf-8");
|
|
121
121
|
}
|
|
122
122
|
return send(res, 404, "Not found.\n", "text/plain; charset=utf-8");
|
|
123
123
|
} catch (error) {
|