{"schemaVersion":1,"name":"names.dev","description":"Public naming, domain evidence and explicitly shared shortlists for assistants, using the same services 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","shortlists":"https://api.names.dev/v2/shortlists","openapi":"https://api.names.dev/openapi.json"},"setup":"https://names.dev/agents","marketplace":{"sellerPortal":"https://names.dev/portfolio","portfolios":"https://names.dev/lots","portfolioCatalog":"https://names.dev/api/v1/marketplace/lots","priceScope":"whole_portfolio","humanApprovalRequired":true},"health":"https://api.names.dev/health","llms":"https://api.names.dev/llms.txt","tools":[{"name":"names_portfolio_search","description":"Find published, control-checked domain portfolios sold as all-or-nothing lots. Prices cover the whole portfolio; this read-only lookup never submits an offer or records payment.","readOnly":true,"destructive":false,"inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":80,"description":"Words or domains to find in published portfolio lots."},"budgetMaxUsdCents":{"type":"integer","exclusiveMinimum":0,"maximum":10000000000,"description":"Maximum asking price for the entire portfolio in USD cents, never a per-domain price."},"page":{"type":"integer","minimum":1,"maximum":500},"limit":{"type":"integer","minimum":1,"maximum":20}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"format":{"type":"string","const":"names.dev/portfolio-catalog/v1"},"priceScope":{"type":"string","const":"whole_portfolio"},"lots":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]{0,58}[a-z0-9])?$"},"title":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":2000},"status":{"type":"string","const":"live"},"availableForAgreement":{"type":"boolean","const":true},"priceScope":{"type":"string","const":"whole_portfolio"},"saleMode":{"type":"string","const":"all_or_nothing"},"askingPrice":{"anyOf":[{"type":"object","properties":{"amountCents":{"type":"integer","exclusiveMinimum":0,"maximum":10000000000},"currency":{"type":"string","const":"USD"}},"required":["amountCents","currency"],"additionalProperties":false},{"type":"null"}]},"mode":{"type":"string","enum":["make_offer","buy_now","buy_now_or_offer"]},"revision":{"type":"integer","exclusiveMinimum":0},"domainCount":{"type":"integer","minimum":2,"maximum":100},"domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","maxLength":253,"pattern":"^[a-z0-9-]+(?:\\.[a-z0-9-]+)+$"},"displayDomain":{"type":"string","minLength":1,"maxLength":253},"controlCheckedAt":{"type":"string","format":"date-time"},"controlMethod":{"type":"string","enum":["dns_txt","registrar_api"]}},"required":["domain","displayDomain","controlCheckedAt","controlMethod"],"additionalProperties":false},"minItems":2,"maxItems":100},"humanApprovalRequired":{"type":"boolean","const":true},"paymentStatus":{"type":"string","const":"not_recorded"},"transferStatus":{"type":"string","const":"not_recorded"},"updatedAt":{"type":"string","format":"date-time"},"acquisitionUrl":{"type":"string","format":"uri"}},"required":["id","slug","title","description","status","availableForAgreement","priceScope","saleMode","askingPrice","mode","revision","domainCount","domains","humanApprovalRequired","paymentStatus","transferStatus","updatedAt","acquisitionUrl"],"additionalProperties":false},"maxItems":20},"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1,"maximum":500},"limit":{"type":"integer","minimum":1,"maximum":20},"hasMore":{"type":"boolean"},"source":{"type":"string","const":"names.dev"},"checkedAt":{"type":"string","format":"date-time"},"guidance":{"type":"string"}},"required":["format","priceScope","lots","total","page","limit","hasMore","source","checkedAt","guidance"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"names_search","description":"Search exact domains, labels or briefs across evidenced registration and marketplace paths.","readOnly":true,"destructive":false,"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, si or co.uk, in preference order. Unsupported registrar checks remain unknown; real marketplace listings may still be returned."},"budgetMaxUsdCents":{"type":"integer","minimum":0,"maximum":1000000000000,"description":"Maximum acquisition budget in USD cents; $500 is 50000. Prices remain provider observations."},"excludeLabels":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"},"maxItems":48,"description":"Explicitly rejected alternative labels, scoped to this brief; up to 48. Requested exact names are still checked."},"likedNames":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"},"meaning":{"type":"string","maxLength":240}},"required":["label"],"additionalProperties":false},"maxItems":8,"description":"Names the user saved for this brief, most recent first, up to 8, each with its meaning. New names follow their construction and register on other roots and never repeat their mark. Brief searches only; exact domains and bare labels ignore them."},"dislikedLabels":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"},"maxItems":48,"description":"Names the user turned down for this brief, up to 48. New names avoid each one's family: the same root or the same ending. Brief searches only; requested names are still checked."}},"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","description":"The evidenced acquisition domain. It can be a get/try prefix or app suffix variant of label; never imply the exact matching domain is available."},"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"]},"evaluationModel":{"type":"string","maxLength":100},"inventorySources":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","maxLength":100},"retrieved":{"type":"integer","minimum":0},"reviewed":{"type":"integer","minimum":0},"shortlisted":{"type":"integer","minimum":0}},"required":["provider","retrieved","reviewed","shortlisted"],"additionalProperties":false},"maxItems":20},"deadlineReached":{"type":"boolean"},"cacheHit":{"type":"boolean"},"screenedOut":{"type":"integer","minimum":0},"withoutDomain":{"type":"integer","minimum":0},"brands":{"type":"object","properties":{"vetoed":{"type":"integer","minimum":0},"flagged":{"type":"integer","minimum":0}},"required":["vetoed","flagged"],"additionalProperties":false},"offBrief":{"type":"integer","minimum":0},"overuse":{"type":"object","properties":{"marks":{"type":"integer","minimum":0},"keptOut":{"type":"integer","minimum":0}},"required":["marks","keptOut"],"additionalProperties":false},"nameStudio":{"type":"object","properties":{"suggested":{"type":"integer","minimum":0},"kept":{"type":"integer","minimum":0}},"required":["suggested","kept"],"additionalProperties":false},"stageMs":{"type":"object","properties":{"check":{"type":"integer","minimum":0},"gather":{"type":"integer","minimum":0},"review":{"type":"integer","minimum":0},"verify":{"type":"integer","minimum":0},"recovery":{"type":"integer","minimum":0},"screen":{"type":"integer","minimum":0},"fit":{"type":"integer","minimum":0},"meaning":{"type":"integer","minimum":0},"meaningWait":{"type":"integer","minimum":0}},"additionalProperties":false},"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,"destructive":false,"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","description":"The evidenced acquisition domain. It can be a get/try prefix or app suffix variant of label; never imply the exact matching domain is available."},"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"]},"evaluationModel":{"type":"string","maxLength":100},"inventorySources":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","maxLength":100},"retrieved":{"type":"integer","minimum":0},"reviewed":{"type":"integer","minimum":0},"shortlisted":{"type":"integer","minimum":0}},"required":["provider","retrieved","reviewed","shortlisted"],"additionalProperties":false},"maxItems":20},"deadlineReached":{"type":"boolean"},"cacheHit":{"type":"boolean"},"screenedOut":{"type":"integer","minimum":0},"withoutDomain":{"type":"integer","minimum":0},"brands":{"type":"object","properties":{"vetoed":{"type":"integer","minimum":0},"flagged":{"type":"integer","minimum":0}},"required":["vetoed","flagged"],"additionalProperties":false},"offBrief":{"type":"integer","minimum":0},"overuse":{"type":"object","properties":{"marks":{"type":"integer","minimum":0},"keptOut":{"type":"integer","minimum":0}},"required":["marks","keptOut"],"additionalProperties":false},"nameStudio":{"type":"object","properties":{"suggested":{"type":"integer","minimum":0},"kept":{"type":"integer","minimum":0}},"required":["suggested","kept"],"additionalProperties":false},"stageMs":{"type":"object","properties":{"check":{"type":"integer","minimum":0},"gather":{"type":"integer","minimum":0},"review":{"type":"integer","minimum":0},"verify":{"type":"integer","minimum":0},"recovery":{"type":"integer","minimum":0},"screen":{"type":"integer","minimum":0},"fit":{"type":"integer","minimum":0},"meaning":{"type":"integer","minimum":0},"meaningWait":{"type":"integer","minimum":0}},"additionalProperties":false},"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,"destructive":false,"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","pattern":"^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"},"maxItems":48,"description":"Explicitly rejected name labels to exclude before generation and ranking; up to 48."},"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","description":"The evidenced acquisition domain. It can be a get/try prefix or app suffix variant of label; never imply the exact matching domain is available."},"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"]},"evaluationModel":{"type":"string","maxLength":100},"inventorySources":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","maxLength":100},"retrieved":{"type":"integer","minimum":0},"reviewed":{"type":"integer","minimum":0},"shortlisted":{"type":"integer","minimum":0}},"required":["provider","retrieved","reviewed","shortlisted"],"additionalProperties":false},"maxItems":20},"deadlineReached":{"type":"boolean"},"cacheHit":{"type":"boolean"},"screenedOut":{"type":"integer","minimum":0},"withoutDomain":{"type":"integer","minimum":0},"brands":{"type":"object","properties":{"vetoed":{"type":"integer","minimum":0},"flagged":{"type":"integer","minimum":0}},"required":["vetoed","flagged"],"additionalProperties":false},"offBrief":{"type":"integer","minimum":0},"overuse":{"type":"object","properties":{"marks":{"type":"integer","minimum":0},"keptOut":{"type":"integer","minimum":0}},"required":["marks","keptOut"],"additionalProperties":false},"nameStudio":{"type":"object","properties":{"suggested":{"type":"integer","minimum":0},"kept":{"type":"integer","minimum":0}},"required":["suggested","kept"],"additionalProperties":false},"stageMs":{"type":"object","properties":{"check":{"type":"integer","minimum":0},"gather":{"type":"integer","minimum":0},"review":{"type":"integer","minimum":0},"verify":{"type":"integer","minimum":0},"recovery":{"type":"integer","minimum":0},"screen":{"type":"integer","minimum":0},"fit":{"type":"integer","minimum":0},"meaning":{"type":"integer","minimum":0},"meaningWait":{"type":"integer","minimum":0}},"additionalProperties":false},"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,"destructive":false,"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","description":"The evidenced acquisition domain. It can be a get/try prefix or app suffix variant of label; never imply the exact matching domain is available."},"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"]},"evaluationModel":{"type":"string","maxLength":100},"inventorySources":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","maxLength":100},"retrieved":{"type":"integer","minimum":0},"reviewed":{"type":"integer","minimum":0},"shortlisted":{"type":"integer","minimum":0}},"required":["provider","retrieved","reviewed","shortlisted"],"additionalProperties":false},"maxItems":20},"deadlineReached":{"type":"boolean"},"cacheHit":{"type":"boolean"},"screenedOut":{"type":"integer","minimum":0},"withoutDomain":{"type":"integer","minimum":0},"brands":{"type":"object","properties":{"vetoed":{"type":"integer","minimum":0},"flagged":{"type":"integer","minimum":0}},"required":["vetoed","flagged"],"additionalProperties":false},"offBrief":{"type":"integer","minimum":0},"overuse":{"type":"object","properties":{"marks":{"type":"integer","minimum":0},"keptOut":{"type":"integer","minimum":0}},"required":["marks","keptOut"],"additionalProperties":false},"nameStudio":{"type":"object","properties":{"suggested":{"type":"integer","minimum":0},"kept":{"type":"integer","minimum":0}},"required":["suggested","kept"],"additionalProperties":false},"stageMs":{"type":"object","properties":{"check":{"type":"integer","minimum":0},"gather":{"type":"integer","minimum":0},"review":{"type":"integer","minimum":0},"verify":{"type":"integer","minimum":0},"recovery":{"type":"integer","minimum":0},"screen":{"type":"integer","minimum":0},"fit":{"type":"integer","minimum":0},"meaning":{"type":"integer","minimum":0},"meaningWait":{"type":"integer","minimum":0}},"additionalProperties":false},"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#"}},{"name":"names_shortlist_create","description":"Explicitly create an unlisted 30-day shortlist of selected domains and a reviewed brief. Returns a reader link and a separate private owner revocation capability.","readOnly":false,"destructive":false,"inputSchema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":120},"brief":{"type":"string","maxLength":2000},"domains":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":8},"tlds":{"type":"array","items":{"type":"string","minLength":2,"maxLength":40,"pattern":"^\\.?[a-z0-9-]+(?:\\.[a-z0-9-]+)*$"},"maxItems":12},"budgetMaxUsdCents":{"type":"integer","minimum":0,"maximum":1000000000000}},"required":["title","brief","domains"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"version":{"type":"number","const":2},"id":{"type":"string","pattern":"^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"},"readToken":{"type":"string","pattern":"^[a-f0-9]{64}$"},"shareUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"},"owner":{"type":"object","properties":{"revocationToken":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["revocationToken"],"additionalProperties":false},"guidance":{"type":"string"}},"required":["version","id","readToken","shareUrl","expiresAt","owner","guidance"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"names_shortlist_read","description":"Read a shared shortlist using its reader capability. Does not return owner capabilities or current domain availability; recheck domain evidence separately.","readOnly":true,"destructive":false,"inputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"},"readToken":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Reader capability from creation or the shared URL fragment. Never publish the owner revocation capability."}},"required":["id","readToken"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":120},"brief":{"type":"string","maxLength":2000},"domains":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":8},"tlds":{"type":"array","items":{"type":"string","minLength":2,"maxLength":40,"pattern":"^\\.?[a-z0-9-]+(?:\\.[a-z0-9-]+)*$"},"maxItems":12},"budgetMaxUsdCents":{"type":"integer","minimum":0,"maximum":1000000000000},"id":{"type":"string","pattern":"^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"evidence":{"type":"string","const":"check_domains_for_current_evidence"},"access":{"type":"string","const":"unlisted_link"}},"required":["title","brief","domains","id","createdAt","expiresAt","evidence","access"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"names_shortlist_revoke","description":"Revoke sharing only at the user's request, using the private owner capability. A reader link cannot revoke; expired, missing and revoked shares remain indistinguishable.","readOnly":false,"destructive":true,"inputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"},"revocationToken":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Private owner capability returned by creation. A reader capability cannot revoke sharing."}},"required":["id","revocationToken"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"version":{"type":"number","const":2},"id":{"type":"string","pattern":"^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$"},"revoked":{"type":"boolean","const":true}},"required":["version","id","revoked"],"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,"portfolioSearch":true,"sharedShortlists":{"create":true,"read":true,"revoke":true,"access":"unlisted_capability","lifetimeDays":30},"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.\nUse names_portfolio_search when the user wants an existing domain portfolio, rather than a new name. Each asking price covers the entire all-or-nothing portfolio. Read controlCheckedAt, availableForAgreement and revision; humanApprovalRequired stays true and paymentStatus/transferStatus remain not_recorded. Acquisition links open the source for a person to review; this tool does not send offers or complete an agreement.\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.\nSearch, check, refinement, comparison and shortlist reads are read-only. Only when the user explicitly asks, use names_shortlist_create to share reviewed brief/preferences and selected domains. Return the shareUrl, whose reader capability is in its fragment; keep owner.revocationToken private and separate. Use names_shortlist_read with a reader capability, then recheck domain evidence. Saved selections are not availability or price claims. Sharing expires after 30 days. Only at the user's request, names_shortlist_revoke cancels the link with the owner capability; a reader cannot revoke. Do not put capabilities in logs, public messages or unrelated resources.\nThese tools 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."}