search
Find available domain names by entering a query, then view results with availability status and pricing in USD cents. Use the provided search ID to initiate purchase requests through the Sherlock Domains MCP server.
Instructions
Search for available domains matching the query.
Returns search results with available/unavailable domains, their prices in USD cents, and a search ID needed for purchase requests.
The query can be a full domain name with or without the TLD but not subdomains or text.
Valid queries:
- "example"
- "example.com"
- "my-domain"
Invalid queries:
- "www.example.com" # no subdomains
- "this is a search" # no spaces
- "sub.domain.com" # no subdomains
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes |
Implementation Reference
- src/sherlock_mcp/server.py:33-50 (handler)MCP tool handler for 'search': searches for available domains using Sherlock._search, handles response, and returns results including search ID for purchases.@mcp.tool() async def search(q: str) -> str: """ Search for available domains matching the query. Returns search results with available/unavailable domains, their prices in USD cents, and a search ID needed for purchase requests. The query can be a full domain name with or without the TLD but not subdomains or text. Valid queries: - "example" - "example.com" - "my-domain" Invalid queries: - "www.example.com" # no subdomains - "this is a search" # no spaces - "sub.domain.com" # no subdomains """ return handle_response(get_sherlock()._search(q))