@namemyapp/mcp
Model Context Protocol (MCP) server for namemy.app — gives Claude Desktop, Claude Code, Cursor, Windsurf, Continue.dev, ChatGPT, and any MCP-aware client live domain availability and one-click buy URLs.
Three ways to connect:
| Mode | Endpoint | Auth | Best for |
|---|
| Remote OAuth | https://mcp.namemy.app/mcp | OAuth 2.1 + PKCE | Claude.ai web · ChatGPT · directory listings |
| Remote direct | https://mcp.namemy.app/direct | Bearer namemy.app key | Claude Desktop · curl · custom scripts |
| Local stdio | npx -y @namemyapp/mcp | Env var key | Claude Code plugin · restricted networks |
The remote OAuth endpoint is the recommended path for hosted clients. Use direct or stdio if your client doesn't speak OAuth. This npm package is the stdio mirror.
What it does
Your AI agent can already suggest names. This server lets it:
- Check domain availability across registrars with unified retail pricing
- Hand the user a one-click buy URL that drops them into namemy.app's checkout — sign-up + payment in one flow, your agent never touches a card
- Generate brandable names with availability fused in (authed mode)
- Buy domains server-to-server (authed mode)
- Set DNS records, generate logos, legal docs, brand kits (authed mode)
Install — Claude.ai web / Cursor / ChatGPT (remote, OAuth)
Use the OAuth-protected endpoint when the client supports it (Claude.ai web/mobile connectors, ChatGPT Apps, Cursor's remote MCP, anything that follows MCP protected-resource discovery):
https://mcp.namemy.app/mcp
The client opens a browser tab where you paste your namemy.app API key once — after that the connector refreshes its own OAuth tokens. OAuth metadata is at /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource.
Install — Claude Desktop / scripts (remote, direct bearer)
For clients that don't do OAuth (Claude Desktop's basic remote MCP, curl, custom scripts), point at the direct endpoint and pass your API key as a bearer token:
{
"mcpServers": {
"namemyapp": {
"transport": "http",
"url": "https://mcp.namemy.app/direct",
"headers": { "Authorization": "Bearer nma_live_..." }
}
}
}
Restart Claude Desktop. Ask: "is codeflow.ai available?"
Install — Claude Desktop (local stdio fallback)
{
"mcpServers": {
"namemyapp": {
"command": "npx",
"args": ["-y", "@namemyapp/mcp"],
"env": { "NAMEMYAPP_AGENT_SOURCE": "claude-desktop" }
}
}
}
Install — Claude Code
/plugin install namemyapp
The bundled plugin ships a SKILL that triggers on naming/domain prompts plus three slash commands (/check-domain, /name-app, /buy-domain). Or wire just the MCP server in ~/.claude.json with the same JSON snippet as Claude Desktop.
Install — Cursor / Windsurf / Continue.dev
Same JSON shape:
{
"mcpServers": {
"namemyapp": {
"command": "npx",
"args": ["-y", "@namemyapp/mcp"],
"env": { "NAMEMYAPP_AGENT_SOURCE": "cursor" }
}
}
}
- Cursor:
~/.cursor/mcp.json (or workspace .cursor/mcp.json)
- Windsurf:
~/.codeium/windsurf/mcp_config.json
- Continue.dev:
~/.continue/config.json under experimental.modelContextProtocolServers
Full install matrix: https://namemy.app/agents/install.
Two modes
| Mode | Trigger | Tools exposed |
|---|
| public | no NAMEMYAPP_API_KEY | buy_link (URL builder, no network call) |
| authed | NAMEMYAPP_API_KEY=nma_live_... | All 12 tools wrapping /api/v1/* |
Public mode is the zero-friction path — npx -y @namemyapp/mcp works without any signup. Get a free key at https://namemy.app/app/api-keys for the full surface.
buy_link — always available
Build a one-click purchase URL.
{ domain: "codeflow.ai", priceUsd?: 13.20 }
check_domain — authed
Live single-domain availability + price.
{ domain: "codeflow.ai" }
generate_names — authed
AI brand name generation with availability fused in.
{ description: "AI task manager", tlds?, count?, industry? }
buy_domain (server-to-server), list_domains, set_dns_record, brand_conflict_check, generate_logo, generate_legal_docs, generate_brand_kit, generate_social_kit.
Environment variables
| Var | Default | Purpose |
|---|
NAMEMYAPP_API_KEY | — | Bearer token for authed mode |
NAMEMYAPP_API_URL | https://namemy.app | Override for staging / self-hosted |
NAMEMYAPP_AGENT_SOURCE | mcp | Attribution tag stamped on every API call + buyUrl |
Attribution
Every API call sends X-Agent-Source header and ?source= query param. namemy.app records this on every Purchase row and pushes attribution events to PostHog so we can credit the agent that drove the conversion.
Transport
Stdio (this package) and Streamable HTTP. Two remote endpoints:
https://mcp.namemy.app/mcp — OAuth 2.1 (auth code + PKCE, dynamic client registration via RFC 7591). Clients discover via /.well-known/oauth-authorization-server.https://mcp.namemy.app/direct — raw Authorization: Bearer <namemy.app-api-key>.
Source + license
MIT. Source at https://github.com/Rakesh1002/namemyapp/tree/main/packages/mcp.