Skip to main content
Glama
Sherlock Domains MCP

Sherlock Domains MCP

by Fewsats

sherlock-mcp MCP server

Shelock Domains MCP server to buy & manage domains

Components

Resources

The server implements a simple note storage system with:

  • Custom note:// URI scheme for accessing individual notes

  • Each note resource has a name, description and text/plain mimetype

Prompts

The server provides a single prompt:

  • summarize-notes: Creates summaries of all stored notes

    • Optional "style" argument to control detail level (brief/detailed)

    • Generates prompt combining all current notes with style preference

Tools

The server implements one tool:

  • add-note: Adds a new note to the server

    • Takes "name" and "content" as required string arguments

    • Updates server state and notifies clients of resource changes

Related MCP server: codex-cli-mcp-tool

Configuration

[TODO: Add configuration details specific to your implementation]

Quickstart

Install

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

Development

Building and Publishing

To prepare the package for distribution:

  1. Sync dependencies and update lockfile:

uv sync
  1. Build package distributions:

uv build

This will create source and wheel distributions in the dist/ directory.

  1. Publish to PyPI:

uv publish

Note: You'll need to set PyPI credentials via environment variables or command flags:

  • Token: --token or UV_PUBLISH_TOKEN

  • Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory /Users/pengren/go/github.com/Fewsats/sherlock-mcp run sherlock-mcp

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

Available Tools

10 tools
claim_accountA
Links an email address to an AI agent's account for web interface access and account recovery.

Important notes:
- Only accounts without an existing email can be linked
- Each email can only be linked to one account
- This method is rarely needed since emails are also set during domain registration

Inputs: email (required).

create_dnsB
Create a new DNS record for a domain.

domain_id: Domain UUID (e.g., 'd1234567-89ab-cdef-0123-456789abcdef')
type: DNS record type ('A', 'AAAA', 'CNAME', 'MX', 'TXT', etc.)
name: Subdomain or record name (e.g., 'www' creates www.yourdomain.com)
value: Record value (e.g., IP address for A records, domain for CNAME)
ttl: Time To Live in seconds (default: 3600)

Inputs: domain_id (required), type, name, value, +1 more.

delete_dnsB
Delete a DNS record for a domain.

domain_id: Domain UUID (e.g., 'd1234567-89ab-cdef-0123-456789abcdef')
record_id: DNS record ID to delete

Inputs: domain_id (required), record_id (required).

dns_recordsB
Get DNS records for a domain.

domain_id: Domain UUID (e.g: 'd1234567-89ab-cdef-0123-456789abcdef')
Each DNS record contains:
    id (str): Unique record identifier
    type (str): DNS record type (e.g. 'A', 'CNAME', 'MX', 'TXT')
    name (str): DNS record name
    value (str): DNS record value
    ttl (int): Time to live in seconds

Inputs: domain_id (required).

domainsA
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')

Inputs: no named parameters.

get_contact_informationB

Retrieve the currently configured contact information that will be used for domain purchases and ICANN registration.

Inputs: no named parameters.

get_purchase_offersA
Request available payment options for a domain.
This method returns an L402 offer, which includes details such as offer_id, amount, currency, and more.
The returned offer can be processed by any tool supporting L402 offers.
The TLD .ai mandates a minimum registration and renewal period of two years. So inform the user that they need to purchase a 2 year package when they request a .ai domain.

The L402 offer structure:
{
    'offers': [
        {
            'offer_id': 'example_offer_id',  # String identifier for the offer
            'amount': 100,                 # Numeric cost value in USD cents
            'currency': 'usd',             # Currency code
            'description': 'Example offer', # Text description
            'title': 'Example Package'      # Title of the package
        }
    ],
    'payment_context_token': 'example_token',  # Payment context token
    'payment_request_url': 'https://api.example.com/payment-request',  # Payment URL
    'version': '0.2.2'  # API version
}

sid: Search ID from a previous search request
domain: Domain name to purchase from the search results related to `sid`

Inputs: sid (required), domain (required).

set_contact_informationA
Set the contact information that will be used for domain purchases and ICANN registration.
Contact information must be set before attempting any domain purchases.

All fields are required:
    first_name: First name
    last_name: Last name
    email: Email address
    address: Street address
    city: City
    state: Two-letter state code for US/Canada (e.g., 'CA', 'NY') or province name (e.g., 'Madrid')
    postal_code: Postal code
    country: Two-letter country code ('US', 'ES', 'FR')

Inputs: cfn (required), cln (required), cem (required), cadd (required), +4 more.

update_dnsB
Update an existing DNS record for a domain.

NOTE: Updating a record will change its record id.
domain_id: Domain UUID (e.g., 'd1234567-89ab-cdef-0123-456789abcdef')
record_id: DNS record UUID to update
type: DNS record type ('A', 'AAAA', 'CNAME', 'MX', 'TXT', etc.)
name: Subdomain or record name (e.g., 'www' for www.yourdomain.com)
value: New record value (e.g., IP address for A records)
ttl: Time To Live in seconds (default: 3600)

Inputs: domain_id (required), record_id (required), type, name, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity. For example, 'create_dns', 'update_dns', and 'delete_dns' handle different DNS operations, while 'domains' lists domains and 'search' checks availability. The 'claim_account' tool is separate for account management, and contact information tools are distinct from domain operations.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun or noun pattern (e.g., 'create_dns', 'delete_dns', 'dns_records', 'domains', 'search'). Minor deviations include 'get_contact_information' and 'get_purchase_offers' using 'get_' prefix, and 'set_contact_information' using 'set_', but these are still readable and logical.

    Tool Count5/5

    With 10 tools, the count is well-scoped for domain management. It covers core workflows like domain search, purchase, DNS management, and account/contact setup without being overwhelming. Each tool serves a specific, necessary function in the domain lifecycle.

    Completeness5/5

    The tool set provides complete coverage for domain management. It includes domain search, purchase offers, DNS CRUD operations (create, read, update, delete), domain listing, and account/contact setup. There are no obvious gaps; agents can handle the full lifecycle from search to DNS configuration.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches