Sherlock Domains MCP
Enables publishing the MCP server package to PyPI for distribution, with support for authentication via token or username/password.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sherlock Domains MCP add a note about domain renewal dates"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
Sync dependencies and update lockfile:
uv syncBuild package distributions:
uv buildThis will create source and wheel distributions in the dist/ directory.
Publish to PyPI:
uv publishNote: You'll need to set PyPI credentials via environment variables or command flags:
Token:
--tokenorUV_PUBLISH_TOKENOr username/password:
--username/UV_PUBLISH_USERNAMEand--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-mcpUpon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
Available Tools
10 toolsclaim_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).
searchA
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
Inputs: q (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
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
Hosted X Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Official Porkbun MCP server: domains, DNS, SSL, hosting and Cloudflare via the Porkbun API.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Marketplace and infrastructure for MCP servers and skills: deploy, host, monetize, analytics.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that provides access to Jina AI's powerful web services (page reading, web search, fact checking) through Claude.328MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that allows Claude Code to interact with the OpenAI Codex CLI.40 npm20MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for managing DNS records and domains via the Namecheap API. Works with Claude.ai and other MCP clients.6 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for domainagent.dev, enabling AI agents to search, register, deploy, host, and manage domains with USDC payment on Base via x402. Supports static site deployment via Cloudflare Pages and DNS management.12 npmMIT