Developer API & MCP

Domain naming for your apps & agents

Generate brandable names and check domain availability in real time — straight from your code or any AI agent. One endpoint, MCP or JSON-RPC, self-serve keys.

POST https://domainium.io/api/mcp

Three tools

The same tools whether you call MCP or JSON-RPC. Balance reads are free.

1 credit

search_names

Generate brandable domain & business names from a natural-language idea.

query, style, language, maxLength, tlds, excludeWords, count (1–20)

Pack

check_domain_availability

Check availability for up to 20 domains at once. Requires a Starter or Pro pack.

domains[] (max 20)

Free

get_credits_balance

Return the remaining credit balance for the authenticated key.

What each plan unlocks

Any logged-in user gets a key. Bulk availability checks need a pack.

FreeStarter / Pro
Create an API key
search_names — AI name generation10 / mo, then credits
get_credits_balance
check_domain_availability — bulk pack

Usage is metered at call time · 10 req/min per key

Quickstart

From zero to your first call in three steps.

Step 1

Create a key

Grab a credit pack, then generate a key in your dashboard.

Create API key
Step 2

Connect

Add the MCP server to Claude, Cursor or any agent — or call the JSON-RPC endpoint directly.

Step 3

Call a tool

Run search_names, check availability and read your balance.

Add the MCP server— Claude Desktop, Cursor, any agent
.mcp.json · cursor
// .mcp.json (Claude Code) · ~/.cursor/mcp.json (Cursor)
{
  "mcpServers": {
    "domainium": {
      "type": "http",
      "url": "https://domainium.io/api/mcp",
      "headers": {
        "Authorization": "Bearer nf_sk_..."
      }
    }
  }
}

// Claude Desktop → Settings → Connectors → Add custom connector
// (paste the URL above), or bridge it locally:
//   npx mcp-remote https://domainium.io/api/mcp \
//     --header "Authorization: Bearer nf_sk_..."
…or call it directly— JSON-RPC over HTTP
curl
curl https://domainium.io/api/mcp \
  -H "Authorization: Bearer nf_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/call",
    "params": {
      "name": "search_names",
      "arguments": { "query": "a calm habit tracker", "count": 5, "tlds": ["com", "io"] }
    }
  }'
Discoverable

Built to the
MCP spec

A streamable-HTTP server with an unauthenticated discovery endpoint — so MCP clients and registries can list the server and its tools before you ever send a key.

  • Bearer-key auth (nf_sk_…)
  • 10 requests / minute per key
  • JSON-RPC 2.0 errors with Retry-After
discovery
# Discover the server and its tools (no auth)
curl https://domainium.io/api/mcp

# → { "name": "Domainium Name Finder MCP", "version": "1.0.0",
#     "tools": ["search_names", "check_domain_availability", "get_credits_balance"] }

Usage pricing

1 search = 1 credit. Standalone availability checks need a pack; balance reads are free. Pay once, no subscription.

Free

0/month

10 searches / month

Start free

Starter

4.99/one-time

500 credits · never expires

Get credits
Best Value

Pro

9.99/one-time

2000 credits · MCP + API

Get credits

Ship naming in minutes

Self-serve key. Free tier. No call required.