{"name":"Vanity Phone Number Studio — Agent API","description":"Generate memorable vanity phone numbers from a brief, decode numbers into words, and verify availability.","auth":"Authorization: Bearer $VANITY_AGENT_API_KEY  (or x-api-key: $VANITY_AGENT_API_KEY)","mcp":{"remote":"POST /api/mcp (Streamable HTTP, bearer auth) — no local install","stdio":"scripts/mcp-server.mjs"},"endpoints":{"GET /api/agent":"This capability document.","POST /api/agent/find":{"description":"Find ranked vanity numbers for a brief. Availability is checked automatically when the prompt asks for available numbers (or when checkAvailability is true).","body":{"prompt":"string — e.g. \"cool vanity number for a Las Vegas tech business that is available\"","areaCode":"optional 3-digit code; overrides the prompt","theme":"optional built-in list id","words":"optional explicit words, e.g. [\"BIG\", \"CODE\"]","limit":"optional number of results (default 40)","checkAvailability":"optional boolean","onlyAvailable":"optional boolean — filter to numbers Twilio can sell","availabilityLimit":"optional number of top candidates to check (default 5)"}},"POST /api/agent/discover":{"description":"Scan an area code's available inventory and return numbers that spell real words. Use when the caller gives an area code/city but no specific words.","body":{"areaCode":"702","pages":"inventory pages to scan (default 3)","limit":20,"minScore":80}},"POST /api/agent/decode":{"description":"Decode a number into dictionary word readings.","body":{"number":"string — 7 or 10 digits"}},"POST /api/agent/verify":{"description":"Batch-verify words against Twilio inventory using the Contains pattern (one call per word).","body":{"areaCode":"702","words":["BIGCODE","PROGRAM"]}},"POST /api/availability":{"description":"Check a single number against Twilio inventory (no agent key required).","body":{"number":"string"}}},"themes":[{"id":"core-3","name":"3-letter picks","group":"Picks","words":49},{"id":"core-4","name":"4-letter picks","group":"Picks","words":45},{"id":"tech","name":"Dev & tech","group":"Tech","words":73},{"id":"trendy","name":"Trendy","group":"Themes","words":23},{"id":"luxury","name":"Luxury","group":"Themes","words":20},{"id":"money","name":"Money","group":"Themes","words":26},{"id":"health","name":"Health","group":"Themes","words":21},{"id":"realestate","name":"Real estate","group":"Themes","words":20},{"id":"startup","name":"Startup","group":"Themes","words":22},{"id":"food","name":"Food & drink","group":"Themes","words":22},{"id":"fitness","name":"Fitness","group":"Themes","words":18},{"id":"auto","name":"Auto","group":"Themes","words":15},{"id":"music","name":"Music","group":"Themes","words":17},{"id":"travel","name":"Travel","group":"Themes","words":16},{"id":"crypto","name":"Crypto","group":"Themes","words":16},{"id":"outdoors","name":"Outdoors","group":"Themes","words":22},{"id":"ai","name":"AI","group":"Themes","words":14},{"id":"pets","name":"Pets","group":"Themes","words":13},{"id":"vegas","name":"Las Vegas","group":"Themes","words":24},{"id":"common-3","name":"Common words · 3","group":"Dictionary","words":699},{"id":"common-4","name":"Common words · 4","group":"Dictionary","words":1175}],"examples":[{"method":"POST","path":"/api/agent/find","body":{"prompt":"find a cool available vanity number in Las Vegas for a tech business","onlyAvailable":true,"limit":5}}]}