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

Terminal

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

config.json

{
  "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:

Code

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

bash

# 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.

Terminal

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:

Code

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

Terminal

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

Claude Code:

Terminal

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

Claude Desktop / other MCP clients (mcpServers config):

config.json

{
  "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

License

MIT

Namecatcher Skills README

NameCatcher — username intelligence for AI agents

Quick try

API reference

Parameters

Response fields

Errors

Rate limits

curl cookbook

Agent Skill

MCP server

Tools

Notes for builders

Links

License