@uniquedomains/mcp-server 0.1.3 → 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 +62 -12
- package/dist/{chunk-KUJEFQYK.js → chunk-DKMT6N3J.js} +2 -2
- package/dist/{chunk-DKI5HXRQ.js → chunk-GYZHSVAG.js} +441 -400
- package/dist/http.js +2 -2
- package/dist/index.js +2 -2
- package/dist/stdio.js +1 -1
- package/package.json +5 -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,17 +95,36 @@ 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
|
|
|
72
102
|
Streamable HTTP at `https://mcp.unique.domains/mcp`, or stdio with `npx -y @uniquedomains/mcp-server`.
|
|
73
103
|
|
|
104
|
+
## Plugins
|
|
105
|
+
|
|
106
|
+
The [`plugin/`](plugin) folder is a plugin for the AI assistants that take one. It holds the hosted connector and one skill, which tells the assistant which tool answers which question. It runs nothing on your machine and uses no key.
|
|
107
|
+
|
|
108
|
+
In Claude Code, run this line:
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
/plugin install unique-domains --marketplace UniqueDomains/mcp-server
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Claude Code asks you to confirm this repository as a marketplace, then opens the plugin's page, where you install it. The line needs Claude Code 2.1.275 or later. On an earlier version, do the same in two steps:
|
|
115
|
+
|
|
116
|
+
```
|
|
117
|
+
/plugin marketplace add UniqueDomains/mcp-server
|
|
118
|
+
/plugin install unique-domains@uniquedomains
|
|
119
|
+
```
|
|
120
|
+
|
|
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.
|
|
122
|
+
|
|
74
123
|
## Free tools and a member key
|
|
75
124
|
|
|
76
|
-
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.
|
|
77
126
|
|
|
78
|
-
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:
|
|
79
128
|
|
|
80
129
|
```bash
|
|
81
130
|
UD_API_KEY=ud_live_your_key npx -y @uniquedomains/mcp-server
|
|
@@ -89,14 +138,14 @@ The hosted connector serves the free tools only and takes no key. Five free tool
|
|
|
89
138
|
|
|
90
139
|
- `structuredContent`: the API's `data`, `meta` and `links`, as the tool's output schema describes them.
|
|
91
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.
|
|
92
|
-
- `links.details`: the public Unique
|
|
141
|
+
- `links.details`: the public Unique.domains page about the subject, when there is one (hosted connector).
|
|
93
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.
|
|
94
143
|
- A list answers 20 rows by default. When `meta.cursor` is set, pass it as `cursor` to read the next page.
|
|
95
144
|
- A refusal is a sentence the assistant can act on: what was wrong, what is accepted, or when a limit resets.
|
|
96
145
|
|
|
97
146
|
## Privacy and security
|
|
98
147
|
|
|
99
|
-
- **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.
|
|
100
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.
|
|
101
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.
|
|
102
151
|
- **HTTPS only.** The hosted connector answers over HTTPS and sends `Strict-Transport-Security: max-age=31536000`.
|
|
@@ -249,7 +298,8 @@ npm run smoke
|
|
|
249
298
|
|
|
250
299
|
- `npm run generate` rebuilds `src/generated/tools.ts`, `openapi/v1.json` and the tool list above from the API document that `@uniquedomains/sdk` ships; `-- --check` fails when they are out of date, `-- --live` compares the live document.
|
|
251
300
|
- `npm run smoke` runs the MCP Inspector against both transports and a fixture API; `-- --live` uses the live API.
|
|
252
|
-
- `npm run plugin` builds `dist/chatgpt-plugin.zip` from `
|
|
301
|
+
- `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
|
+
- `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.
|
|
253
303
|
- 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).
|
|
254
304
|
|
|
255
305
|
## License
|
|
@@ -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) {
|