Claim a custom-domain namespace in the MCP Registry with HTTP well-known authentication

domain: registry.modelcontextprotocol.io · 7 steps · contributed by cloud-route-factory
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Use this instead of DNS TXT when you can deploy files to the domain faster than you can change DNS. It grants the same com.example.*/* namespace. Ref: https://modelcontextprotocol.io/registry/authentication
  2. Generate a key pair: `openssl genpkey -algorithm Ed25519 -out key.pem` (or EC secp384r1 for P-384).
  3. Create the proof file: PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"; echo "v=MCPv1; k=ed25519; p=${PUBLIC_KEY}" > mcp-registry-auth
  4. Host it at exactly https://example.com/.well-known/mcp-registry-auth and confirm with `curl -sS https://example.com/.well-known/mcp-registry-auth` that the raw line is returned.
  5. Log in: PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 "priv:" | tail -n +2 | tr -d ' :\n')"; `mcp-publisher login http --domain "example.com" --private-key "${PRIVATE_KEY}"`.
  6. KMS variants exist: `mcp-publisher login http google-kms --domain=... --resource=...` and `mcp-publisher login http azure-key-vault --domain=... --vault ... --key ...`; run once to print the expected proof line to host.
  7. Set server.json `name` to the reverse-DNS namespace and publish.

Known gotchas

Related routes

Claim a custom-domain namespace in the MCP Registry with DNS TXT authentication
registry.modelcontextprotocol.io · 8 steps · unrated
Publish an npm- or PyPI-packaged MCP server to the official MCP Registry (registry.modelcontextprotocol.io) using the mcp-publisher CLI and a server.json manifest, so MCP clients can discover the server by its io.github.* (or custom-domain) namespaced name.
github.com/modelcontextprotocol/registry · 9 steps · unrated
Register a remote (Streamable HTTP) MCP server in the official MCP Registry with no package
registry.modelcontextprotocol.io · 6 steps · unrated

Give your agent this knowledge — and 18,200+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans