DomainForAgents API

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "domainforagents": {
      "command": "npx",
      "args": ["@domainforagents/mcp"],
      "env": {
        "DOMAINFORAGENTS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add domainforagents -- npx @domainforagents/mcp

Any MCP Client

npx @domainforagents/mcp

Set DOMAINFORAGENTS_API_KEY env var. Communicates over stdio.

Create an account. Returns an API key immediately. No email required -- agents can start searching and reserving domains instantly.

Request Body

Response

{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "api_key": "dGhpcyBpcyBhIHNhbXBsZSBrZXk...",
  "api_key_prefix": "dGhpcyBp",
  "claim_code": "AGENT-SWIFT-KIWI-7842",
  "sign_in_url": "https://domainforagents.io/claim",
  "balance_cents": 0,
  "created_at": "2026-04-12T00:00:00.000Z"
}

The claim_code lets a human claim the account on the web dashboard to manage billing and settings.

Create an additional API key for the authenticated account.

List all API keys for the authenticated account. Returns key prefix, name, and last used timestamp. The full key is never shown after creation.

Invalidates the current API key and returns a new one. Must authenticate with the key being rotated.

Search domain availability. Returns pricing with margin applied.

Query Parameters

Response

{
  "results": [
    {
      "domain": "myagent.com",
      "available": true,
      "price_usd": 12.99,
      "status": "available"
    },
    {
      "domain": "myagent.io",
      "available": true,
      "price_usd": 39.99,
      "status": "available"
    }
  ]
}

Generate AI-powered domain name suggestions from a project description. Uses the cheapest available LLM provider. First suggestion is checked for availability, the rest are returned as unchecked suggestions.

Request Body

curl -X POST https://api.domainforagents.io/api/v1/domains/suggest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{\"description\": \"online store for vintage cameras\"}'

Response

{
  "results": [
    {
      "domain": "retroshutter.com",
      "available": true,
      "price_usd": 15.14,
      "status": "available"
    },
    {
      "domain": "vintagelens.io",
      "status": "suggestion"
    },
    {
      "domain": "cameravault.dev",
      "status": "suggestion"
    }
  ],
  "provider": "gemini"
}

Results with status suggestion haven't been checked for availability yet. Use GET /domains/search?query=vintagelens.io to verify.

Register a domain. Supports three payment methods: prepaid balance, credit card, or crypto (USDC via prepaid balance). Registration is async -- domain state transitions to registering, then registered once confirmed.

Request Body

Pay with balance

curl -X POST https://api.domainforagents.io/api/v1/domains/register \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "myagent.io",
    "paymentMethod": { "type": "balance" }
  }'

Pay with card

curl -X POST https://api.domainforagents.io/api/v1/domains/register \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "myagent.io",
    "paymentMethod": {
      "type": "card",
      "card": {
        "number": "4242424242424242",
        "expMonth": 12,
        "expYear": 2027,
        "cvc": "123"
      },
      "saveCard": true
    }
  }'

Card details are passed directly to Stripe for tokenization. Never stored or logged.

Soft-reserve a domain. Creates a TTL-based hold (no upstream registration) and returns a Stripe Checkout payment URL. The human or agent can complete payment within the TTL window.

Response

{
  "reservation_id": "...",
  "domain": "myagent.io",
  "status": "soft_reserved",
  "price_usd": 39.99,
  "expires_at": "2026-04-12T15:00:00.000Z",
  "payment_url": "https://checkout.stripe.com/...",
  "guaranteed": false,
  "note": "Availability not guaranteed. Pay before expiry to register."
}

Max 5 concurrent reservations per account. Expired reservations are automatically released.

List all domains for the authenticated account with pagination and filtering.

Get domain details including state, expiry, DNS records, and registrant info.

Renew a registered domain. Deducts from prepaid balance.

Update WHOIS registrant details. Must be within the 30-day update window after registration. Domains default to proxy registration with WHOIS privacy.

List all DNS records for a domain. Fetches live records from the registrar when available.

Create a DNS record.

curl -X POST https://api.domainforagents.io/api/v1/domains/DOMAIN_ID/dns \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "@",
    "type": "A",
    "content": "76.76.21.21",
    "ttl": 3600
  }'

Supported types: A, AAAA, CNAME, MX, TXT, NS, SRV, CAA

Full replacement. All existing records not included in the request will be deleted. Use PATCH for safe partial updates.

Merge-safe partial update. Existing records not referenced are preserved.

Delete a specific DNS record.

Set custom nameservers. Disables managed DNS.

{
  "nameservers": ["ns1.example.com", "ns2.example.com"]
}

Reset to default nameservers. Re-enables managed DNS.

Get current balance in cents and recent transaction history.

Create a Stripe PaymentIntent to add funds.

Get deposit instructions for USDC (SPL on Solana). Balance is credited 1:1 upon transaction confirmation.

Response

{
  "wallet_address": "...",
  "accepted_token": "USDC",
  "usdc_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "memo": "YOUR_ACCOUNT_ID",
  "instructions": "Send USDC to the wallet address. Include your account ID in the memo field."
}

Include your account_id in the transaction memo so we can credit the right account.

Register a webhook endpoint.

curl -X POST https://api.domainforagents.io/api/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://myapp.com/webhook",
    "events": ["domain.registered", "domain.failed"]
  }'

Returns a secret for signature verification. Store it securely -- it's shown only once.

List all webhook subscriptions for the authenticated account.

Delete a webhook subscription.