Checks name availability across package registries, app stores, agent directories, and domains to ensure project branding is free.
Also known as minanyang/nameable
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.3.0
- Last commit
- Nov 15, 2026
- License
- MIT
What is Nameable MCP?
Nameable checks name availability across package registries, app stores, agent directories, and domains to ensure project branding is free.
Summary generated from the project's README
About Nameable MCP server
Verifying that a project name is truly available across all necessary platforms is what Nameable does for developers and brand owners. Instead of simply checking if a name is currently unregistered, it applies specific registry rules to identify reserved keywords, similar names, aliases, and recently deleted entries that might still block registration. This prevents the common mistake of assuming a name is free just because a standard search returns no results.
Users can run this tool as a CLI, a Claude Code plugin, or an MCP server via stdio. When used as an MCP server, it provides a check_names tool that returns structured JSON data. The system automatically detects relevant channels by inspecting project files like package.json, pyproject.toml, or Cargo.toml. It covers a vast range of registries including npm, PyPI, crates.io, Homebrew, GitHub, App Store, Google Play, and various domain TLDs. For higher rate limits on GitHub checks, users can provide a GITHUB_TOKEN.
What you can do with it
- 1Verify multi-platform branding availabilityCheck if a potential project name is free across package registries, app stores, and domains simultaneously.
- 2Automate branding checks for AI agentsProvide an AI client with a tool to evaluate name candidates and recommend which ones to keep based on prior art.
- 3Compare multiple name candidatesGenerate a grid comparison to see how different name options perform across specific channels.
Written from the project's README. Every use case is checked against a quote from it.
How to install Nameable MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Nameable MCP in Claude Code
$ claude mcp add nameable -- npx -y nameableInstall Nameable MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"nameable": {
"command": "npx",
"args": [
"-y",
"nameable"
]
}
}
}Install Nameable MCP in VS Code
.vscode/mcp.json
{
"servers": {
"nameable": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"nameable"
]
}
}
}Install Nameable MCP in VS Code CLI
$ code --add-mcp '{"name":"nameable","type":"stdio","command":"npx","args":["-y","nameable"]}'Install Nameable MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"nameable": {
"command": "npx",
"args": [
"-y",
"nameable"
]
}
}
}Install Nameable MCP in Codex
$ codex mcp add nameable -- npx -y nameableInstall Nameable MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.nameable] command = "npx" args = ["-y", "nameable"]
Install Nameable MCP in Gemini CLI
$ gemini mcp add -s user nameable npx -- -y nameableInstall Nameable MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"nameable": {
"command": "npx",
"args": [
"-y",
"nameable"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableminanyang/nameable is public and reachablegithub.com/minanyang/nameable ↗Pass
- Package names this repository as its sourcenameable names minanyang/nameable as sourcenpmjs.com/package/nameable ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for nameablenpmjs.com/package/nameable/v/2.3.0#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-14github.com/minanyang/nameable ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from nameablePass
- No critical advisory in the package or its dependencies4 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubNameable
Is the name really free? Nameable checks every registry, store and domain your project needs.
English · 繁體中文
Nameable checks a name on package registries, GitHub, agent and editor directories, app stores and domains, shows the evidence behind every answer, and says how sure each answer is. It runs as a CLI, as an MCP server for AI agents, and as a Claude Code plugin that also looks for prior art and recommends which name to keep.
Why
Most availability checks ask each registry whether the name exists and read "not found" as free. Not found only means nobody holds that exact name. The registry may still refuse it:
| Name | Registry | Not found? | What the registry does |
|---|---|---|---|
f1ask |
PyPI | yes | Refuses it: too similar to flask |
first-one |
npm | yes | Refuses it: same as firstone without punctuation |
golang |
Homebrew | yes | Already taken: an alias of go |
rust |
crates.io | yes | Refuses it: reserved by crates.io |
gh |
crates.io | yes | Refuses it until 2027: the crate was deleted recently |
providers |
pub.dev | yes | Refuses it: the plural of provider |
rbconfig |
RubyGems | yes | Refuses it: reserved by RubyGems.org |
Coinbase.Core |
NuGet | yes | Refuses it: deleted by NuGet, the ID still held |
postgres |
Docker Hub | yes | Already taken: an official image |
xn--ls8h.dev |
domains | yes | Cannot be registered: it is an emoji in punycode |
Nameable applies each registry's own rules, taken from its source code, and checks the lists those rules need:
similar and reserved names, aliases and old names, recently deleted names, unpublished packages. When a rule cannot
be checked, the answer says "probably" and why, instead of "available". A failed request is unknown, never free.
Use it from the terminal
Requires Node.js 22 or later. Run it in your project (or any folder under it, up to the repository root) and it checks the channels the project ships on, picked from its files:
package.jsonfor npm (unless it has noname, is private, or is a server or site: it starts, serves or deploys itself and declares nothing to publish), Homebrew when it has abin; withengines.vscode, VS Code Marketplace and Open VSX instead of npmpyproject.toml,setup.pyorsetup.cfgthat describe a package for PyPI, Homebrew when they declare scriptsCargo.tomlfor crates.io (unlesspublish = false), Homebrew when it builds a binary- a
.gemspecfor RubyGems,composer.jsonfor Packagist (unless it is a project),pubspec.yamlfor pub.dev (unlesspublish_to: none), a .NET project or solution for NuGet (unless it builds a web app, a function, an executable or tests, or is not packable), aDockerfilefor Docker Hub, aPackage.swiftwith an executable for Homebrew .claude-plugin/,.cursor-plugin/andgemini-extension.jsonfor those directories, aplugin.xmlor the IntelliJ Gradle plugin for JetBrains Marketplace, an MCP SDK dependency for the MCP Registry and Smithery- an Xcode project for the App Store, an Android app for Google Play, and an Expo or Flutter app for both
- at an npm, pnpm, Yarn, Lerna or Cargo workspace root, the channels of each member, read the same way
GitHub accounts and repositories and domains are always checked; a project that ships on none of these, such as a Rails app or a Go library, gets only those (and Homebrew for a Go command). Outside a project it checks a general set: npm, PyPI, crates.io, Homebrew, GitHub and domains.
npx nameable nameable --all --tlds com,dev,sh
Checking "nameable" on 25 channels
✗ npm taken Find out if a name is free everywhere it matters for …
✓ PyPI available
✓ crates.io available
✓ Homebrew available no homebrew-core formula or cask
✗ RubyGems taken A library that provides parsing and output of person …
✓ Packagist probably available no packages under this vendor; packages frozen for sp…
✓ pub.dev probably available no package with this name; moderated packages and res…
✓ NuGet probably available no package with this ID; reserved prefixes and the ty…
✓ Docker Hub probably available no user or organization; deactivated or reserved Dock…
✓ GitHub user/org probably available suspended, deleted or reserved accounts also look fre…
✗ GitHub repository taken clash, not a block: dwightwatson/nameable (★30, pushe…
✓ MCP Registry probably available no server uses this name in the registry as of 2026-10…
✓ Smithery probably available no public servers; a namespace with none, or with onl…
✓ Claude plugins available not in the official marketplace
✓ Cursor plugins probably available not among Cursor's listed plugins; plugins in review …
✓ Gemini extensions probably available not in the Gemini CLI gallery; it lists only tagged G…
✓ VS Code Marketplace probably available no extension or publisher; removed extensions keep th…
✓ Open VSX probably available no namespace or similar one; namespaces without publi…
✓ JetBrains Marketplace probably available no plugin with this name or ID; unapproved and hidden…
✓ App Store probably available no app with this name in the US store; unreleased app…
✓ Google Play probably available no app with this title in search results of the US st…
✓ Trademarks (TW) probably available no Taiwan trademark uses exactly this name as of 2026…
✗ .com taken registered 1999-02-13, expires 2027-02-13
✓ .dev probably available not registered; a registry can still refuse premium o…
✓ .sh probably available not registered (whois); a registry can still refuse p…
npm https://www.npmjs.com/package/nameable
RubyGems https://rubygems.org/gems/nameable
GitHub repository https://github.com/dwightwatson/nameable
.com https://lookup.icann.org/en/lookup?name=nameable.com
21 available (17 probably) · 4 taken
Several names show a grid to compare them:
npx nameable twinsy dupefind fclones --only crates,homebrew,github,domain --tlds com,dev,sh
twinsy dupefind fclones
crates.io ✓ ✓ ✗
Homebrew ✓ ✓ ✗
GitHub user/org ✗ ✓* ✓*
.com ✗ ✗ ✓*
.dev ✓* ✓* ✓*
.sh ✓* ✓* ✓*
free 4/6 5/6 4/6
✓ available ↺ reclaimable ✗ taken ⊘ unavailable ? unknown * probably available
Check one name at a time for the details behind each mark.
| Option | |
|---|---|
--all |
Check every channel |
--only <ids> |
Channels to check: npm, pypi, crates, homebrew, rubygems, packagist, pub, nuget, docker, github, github-repo, mcp-registry, smithery, claude-plugins, cursor, gemini, vscode, open-vsx, jetbrains, app-store, google-play, trademark-tw, domain (every TLD in --tlds) or domain:<tld> |
--tlds <list> |
Domains to check, any TLD, at most 20 (default com,dev). TLDs without RDAP, such as .io, .sh and .de, go through whois. With --only, include domain |
--json |
Print JSON; also the default when the output is not a terminal |
--refresh |
Download the registry name lists again |
--clear-cache |
Delete the cached name lists |
GitHub checks use GITHUB_TOKEN, GH_TOKEN or gh auth token when one is available, for a higher rate limit.
Use it with AI agents
Claude Code plugin
/plugin marketplace add minanyang/claude-plugins
/plugin install nameable@minanyang
Then ask for a name, or run /nameable:check <names>. The skill picks the channels that matter for your project,
checks them, looks for projects that already do the same thing, and gives a verdict for each candidate: use it, use it
with changes (a scope, another TLD, another GitHub owner), or drop it.
The plugin carries its own copy of the CLI and runs it with Node.js 22 or later. When it installs, Claude Code adds
the CLI's two dependencies, zod and @modelcontextprotocol/server, from the npm lockfile in the plugin.
MCP server
npx -y nameable mcp runs the same checks as an MCP server over stdio. It has one read-only tool, check_names
(names, and optionally channels, tlds and refresh), which returns the JSON below as structured content.
It is listed on the official MCP Registry as
io.github.minanyang/nameable.
| Client | Add it with |
|---|---|
| Claude Code | claude mcp add nameable -- npx -y nameable mcp |
| Codex | codex mcp add nameable -- npx -y nameable mcp |
| Gemini CLI | Add to ~/.gemini/settings.json: { "mcpServers": { "nameable": { "command": "npx", "args": ["-y", "nameable", "mcp"] } } } |
| VS Code | code --add-mcp '{"name":"nameable","type":"stdio","command":"npx","args":["-y","nameable","mcp"]}' |
| Cursor | Add to .cursor/mcp.json or ~/.cursor/mcp.json: { "mcpServers": { "nameable": { "command": "npx", "args": ["-y", "nameable", "mcp"] } } } |
Nameable MCP questions
How do I add Nameable MCP to Claude Code?
Run claude mcp add nameable -- npx -y nameable in your terminal. Add --scope user to make it available in every project.
How do I add Nameable MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What does Nameable check?
It checks name availability on package registries, GitHub, agent and editor directories, app stores, and domains.
How does Nameable handle names that are not found but might be restricted?
Unlike other tools that assume 'not found' means free, Nameable applies registry-specific rules to identify reserved, similar, or recently deleted names.
Can I use Nameable with AI agents?
Yes, it can be used as an MCP server or as a Claude Code plugin to help agents evaluate name candidates.