{ "schemaVersion": 1, "name": "names.dev", "description": "Public naming and domain evidence for assistants, using the same search service as the website.", "mcp": { "url": "https://api.names.dev/mcp", "transport": "streamable-http", "responseMode": "json", "stateless": true, "authentication": "none", "protocolVersions": [ "2025-11-25", "2025-06-18", "2025-03-26" ] }, "rest": { "search": "https://api.names.dev/v2/search", "openapi": "https://api.names.dev/openapi.json" }, "setup": "https://names.dev/agents", "health": "https://api.names.dev/health", "llms": "https://api.names.dev/llms.txt", "tools": [ { "name": "names_search", "description": "Search exact domains, labels or briefs across evidenced registration and marketplace paths.", "readOnly": true, "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 2, "maxLength": 2000, "description": "One exact domain, a bare name, or a product brief. Preserve the user's intended naming category." }, "limit": { "type": "integer", "minimum": 1, "maximum": 12, "description": "Maximum names to return, from 1 to 12. Fewer strong names may be returned." }, "tlds": { "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 40, "pattern": "^\\.?[a-z0-9-]+(?:\\.[a-z0-9-]+)*$" }, "maxItems": 12, "description": "Preferred domain endings, for example com, app or co.uk, in preference order." }, "budgetMaxUsdCents": { "type": "integer", "minimum": 0, "maximum": 1000000000000, "description": "Maximum acquisition budget in USD cents; $500 is 50000. Prices remain provider observations." } }, "required": [ "query" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "outputSchema": { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "requestId": { "type": "string" }, "query": { "type": "string" }, "mode": { "type": "string", "enum": [ "EXACT_DOMAIN", "LABEL_ONLY", "MIXED_LABEL_AND_BRIEF", "BRIEF" ] }, "seedLabel": { "type": "string" }, "exactDomain": { "type": "string" }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "meaning": { "type": "string" }, "why": { "type": "string" }, "origin": { "type": "string", "enum": [ "requested", "generated", "inventory" ] }, "primaryDomain": { "type": "string" }, "fit": { "type": "string", "enum": [ "strong", "good" ] }, "domains": { "type": "array", "items": { "type": "object", "properties": { "domain": { "type": "string" }, "registration": { "type": "object", "properties": { "kind": { "type": "string", "const": "registration" }, "domain": { "type": "string" }, "provider": { "type": "string" }, "sourceTrust": { "type": "string", "enum": [ "LIVE_REGISTRAR", "RDAP_DNS_HINT", "SEARCH_HINT" ] }, "state": { "type": "string", "enum": [ "registerable", "taken", "blocked", "looks_clear", "unknown" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "price": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "renewalPrice": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "url": { "type": "string", "format": "uri" }, "note": { "type": "string" } }, "required": [ "kind", "domain", "provider", "sourceTrust", "state", "checkedAt" ], "additionalProperties": false }, "offers": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "listing" }, "domain": { "type": "string" }, "provider": { "type": "string" }, "sourceTrust": { "type": "string", "const": "LIVE_MARKETPLACE" }, "state": { "type": "string", "enum": [ "active", "unknown", "removed" ] }, "listingType": { "type": "string", "enum": [ "buy_now", "make_offer", "auction", "lease_to_own", "unknown" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "price": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "minimumOffer": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "listingId": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "note": { "type": "string" } }, "required": [ "kind", "domain", "provider", "sourceTrust", "state", "listingType", "checkedAt", "url" ], "additionalProperties": false } }, "status": { "type": "string", "enum": [ "registerable", "listed", "checkout_required", "taken", "blocked", "unknown" ] } }, "required": [ "domain", "offers", "status" ], "additionalProperties": false } } }, "required": [ "id", "label", "origin", "primaryDomain", "domains" ], "additionalProperties": false } }, "diagnostics": { "type": "object", "properties": { "elapsedMs": { "type": "number", "minimum": 0 }, "generatedCount": { "type": "integer", "minimum": 0 }, "evaluatedCount": { "type": "integer", "minimum": 0 }, "verifiedCount": { "type": "integer", "minimum": 0 }, "evaluationProvider": { "type": "string", "enum": [ "jev", "unavailable", "not_needed" ] }, "deadlineReached": { "type": "boolean" }, "cacheHit": { "type": "boolean" }, "issues": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string" }, "operation": { "type": "string", "enum": [ "check", "inventory", "generate", "evaluate" ] }, "message": { "type": "string" } }, "required": [ "provider", "operation", "message" ], "additionalProperties": false } } }, "required": [ "elapsedMs", "generatedCount", "evaluatedCount", "verifiedCount", "evaluationProvider", "deadlineReached", "issues" ], "additionalProperties": false } }, "required": [ "version", "requestId", "query", "mode", "results", "diagnostics" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }, { "name": "names_check", "description": "Check one full domain and preserve its exact-domain intent before alternatives.", "readOnly": true, "inputSchema": { "type": "object", "properties": { "domain": { "type": "string", "minLength": 3, "maxLength": 253 } }, "required": [ "domain" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "outputSchema": { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "requestId": { "type": "string" }, "query": { "type": "string" }, "mode": { "type": "string", "enum": [ "EXACT_DOMAIN", "LABEL_ONLY", "MIXED_LABEL_AND_BRIEF", "BRIEF" ] }, "seedLabel": { "type": "string" }, "exactDomain": { "type": "string" }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "meaning": { "type": "string" }, "why": { "type": "string" }, "origin": { "type": "string", "enum": [ "requested", "generated", "inventory" ] }, "primaryDomain": { "type": "string" }, "fit": { "type": "string", "enum": [ "strong", "good" ] }, "domains": { "type": "array", "items": { "type": "object", "properties": { "domain": { "type": "string" }, "registration": { "type": "object", "properties": { "kind": { "type": "string", "const": "registration" }, "domain": { "type": "string" }, "provider": { "type": "string" }, "sourceTrust": { "type": "string", "enum": [ "LIVE_REGISTRAR", "RDAP_DNS_HINT", "SEARCH_HINT" ] }, "state": { "type": "string", "enum": [ "registerable", "taken", "blocked", "looks_clear", "unknown" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "price": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "renewalPrice": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "url": { "type": "string", "format": "uri" }, "note": { "type": "string" } }, "required": [ "kind", "domain", "provider", "sourceTrust", "state", "checkedAt" ], "additionalProperties": false }, "offers": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "listing" }, "domain": { "type": "string" }, "provider": { "type": "string" }, "sourceTrust": { "type": "string", "const": "LIVE_MARKETPLACE" }, "state": { "type": "string", "enum": [ "active", "unknown", "removed" ] }, "listingType": { "type": "string", "enum": [ "buy_now", "make_offer", "auction", "lease_to_own", "unknown" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "price": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "minimumOffer": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "listingId": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "note": { "type": "string" } }, "required": [ "kind", "domain", "provider", "sourceTrust", "state", "listingType", "checkedAt", "url" ], "additionalProperties": false } }, "status": { "type": "string", "enum": [ "registerable", "listed", "checkout_required", "taken", "blocked", "unknown" ] } }, "required": [ "domain", "offers", "status" ], "additionalProperties": false } } }, "required": [ "id", "label", "origin", "primaryDomain", "domains" ], "additionalProperties": false } }, "diagnostics": { "type": "object", "properties": { "elapsedMs": { "type": "number", "minimum": 0 }, "generatedCount": { "type": "integer", "minimum": 0 }, "evaluatedCount": { "type": "integer", "minimum": 0 }, "verifiedCount": { "type": "integer", "minimum": 0 }, "evaluationProvider": { "type": "string", "enum": [ "jev", "unavailable", "not_needed" ] }, "deadlineReached": { "type": "boolean" }, "cacheHit": { "type": "boolean" }, "issues": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string" }, "operation": { "type": "string", "enum": [ "check", "inventory", "generate", "evaluate" ] }, "message": { "type": "string" } }, "required": [ "provider", "operation", "message" ], "additionalProperties": false } } }, "required": [ "elapsedMs", "generatedCount", "evaluatedCount", "verifiedCount", "evaluationProvider", "deadlineReached", "issues" ], "additionalProperties": false } }, "required": [ "version", "requestId", "query", "mode", "results", "diagnostics" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }, { "name": "names_refine", "description": "Refine a product brief with feedback and exclude previously considered name labels.", "readOnly": true, "inputSchema": { "type": "object", "properties": { "brief": { "type": "string", "minLength": 4, "maxLength": 1000, "description": "Original product, audience and naming direction." }, "feedback": { "type": "string", "minLength": 2, "maxLength": 500, "description": "What should change, for example more playful, shorter, less corporate." }, "previousNames": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 24 }, "maxItems": 8, "description": "Previously considered name labels to exclude from returned results." }, "budgetMaxUsdCents": { "type": "integer", "minimum": 0, "maximum": 1000000000000 }, "tlds": { "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 40, "pattern": "^\\.?[a-z0-9-]+(?:\\.[a-z0-9-]+)*$" }, "maxItems": 12 }, "limit": { "type": "integer", "minimum": 1, "maximum": 12 } }, "required": [ "brief", "feedback" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "outputSchema": { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "requestId": { "type": "string" }, "query": { "type": "string" }, "mode": { "type": "string", "enum": [ "EXACT_DOMAIN", "LABEL_ONLY", "MIXED_LABEL_AND_BRIEF", "BRIEF" ] }, "seedLabel": { "type": "string" }, "exactDomain": { "type": "string" }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "meaning": { "type": "string" }, "why": { "type": "string" }, "origin": { "type": "string", "enum": [ "requested", "generated", "inventory" ] }, "primaryDomain": { "type": "string" }, "fit": { "type": "string", "enum": [ "strong", "good" ] }, "domains": { "type": "array", "items": { "type": "object", "properties": { "domain": { "type": "string" }, "registration": { "type": "object", "properties": { "kind": { "type": "string", "const": "registration" }, "domain": { "type": "string" }, "provider": { "type": "string" }, "sourceTrust": { "type": "string", "enum": [ "LIVE_REGISTRAR", "RDAP_DNS_HINT", "SEARCH_HINT" ] }, "state": { "type": "string", "enum": [ "registerable", "taken", "blocked", "looks_clear", "unknown" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "price": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "renewalPrice": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "url": { "type": "string", "format": "uri" }, "note": { "type": "string" } }, "required": [ "kind", "domain", "provider", "sourceTrust", "state", "checkedAt" ], "additionalProperties": false }, "offers": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "listing" }, "domain": { "type": "string" }, "provider": { "type": "string" }, "sourceTrust": { "type": "string", "const": "LIVE_MARKETPLACE" }, "state": { "type": "string", "enum": [ "active", "unknown", "removed" ] }, "listingType": { "type": "string", "enum": [ "buy_now", "make_offer", "auction", "lease_to_own", "unknown" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "price": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "minimumOffer": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "listingId": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "note": { "type": "string" } }, "required": [ "kind", "domain", "provider", "sourceTrust", "state", "listingType", "checkedAt", "url" ], "additionalProperties": false } }, "status": { "type": "string", "enum": [ "registerable", "listed", "checkout_required", "taken", "blocked", "unknown" ] } }, "required": [ "domain", "offers", "status" ], "additionalProperties": false } } }, "required": [ "id", "label", "origin", "primaryDomain", "domains" ], "additionalProperties": false } }, "diagnostics": { "type": "object", "properties": { "elapsedMs": { "type": "number", "minimum": 0 }, "generatedCount": { "type": "integer", "minimum": 0 }, "evaluatedCount": { "type": "integer", "minimum": 0 }, "verifiedCount": { "type": "integer", "minimum": 0 }, "evaluationProvider": { "type": "string", "enum": [ "jev", "unavailable", "not_needed" ] }, "deadlineReached": { "type": "boolean" }, "cacheHit": { "type": "boolean" }, "issues": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string" }, "operation": { "type": "string", "enum": [ "check", "inventory", "generate", "evaluate" ] }, "message": { "type": "string" } }, "required": [ "provider", "operation", "message" ], "additionalProperties": false } } }, "required": [ "elapsedMs", "generatedCount", "evaluatedCount", "verifiedCount", "evaluationProvider", "deadlineReached", "issues" ], "additionalProperties": false } }, "required": [ "version", "requestId", "query", "mode", "results", "diagnostics" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }, { "name": "names_compare", "description": "Verify two or three exact domains side by side without inventing prices, legal clearance or a valuation.", "readOnly": true, "inputSchema": { "type": "object", "properties": { "domains": { "type": "array", "items": { "type": "string", "minLength": 3, "maxLength": 253 }, "minItems": 2, "maxItems": 3, "description": "Two or three exact domains to verify. Each domain consumes one search allowance." }, "projectBrief": { "type": "string", "maxLength": 1000, "description": "Optional context for the assistant's comparison; this is not a legal or appraisal verdict." }, "budgetMaxUsdCents": { "type": "integer", "minimum": 0, "maximum": 1000000000000 } }, "required": [ "domains" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "outputSchema": { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "requestId": { "type": "string" }, "projectBrief": { "type": "string" }, "comparisons": { "type": "array", "items": { "type": "object", "properties": { "domain": { "type": "string" }, "response": { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "requestId": { "type": "string" }, "query": { "type": "string" }, "mode": { "type": "string", "enum": [ "EXACT_DOMAIN", "LABEL_ONLY", "MIXED_LABEL_AND_BRIEF", "BRIEF" ] }, "seedLabel": { "type": "string" }, "exactDomain": { "type": "string" }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "meaning": { "type": "string" }, "why": { "type": "string" }, "origin": { "type": "string", "enum": [ "requested", "generated", "inventory" ] }, "primaryDomain": { "type": "string" }, "fit": { "type": "string", "enum": [ "strong", "good" ] }, "domains": { "type": "array", "items": { "type": "object", "properties": { "domain": { "type": "string" }, "registration": { "type": "object", "properties": { "kind": { "type": "string", "const": "registration" }, "domain": { "type": "string" }, "provider": { "type": "string" }, "sourceTrust": { "type": "string", "enum": [ "LIVE_REGISTRAR", "RDAP_DNS_HINT", "SEARCH_HINT" ] }, "state": { "type": "string", "enum": [ "registerable", "taken", "blocked", "looks_clear", "unknown" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "price": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "renewalPrice": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "url": { "type": "string", "format": "uri" }, "note": { "type": "string" } }, "required": [ "kind", "domain", "provider", "sourceTrust", "state", "checkedAt" ], "additionalProperties": false }, "offers": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "listing" }, "domain": { "type": "string" }, "provider": { "type": "string" }, "sourceTrust": { "type": "string", "const": "LIVE_MARKETPLACE" }, "state": { "type": "string", "enum": [ "active", "unknown", "removed" ] }, "listingType": { "type": "string", "enum": [ "buy_now", "make_offer", "auction", "lease_to_own", "unknown" ] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "price": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "minimumOffer": { "type": "object", "properties": { "amountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string" }, "termYears": { "type": "integer", "exclusiveMinimum": 0 } }, "required": [ "amountCents", "currency" ], "additionalProperties": false }, "listingId": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "note": { "type": "string" } }, "required": [ "kind", "domain", "provider", "sourceTrust", "state", "listingType", "checkedAt", "url" ], "additionalProperties": false } }, "status": { "type": "string", "enum": [ "registerable", "listed", "checkout_required", "taken", "blocked", "unknown" ] } }, "required": [ "domain", "offers", "status" ], "additionalProperties": false } } }, "required": [ "id", "label", "origin", "primaryDomain", "domains" ], "additionalProperties": false } }, "diagnostics": { "type": "object", "properties": { "elapsedMs": { "type": "number", "minimum": 0 }, "generatedCount": { "type": "integer", "minimum": 0 }, "evaluatedCount": { "type": "integer", "minimum": 0 }, "verifiedCount": { "type": "integer", "minimum": 0 }, "evaluationProvider": { "type": "string", "enum": [ "jev", "unavailable", "not_needed" ] }, "deadlineReached": { "type": "boolean" }, "cacheHit": { "type": "boolean" }, "issues": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string" }, "operation": { "type": "string", "enum": [ "check", "inventory", "generate", "evaluate" ] }, "message": { "type": "string" } }, "required": [ "provider", "operation", "message" ], "additionalProperties": false } } }, "required": [ "elapsedMs", "generatedCount", "evaluatedCount", "verifiedCount", "evaluationProvider", "deadlineReached", "issues" ], "additionalProperties": false } }, "required": [ "version", "requestId", "query", "mode", "results", "diagnostics" ], "additionalProperties": false }, "error": { "type": "string" } }, "required": [ "domain" ], "additionalProperties": false } }, "guidance": { "type": "string" } }, "required": [ "version", "requestId", "comparisons", "guidance" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } } ], "resources": [ "names://guide", "names://capabilities" ], "prompts": [ "name_a_project", "refine_a_shortlist" ], "limits": { "requestsPerMinute": 30, "searchesPerMinute": 6, "aggregateRequestsPerMinute": 600, "aggregateSearchesPerMinute": 120, "comparisonDomains": 3, "comparisonSearchAllowancePerDomain": 1 }, "capabilities": { "search": true, "check": true, "refine": true, "compare": true, "purchases": false, "sellerWrites": false, "privateAccounts": false }, "compatibility": { "tested": "Official MCP TypeScript SDK Streamable HTTP client", "namedClients": "Configuration syntax documented for Codex and Claude Code; other named assistant clients have not been independently tested." }, "guidance": "Use names.dev to help someone choose a name and an evidenced domain path.\nStart with the actual brief, audience, preferred endings and acquisition budget. Use names_search for a brief or bare label, names_check for an exact domain, names_refine when the user gives feedback, and names_compare for two or three exact domains.\nRead meaning and why when provided. Preserve exact-domain and same-label intent before generated alternatives. Return fewer strong choices instead of filling a count.\nDomain status is a summary. Inspect registration and offers separately, including provider, sourceTrust, checkedAt, expiresAt, listingType, price and url. Money is integer cents plus currency. Never invent availability, ownership, prices, marketplace status or trademark clearance.\nRDAP_DNS_HINT and SEARCH_HINT are not proof that a domain can be purchased now. checkout_required means verify at the source. Missing data is unknown. Never relabel a provider outage or no results as availability.\nPresent name, meaning, fit, domain path, source, observed price or offer state, uncertainty and next action. Link to the provider's returned url when available.\nThese tools are public and read-only. They do not buy, register, transfer, send offers, edit DNS, access private accounts or provide legal clearance. No Rufio account or operator token is needed. Complete acquisition at the source provider.\nRespect request limits and avoid duplicate searches. names_compare uses one search allowance per domain. Check isError and diagnostics.issues; retry briefly after a rate-limit response instead of looping.", "canonicalAliases": { "mcp": "https://names.dev/api/mcp", "search": "https://names.dev/api/v2/search", "note": "Canonical proxies share their public request allowance. Prefer the direct endpoints." }, "fallback": { "mcp": "https://names-api-v2.nima-672.workers.dev/mcp", "note": "Fallback only if the primary custom domain is unavailable." } }