Sherlock Domains MCP

Instructions

List domains owned by the authenticated user.
Each domain object contains:
    id (str): Unique domain identifier (domain_id in other methods)
    domain_name (str): The registered domain name
    created_at (str): ISO timestamp of domain creation
    expires_at (str): ISO timestamp of domain expiration
    auto_renew (bool): Whether domain is set to auto-renew
    locked (bool): Domain transfer lock status
    private (bool): WHOIS privacy protection status
    nameservers (list): List of nameserver hostnames
    status (str): Domain status (e.g. 'active')

Implementation Reference

• src/sherlock_mcp/server.py:134-149 (handler)

  The handler function for the 'domains' MCP tool. It has no input parameters and returns the list of owned domains by calling the external Sherlock client's _domains() method, wrapped in handle_response for consistent response handling. The docstring provides schema information for the output.

  @mcp.tool()
  async def domains():
      """
      List domains owned by the authenticated user.
      Each domain object contains:
          id (str): Unique domain identifier (domain_id in other methods)
          domain_name (str): The registered domain name
          created_at (str): ISO timestamp of domain creation
          expires_at (str): ISO timestamp of domain expiration
          auto_renew (bool): Whether domain is set to auto-renew
          locked (bool): Domain transfer lock status
          private (bool): WHOIS privacy protection status
          nameservers (list): List of nameserver hostnames
          status (str): Domain status (e.g. 'active')
      """
      return handle_response(get_sherlock()._domains())