Getting started

Titlesearch comes in four forms that share one engine: a command-line tool, a local web app, a desktop app, and a self-hosted server. Each also runs an MCP server, so Claude can check names for you.

The desktop app

Download Titlesearch for macOS, Windows, or Linux from the latest release. It runs in your menu bar or system tray and opens the web app in its own window, already signed in. Its local token is kept in your system keychain.

The command line

Download the titlesearch binary for your platform from the latest release and check its checksum against SHA256SUMS. Then:

titlesearch check acme --tlds com,io,dev
titlesearch check acme --market "Invoicing for freelance designers"
titlesearch check --market "Invoicing for freelance designers" --suggest
titlesearch serve        # the web app at http://127.0.0.1:4717, for this computer only

serve prints a one-time sign-in code. See the CLI reference for every option.

Use it from Claude

Claude Desktop. Add Titlesearch to claude_desktop_config.json:

{
  "mcpServers": {
    "titlesearch": { "command": "npx", "args": ["-y", "titlesearch", "mcp"] }
  }
}

Claude Code:

claude mcp add titlesearch -- npx -y titlesearch mcp

With the binary installed, use titlesearch mcp instead of npx -y titlesearch mcp.

A team server. Deploy Titlesearch to Cloud Run, AWS, or Cloudflare Workers, then add https://<your server>/mcp as a custom connector in Claude. You sign in with your organization's account.

Then ask Claude something like: "I'm naming a scheduling app for landscaping crews. Suggest some names and check which have a free .com." The saas_naming_session prompt walks through a whole naming session.

Optional keys

None are needed to start. With them, Titlesearch can do more. In the desktop app, paste them on the Providers page; they're kept in your system keychain and take effect right away. For the command line and titlesearch serve, set them as environment variables:

Variable	Adds
ANTHROPIC_API_KEY	Market-overlap judgment and name suggestions with Claude. Without a model, Claude does both in chat.
TITLESEARCH_MODEL	An open model instead: no key, and nothing leaves your machine. builtin:qwen3-4b-instruct-2507 is the built-in model; titlesearch models install downloads it once (2.5 GB, checked against a pinned checksum). ollama:llama3.1:8b uses Ollama on this computer. Or openai-compatible:<model> with TITLESEARCH_MODEL_URL (and OPENAI_COMPATIBLE_API_KEY if needed) for OpenRouter, Groq, Together, or your own vLLM server. In the desktop app, choose it on the Providers page. Run titlesearch models to see what's installed.
PORKBUN_API_KEY, PORKBUN_SECRET_API_KEY	Prices and premium status from Porkbun. See Prices.
NAMECOM_USERNAME, NAMECOM_TOKEN	Prices from Name.com.

Titlesearch isn't a trademark search. Before committing to a name, search the trademark registers where you'll sell.