@uniquedomains/mcp-server 0.1.2 → 0.1.4
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 +52 -23
- package/dist/{chunk-V2BPY65Q.js → chunk-KESCAQGG.js} +236 -129
- package/dist/{chunk-2UU2IMAD.js → chunk-VLEYYUNT.js} +9 -4
- package/dist/http.js +2 -2
- package/dist/index.js +24 -4
- package/dist/stdio.js +1 -1
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@ Every tool reads stored data as of its day. None registers, buys or changes a na
|
|
|
11
11
|
|
|
12
12
|
### Claude
|
|
13
13
|
|
|
14
|
-
In Claude (web or Desktop), open
|
|
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.
|
|
15
15
|
|
|
16
16
|
To run it on your machine instead, add this to Claude Desktop's `claude_desktop_config.json`:
|
|
17
17
|
|
|
@@ -65,12 +65,31 @@ Or in `.vscode/mcp.json`:
|
|
|
65
65
|
|
|
66
66
|
### ChatGPT
|
|
67
67
|
|
|
68
|
-
|
|
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.
|
|
69
69
|
|
|
70
70
|
### Any other client
|
|
71
71
|
|
|
72
72
|
Streamable HTTP at `https://mcp.unique.domains/mcp`, or stdio with `npx -y @uniquedomains/mcp-server`.
|
|
73
73
|
|
|
74
|
+
## Plugins
|
|
75
|
+
|
|
76
|
+
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.
|
|
77
|
+
|
|
78
|
+
In Claude Code, run this line:
|
|
79
|
+
|
|
80
|
+
```
|
|
81
|
+
/plugin install unique-domains --marketplace UniqueDomains/mcp-server
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
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:
|
|
85
|
+
|
|
86
|
+
```
|
|
87
|
+
/plugin marketplace add UniqueDomains/mcp-server
|
|
88
|
+
/plugin install unique-domains@uniquedomains
|
|
89
|
+
```
|
|
90
|
+
|
|
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.
|
|
92
|
+
|
|
74
93
|
## Free tools and a member key
|
|
75
94
|
|
|
76
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.
|
|
@@ -83,16 +102,25 @@ UD_API_KEY=ud_live_your_key npx -y @uniquedomains/mcp-server
|
|
|
83
102
|
|
|
84
103
|
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).
|
|
85
104
|
|
|
86
|
-
The hosted connector serves the free tools only and takes no key.
|
|
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.
|
|
87
106
|
|
|
88
107
|
## What an answer holds
|
|
89
108
|
|
|
90
109
|
- `structuredContent`: the API's `data`, `meta` and `links`, as the tool's output schema describes them.
|
|
91
110
|
- `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
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.
|
|
93
113
|
- A list answers 20 rows by default. When `meta.cursor` is set, pass it as `cursor` to read the next page.
|
|
94
114
|
- A refusal is a sentence the assistant can act on: what was wrong, what is accepted, or when a limit resets.
|
|
95
115
|
|
|
116
|
+
## Privacy and security
|
|
117
|
+
|
|
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.
|
|
119
|
+
- **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
|
+
- **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
|
+
- **HTTPS only.** The hosted connector answers over HTTPS and sends `Strict-Transport-Security: max-age=31536000`.
|
|
122
|
+
- **Reporting a vulnerability.** Write to [contact@unique.domains](mailto:contact@unique.domains); please do not open a public issue for it.
|
|
123
|
+
|
|
96
124
|
## The same data elsewhere
|
|
97
125
|
|
|
98
126
|
- The API reference: [unique.domains/api](https://unique.domains/api)
|
|
@@ -103,43 +131,43 @@ The hosted connector serves the free tools only and takes no key. Three free too
|
|
|
103
131
|
|
|
104
132
|
<!-- tools:start (generated by scripts/generate.mjs) -->
|
|
105
133
|
|
|
106
|
-
56 tools answer without a key (
|
|
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.
|
|
107
135
|
|
|
108
136
|
| Tool | What it reads | Needs |
|
|
109
137
|
|---|---|---|
|
|
110
138
|
| `ud_get_name` | Stored answer for one domain name | free |
|
|
111
|
-
| `ud_batch_names` |
|
|
139
|
+
| `ud_batch_names` | Stored answers for up to 100 domain names in one call | Investor key |
|
|
112
140
|
| `ud_check_name` | Reads one name live from its registry and a registrar | member key |
|
|
113
141
|
| `ud_get_name_prices` | Every stored registrar quote for one name | member key |
|
|
114
142
|
| `ud_get_name_registry` | Latest stored registry record of one name | free |
|
|
115
143
|
| `ud_get_name_registry_history` | Stored registry record versions of one name and what moved between them | Investor key |
|
|
116
144
|
| `ud_get_name_dns` | Latest stored DNS reading of one name | free |
|
|
117
145
|
| `ud_list_name_changes` | Change events of one name, newest first | Investor key |
|
|
118
|
-
| `ud_get_name_history` | Web history of one name
|
|
146
|
+
| `ud_get_name_history` | Web history of one name in bands | Investor key |
|
|
119
147
|
| `ud_get_name_value` | Stored value estimate of one name and its last 20 estimates | member key |
|
|
120
148
|
| `ud_appraise_name` | Runs the appraisal of one stored name when its estimate is missing | Investor key |
|
|
121
|
-
| `ud_get_name_comps` | Similar-sales aggregate of one name and
|
|
149
|
+
| `ud_get_name_comps` | Similar-sales aggregate of one name and how many endings its word sold on | free |
|
|
122
150
|
| `ud_get_name_auction` | Open auction of one name, if any | free |
|
|
123
151
|
| `ud_resolve_word` | Turns what a caller typed into the catalog word it names | free |
|
|
124
152
|
| `ud_list_word_categories` | Catalog's word categories, by name | free |
|
|
125
153
|
| `ud_batch_words` | Up to 100 word profiles in one call | Investor key |
|
|
126
154
|
| `ud_list_words` | Searches the catalog's words by text and facets | member key |
|
|
127
155
|
| `ud_get_word` | A word's profile | member key |
|
|
128
|
-
| `ud_get_word_endings` | A word's endings as
|
|
156
|
+
| `ud_get_word_endings` | A word's endings as stored on the latest day | free |
|
|
129
157
|
| `ud_list_word_names` | A word's catalog names on the endings that sell, by name | member key |
|
|
130
158
|
| `ud_get_word_trademarks` | A word's trademark counts and its exact-match marks | Investor key |
|
|
131
159
|
| `ud_get_word_notability` | A word's Wikipedia and Wikidata facts | free |
|
|
132
|
-
| `ud_get_word_market` | A word's sales and auction aggregates
|
|
160
|
+
| `ud_get_word_market` | A word's stored sales and auction aggregates | free, npm only |
|
|
133
161
|
| `ud_list_related_words` | A word's synonyms then related words | Investor key |
|
|
134
162
|
| `ud_list_word_fits` | How well the word fits each ending whose keywords list it | Investor key |
|
|
135
163
|
| `ud_request_word` | Brings a word into the catalog | Investor key |
|
|
136
164
|
| `ud_get_word_request` | State of a word request | Investor key |
|
|
137
165
|
| `ud_list_domains` | One-word catalog names under filters | free |
|
|
138
|
-
| `ud_get_domain` | One catalog name, by name or id | free |
|
|
166
|
+
| `ud_get_domain` | One catalog name, by name or catalog id | free, npm only |
|
|
139
167
|
| `ud_list_expiring_domains` | Catalog names expiring or expired, by expiry day | Investor key |
|
|
140
|
-
| `ud_get_domain_drops` | Names dropping on one day | free |
|
|
168
|
+
| `ud_get_domain_drops` | Names dropping on one day, counted by ending | free |
|
|
141
169
|
| `ud_list_domain_hacks` | Domain hacks | free |
|
|
142
|
-
| `ud_list_domain_changes` |
|
|
170
|
+
| `ud_list_domain_changes` | Changes across the catalog's names, newest first | Investor key |
|
|
143
171
|
| `ud_get_catalog_stats` | Catalog headline totals for the latest day | free |
|
|
144
172
|
| `ud_list_tlds` | Every root TLD with its registry facts and launch phases | free |
|
|
145
173
|
| `ud_get_tld` | One TLD in full | free |
|
|
@@ -161,7 +189,7 @@ The hosted connector serves the free tools only and takes no key. Three free too
|
|
|
161
189
|
| `ud_list_cheapest_prices` | Cheapest registrar per ending for up to 100 endings | member key |
|
|
162
190
|
| `ud_list_venues` | Parking and marketplace venues with a profile and their rounded footprint | free |
|
|
163
191
|
| `ud_get_venue` | One venue's profile with its verified listing terms | free |
|
|
164
|
-
| `ud_list_iana_registrars` | IANA registrar list as
|
|
192
|
+
| `ud_list_iana_registrars` | IANA registrar list as stored, by IANA id | free |
|
|
165
193
|
| `ud_get_iana_registrar` | One IANA registrar by id | free |
|
|
166
194
|
| `ud_get_market_sales` | Domain sales pulse as headline aggregates | free |
|
|
167
195
|
| `ud_list_market_sales_series` | One sales series by day, week or month, oldest first | free |
|
|
@@ -175,19 +203,19 @@ The hosted connector serves the free tools only and takes no key. Three free too
|
|
|
175
203
|
| `ud_list_market_auction_outcomes` | Confirmed auction outcomes by venue | Investor key |
|
|
176
204
|
| `ud_list_trends` | Every published trend with its latest edition figures and its first and last edition day | free |
|
|
177
205
|
| `ud_get_trend` | One trend | free |
|
|
178
|
-
| `ud_list_trend_categories` | Trend categories,
|
|
179
|
-
| `ud_list_trend_pool` |
|
|
206
|
+
| `ud_list_trend_categories` | Trend categories, to narrow the trends by | free |
|
|
207
|
+
| `ud_list_trend_pool` | Trend candidates the daily editions draw from | member key |
|
|
180
208
|
| `ud_list_events` | Industry events of one month | free |
|
|
181
209
|
| `ud_get_event` | One industry event with its organizer | free |
|
|
182
210
|
| `ud_get_agenda` | Whole public agenda of one month | free |
|
|
183
|
-
| `ud_get_latest_edition` | Latest
|
|
184
|
-
| `ud_get_edition` | One dated
|
|
185
|
-
| `ud_get_meta_enums` | Every
|
|
186
|
-
| `ud_get_meta_freshness` | How current the
|
|
187
|
-
| `ud_list_meta_datasets` | GitHub datasets
|
|
211
|
+
| `ud_get_latest_edition` | Latest daily edition of Business Ideas or Trending Domains | free |
|
|
212
|
+
| `ud_get_edition` | One dated daily edition of Business Ideas or Trending Domains | free |
|
|
213
|
+
| `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
|
+
| `ud_list_meta_datasets` | Free GitHub datasets that hold the same rows as these answers | free |
|
|
188
216
|
| `ud_list_meta_trademark_classes` | 45 Nice classes a trademark is filed under | free |
|
|
189
217
|
| `ud_get_meta_providers` | Registrar identities and the auction venue and parking service catalogs | free |
|
|
190
|
-
| `ud_get_key` |
|
|
218
|
+
| `ud_get_key` | What the calling member key opens | member key |
|
|
191
219
|
|
|
192
220
|
<!-- tools:end -->
|
|
193
221
|
|
|
@@ -221,7 +249,7 @@ docker build -t uniquedomains-mcp-server .
|
|
|
221
249
|
docker run -p 8080:8080 uniquedomains-mcp-server
|
|
222
250
|
```
|
|
223
251
|
|
|
224
|
-
The image runs `node dist/http.js` with `UD_MCP_PROFILE=hosted`: `POST /mcp` (stateless Streamable HTTP, plain JSON answers), `GET /healthz`, and the well-known files. Every answer is `Cache-Control: no-store`, and `/mcp` allows any origin.
|
|
252
|
+
The image runs `node dist/http.js` with `UD_MCP_PROFILE=hosted`: `POST /mcp` (stateless Streamable HTTP, plain JSON answers), `GET /healthz`, and the well-known files. Every answer is `Cache-Control: no-store` with `Strict-Transport-Security: max-age=31536000`, and `/mcp` allows any origin (its preflight offers `POST` and `OPTIONS`).
|
|
225
253
|
|
|
226
254
|
The same image speaks stdio when given the stdio entry, for catalogs that inspect a server that way:
|
|
227
255
|
|
|
@@ -240,7 +268,8 @@ npm run smoke
|
|
|
240
268
|
|
|
241
269
|
- `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.
|
|
242
270
|
- `npm run smoke` runs the MCP Inspector against both transports and a fixture API; `-- --live` uses the live API.
|
|
243
|
-
- `npm run plugin` builds `dist/chatgpt-plugin.zip` and checks it against OpenAI's limits
|
|
271
|
+
- `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
|
+
- `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.
|
|
244
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).
|
|
245
274
|
|
|
246
275
|
## License
|