{
  "markdown": "# @namemyapp/mcp\n\nModel Context Protocol (MCP) server for [namemy.app](https://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.\n\nThree ways to connect:\n\n| Mode | Endpoint | Auth | Best for |\n|------|----------|------|----------|\n| **Remote OAuth** | `https://mcp.namemy.app/mcp` | OAuth 2.1 + PKCE | Claude.ai web · ChatGPT · directory listings |\n| **Remote direct** | `https://mcp.namemy.app/direct` | Bearer namemy.app key | Claude Desktop · curl · custom scripts |\n| **Local stdio** | `npx -y @namemyapp/mcp` | Env var key | Claude Code plugin · restricted networks |\n\nThe 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.\n\n[![npm](https://img.shields.io/npm/v/@namemyapp/mcp.svg)](https://www.npmjs.com/package/@namemyapp/mcp)\n[![license](https://img.shields.io/npm/l/@namemyapp/mcp.svg)](./LICENSE)\n\n## What it does\n\nYour AI agent can already suggest names. This server lets it:\n\n- **Check domain availability** across registrars with unified retail pricing\n- **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\n- **Generate brandable names** with availability fused in (authed mode)\n- **Buy domains server-to-server** (authed mode)\n- **Set DNS records, generate logos, legal docs, brand kits** (authed mode)\n\n## Install — Claude.ai web / Cursor / ChatGPT (remote, OAuth)\n\nUse 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):\n\n```\nhttps://mcp.namemy.app/mcp\n```\n\nThe 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`.\n\n## Install — Claude Desktop / scripts (remote, direct bearer)\n\nFor 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:\n\n```json\n{\n  \"mcpServers\": {\n    \"namemyapp\": {\n      \"transport\": \"http\",\n      \"url\": \"https://mcp.namemy.app/direct\",\n      \"headers\": { \"Authorization\": \"Bearer nma_live_...\" }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Ask: *\"is codeflow.ai available?\"*\n\n## Install — Claude Desktop (local stdio fallback)\n\n```json\n{\n  \"mcpServers\": {\n    \"namemyapp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@namemyapp/mcp\"],\n      \"env\": { \"NAMEMYAPP_AGENT_SOURCE\": \"claude-desktop\" }\n    }\n  }\n}\n```\n\n## Install — Claude Code\n\n```\n/plugin install namemyapp\n```\n\nThe 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.\n\n## Install — Cursor / Windsurf / Continue.dev\n\nSame JSON shape:\n\n```json\n{\n  \"mcpServers\": {\n    \"namemyapp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@namemyapp/mcp\"],\n      \"env\": { \"NAMEMYAPP_AGENT_SOURCE\": \"cursor\" }\n    }\n  }\n}\n```\n\n- Cursor: `~/.cursor/mcp.json` (or workspace `.cursor/mcp.json`)\n- Windsurf: `~/.codeium/windsurf/mcp_config.json`\n- Continue.dev: `~/.continue/config.json` under `experimental.modelContextProtocolServers`\n\nFull install matrix: <https://namemy.app/agents/install>.\n\n## Two modes\n\n| Mode | Trigger | Tools exposed |\n|------|---------|---------------|\n| **public** | no `NAMEMYAPP_API_KEY` | `buy_link` (URL builder, no network call) |\n| **authed** | `NAMEMYAPP_API_KEY=nma_live_...` | All 12 tools wrapping `/api/v1/*` |\n\nPublic 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.\n\n## Tools\n\n### `buy_link` — always available\n\nBuild a one-click purchase URL.\n\n```ts\n{ domain: \"codeflow.ai\", priceUsd?: 13.20 }\n// → { domain, buyUrl, source }\n```\n\n### `check_domain` — authed\n\nLive single-domain availability + price.\n\n```ts\n{ domain: \"codeflow.ai\" }\n// → { domain, available, bestPrice, comparison, buyUrl }\n```\n\n### `generate_names` — authed\n\nAI brand name generation with availability fused in.\n\n```ts\n{ description: \"AI task manager\", tlds?, count?, industry? }\n// → { meta, results: [{ name, tldOptions: [{ domain, available, price, buyUrl }] }] }\n```\n\n### Other authed tools\n\n`buy_domain` (server-to-server), `list_domains`, `set_dns_record`, `brand_conflict_check`, `generate_logo`, `generate_legal_docs`, `generate_brand_kit`, `generate_social_kit`.\n\n## Environment variables\n\n| Var | Default | Purpose |\n|-----|---------|---------|\n| `NAMEMYAPP_API_KEY` | — | Bearer token for authed mode |\n| `NAMEMYAPP_API_URL` | `https://namemy.app` | Override for staging / self-hosted |\n| `NAMEMYAPP_AGENT_SOURCE` | `mcp` | Attribution tag stamped on every API call + buyUrl |\n\n## Attribution\n\nEvery 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.\n\n## Transport\n\nStdio (this package) and Streamable HTTP. Two remote endpoints:\n\n- `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`.\n- `https://mcp.namemy.app/direct` — raw `Authorization: Bearer <namemy.app-api-key>`.\n\n## Source + license\n\nMIT. Source at <https://github.com/Rakesh1002/namemyapp/tree/main/packages/mcp>.\n",
  "bytes": 5781,
  "sha": "baa40c13ae21e2722c585c9210042f8e531b0768d5941b991dd52835d8ce277c",
  "repo_slug": "rakesh1002/namemyapp-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rakesh1002_namemyapp_786e8b84/readme"
}