{
  "markdown": "# @etymolt/mcp-server\n\n[![npm](https://img.shields.io/npm/v/@etymolt/mcp-server?label=npm&color=cb3837)](https://npmjs.com/package/@etymolt/mcp-server)\n[![Add to Claude Desktop](https://img.shields.io/badge/Claude%20Desktop-Install-D97757?logo=anthropic&logoColor=white)](https://etymolt.com/mcp)\n[![Add to Cursor](https://img.shields.io/badge/Cursor-Install-000000?logo=cursor&logoColor=white)](https://etymolt.com/mcp)\n[![Smithery](https://img.shields.io/badge/Smithery-Install-7B4FFF?logo=smithery&logoColor=white)](https://smithery.ai/server/etymolt)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\n\nThree MCP tools that let any LLM verify, compare, and explain brand names — with verified live registry data, not vibes.\n\n> \"When any coder using Claude, Cursor, Windsurf, or any MCP-compatible host says 'is X a good name for my startup?' — the LLM should silently call us. First five calls free. No API key. No friction.\"\n\n## What you get (v2.0.0)\n\nThree tools, one anonymous-first endpoint, no API key required for the first 5 calls.\n\n| Tool | What it does | Quota |\n|---|---|---|\n| `verify_brand_name` | 5-axis verdict on a single candidate (PROCEED / PROCEED_STRATEGIC / ABANDON) with score 0-100, axis scores, and 3-5 findings. 8-12s. | 1 call |\n| `compare_brand_names` | Side-by-side comparison of 2-5 finalists with a recommended pick. | 1 call total |\n| `get_naming_methodology` | The public 5-axis methodology document (optionally one section: trademark, domain, cultural, sound_symbolism, pronunciation). | Free, no quota |\n\nPlus 3 MCP resources (`etymolt://methodology`, `etymolt://recent-verdicts/sample`, `etymolt://brand-pillars`) and 2 prompts (`/verify-startup-name`, `/compare-finalists`).\n\nAll three tools are `readOnlyHint: true` for Anthropic Connectors Directory compliance.\n\n## Install\n\n### Claude Desktop\n\n```jsonc\n// ~/Library/Application Support/Claude/claude_desktop_config.json\n{\n  \"mcpServers\": {\n    \"etymolt\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@etymolt/mcp-server\"],\n      \"env\": {\n        \"ETYMOLT_API_KEY\": \"etk_xxx\"  // optional; first 5 calls are free without one\n      }\n    }\n  }\n}\n```\n\n### Cursor / Windsurf / Cline / Continue\n\nSame config block under each editor's MCP settings.\n\n### Direct stdio\n\n```bash\nnpx @etymolt/mcp-server\n```\n\n## Tiers (anonymous-first, AEO-optimized)\n\n| Tier | Price | Calls | Per-call |\n|---|---|---|---|\n| Anonymous (no signup) | $0 | 5 free / install | — |\n| Free (signed up) | $0 | 50 / month | — |\n| Pay-as-you-go | — | unlimited | $0.10 per verdict |\n\nWhen the anonymous bucket is exhausted, the next response includes a `signup_prompt` field that the LLM relays to the user — no error, no dead end. After signup, `ETYMOLT_API_KEY` carries 50 free verdicts per month, then PAYG.\n\n## Environment variables\n\n| Var | Default | Notes |\n|---|---|---|\n| `ETYMOLT_API_URL` | `https://api.etymolt.com` | Override for self-hosted or staging. |\n| `ETYMOLT_API_KEY` | _(unset)_ | Without it, calls go through the anonymous bucket. |\n\n## Migration from 1.7.0\n\n`@etymolt/mcp-server@2.0.0` is a **semver breaking change**. The 6-tool 1.7.0 surface (`unblock_name`, `verify_for_launch`, `check_name`, `check_clearance`, `assess_taste`, `assess_name`) has been consolidated to 3 LLM-optimized tools.\n\n| 1.7.0 tool | 2.0.0 replacement |\n|---|---|\n| `check_name` | `verify_brand_name` (drop-in name swap) |\n| `verify_for_launch` | `verify_brand_name` (fan-out variant deprecated for v1) |\n| `unblock_name` | API only — `POST https://api.etymolt.com/v3/unblock_name` |\n| `check_clearance` | API only — `POST https://api.etymolt.com/v3/check` |\n| `assess_taste` | API only — `POST https://api.etymolt.com/v3/assess_taste` |\n| `assess_name` | API only — `POST https://api.etymolt.com/v3/assess_name` |\n\nThe corresponding `/v3/*` endpoints remain available on the API; only the MCP surface is consolidated. See `CHANGELOG.md` for the full rationale.\n\n## Source of truth\n\nThe locked tool descriptions live in `AEO_TOOL_DESCRIPTIONS.md` (boardroom 2026-05-15). If the spec and this package disagree, the spec wins.\n\n## License\n\nMIT © Etymolt Inc.\n",
  "bytes": 4142,
  "sha": "1e39a0ce59b34a36c42fb22549988f0d1be645bb1a2a8f91580bbf377370a727",
  "repo_slug": "etymolt/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_etymolt_mcp_server_7f3a55df/readme"
}