namecatcher-skills

NameCatcher — username intelligence for AI agents

Score and value collectible Telegram usernames: namability score (0–100) validated against 111k+ real Fragment sales, fair price estimation in GRAM, and positioning theses. Free public API — no key, no wallet, no setup.

Three ways to plug in, thinnest first:

Layer	For	Install
Plain HTTP	any agent that can curl/fetch	nothing
Agent Skill	Claude Code / skills-compatible agents	npx skills add productmap/namecatcher-skills
MCP server	Claude Desktop/Code, any MCP client	npx -y namecatcher-mcp

Built by NameCatcher — the Telegram mini app for username investors: mint catching, market analytics, portfolio, value passports.

Quick try

curl -s "https://api-namecatcher.rocketname.com/public/score/wearlab?lang=en" | jq

{
  "username": "wearlab",
  "score": 67,
  "band": "strong",
  "fair_price_ton": 400,
  "thesis": "A crisp fusion of \"wear\" and \"lab\" …",
  "lang": "en",
  "analysis_url": "https://t.me/NameCatcherBot?startapp=name_wearlab__pub_api",
  "fragment_url": "https://fragment.com/username/wearlab"
}

API reference

One endpoint, no auth:

GET https://api-namecatcher.rocketname.com/public/score/{name}?lang={en|ru}

Parameters

Param	In	Required	Description
name	path	yes	Username without @. 4–32 chars, a-z 0-9 _
lang	query	no	en (default) or ru — language of thesis

Response fields

Field	Type	Description
username	string	Canonical (lowercase) username
score	int 0–100	Namability — quality of the name as a brandable asset. Market-validated: names scoring 90+ sell for a multiple of 80–89 names
band	string	premium (≥80) · strong (≥66) · medium (≥50) · weak (<50). Below 50 is not investment-grade
fair_price_ton	number | null	Class-based fair price estimate in GRAM (length × score class)
thesis	string | null	Short positioning summary (why the name works, for whom). Present only for names already analyzed — null is not a quality signal
lang	string	Language the thesis was returned in
analysis_url	string	Full breakdown in the NameCatcher mini app
fragment_url	string	The name's page on Fragment (live market status, buy/bid)

Errors

Status	Body	Meaning
400	{"error":"INVALID_NAME"}	Not a valid username string
400	{"error":"NOT_COLLECTIBLE"}	Valid string, but not scorable as a collectible (e.g. too short)
429	{"error":"RATE_LIMITED","retry_after_s":n}	Over 60 req/min per IP — wait retry_after_s and retry
429	{"error":"DAILY_LIMIT","limit_per_day":1000}	Over 1,000 req/day per IP

Rate limits

60 requests/min and 1,000 requests/day per IP. Generous for agent workflows (evaluating and comparing dozens of names); not enough for bulk scraping — that's intentional. Need more for a legitimate use case? Ping @BrandEvangelist.

curl cookbook

# Score one name (Russian thesis)
curl -s "https://api-namecatcher.rocketname.com/public/score/morya?lang=ru" | jq '{score, band, fair_price_ton}'

# Compare candidates: pick the best of three
for n in pulsefit traintrack fitwave; do
  curl -s "https://api-namecatcher.rocketname.com/public/score/$n" | jq -c '{username, score, band}'
done | sort -t: -k2 -rn

# Pre-purchase check: is a 300 GRAM ask below class valuation?
curl -s "https://api-namecatcher.rocketname.com/public/score/vault" \
  | jq '{score, fair_price_ton, below_class: (.fair_price_ton / 300 >= 1.2)}'

Agent Skill

The names/ton-usernames skill teaches an agent the full workflow: single-name evaluation, candidate comparison, and pre-purchase checks against Fragment asks.

npx skills add productmap/namecatcher-skills --skill ton-usernames
# or manually:
cp -r names/ton-usernames ~/.claude/skills/

A PR adding this skill to the official ton-org/skills is open.

MCP server

A thin stdio bridge over the same API — for Claude Desktop, Claude Code, and any MCP client. No key needed. Published on npm as namecatcher-mcp (GitHub install npx -y github:productmap/namecatcher-skills also works).

Remote endpoint (Streamable HTTP) — same three tools, zero install:

https://mcp-namecatcher.rocketname.com/mcp

claude mcp add --transport http namecatcher https://mcp-namecatcher.rocketname.com/mcp

Claude Code:

claude mcp add namecatcher -- npx -y namecatcher-mcp

Claude Desktop / other MCP clients (mcpServers config):

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

Tools

Tool	Description	Arguments
score_name	Score one username: namability, band, fair price, thesis	name, lang?
compare_names	Score up to 20 candidates and rank them by score	names[], lang?
check_fragment_ask	Compare a Fragment asking price to the class valuation → fair/ask ratio + verdict	name, ask_ton

Environment: NAMECATCHER_API_ORIGIN (optional) — override the API origin.

Notes for builders

• The score measures naming quality, deterministic per model version — safe to cache
• It is not demand for a specific lot: always check the live Fragment price before money decisions
• Pairs naturally with TON wallet tooling (@ton/mcp): evaluate → then buy

Links

• 🤖 Bot & mini app: @NameCatcherBot
• 🛒 Username market: fragment.com
• 🧩 TON MCP ecosystem: mcp.ton.org

License

MIT