Pentonym®
Home  ·  API & MCP
For builders · API & MCP

Add a clearance step to anything that hands people a name.

Name generators, registrars, and agent frameworks all end at the same moment — a user commits to a name. Pentonym is the check that fits there: one call, a signed verdict, verifiable by anyone.

Short answer

The Pentonym API takes a candidate name and returns a three-state US trademark clearance verdict — PROCEED, DO_NOT_PROCEED, or CANNOT_DETERMINE — with per-axis evidence, signed with Ed25519. It’s also exposed as an MCP tool, so assistants can run the check mid-conversation. US & EU coverage; a screening signal, not legal advice.

The call

One request, one signed verdict

# POST a candidate name, get a signed verdict back curl -X POST https://api.pentonym.com/v1/screen \ -H "Authorization: Bearer $PENTONYM_KEY" \ -d '{"name":"Pentonym","class":42}' { "name": "Pentonym", "verdict": "PROCEED", // never a score "gating": { "trademark": "CLEAR" }, "material": { "domains": "...", "handles": "...", "web": "...", "cultural": "..." }, "signature": "ed25519:wSYo21f8sMF0Cyt…", "verify": "https://pentonym.com/.well-known/pentonym-signing-key" }

The verdict is deterministic and signed, so a downstream product can display it — or re-verify it — without trusting Pentonym’s word for it. Only the trademark axis can return DO_NOT_PROCEED; the material axes are always advisory.

MCP

Callable from inside the model

Naming increasingly happens inside an assistant. Pentonym ships as an MCP server, so when a user asks a model to name something and check it’s free, the model can call clear_name and return a real signed verdict — not a guess. The tool description carries the honesty rails, so models repeat them: US & EU, three-state, not legal advice.

Who this is for

  • Name & brand generators — clear at the exit
  • Registrars & domain tools — a pre-purchase check
  • Agent frameworks — clear before the mint

What you get

  • A signed, verifiable verdict per name
  • Per-axis evidence, not a black-box number
  • Wholesale seats for high volume
FAQ

Common questions

What does the API return — a score?

No. It returns a three-state verdict (PROCEED / DO_NOT_PROCEED / CANNOT_DETERMINE) with the evidence behind each axis. There is no numeric score anywhere in the response.

How do I verify a verdict is genuine?

Every response is Ed25519-signed. Check the signature against the public key published at /.well-known/pentonym-signing-key — no call back to Pentonym required.

Does it cover non-US trademarks?

It screens the US (14.1M marks, full likelihood-of-confusion) and the EU (live EUIPO, exact-wordmark knockout) — but no other national registers, so don’t present it as worldwide.

Real verdict · pentonym.app/v1/screen · Ed25519 · signed & independently verifiable a screening signal, not legal advice · US & EU coverage