shadom.co MCP Server

Model Context Protocol server for shadom.co — enables AI assistants to manage domains, run WHOIS lookups, and monitor alerts.

Quick Install

Claude Code (one command)

claude mcp add shadom -e SHADOM_API_KEY=sk_your_key_here -- npx -y @shadom.co/mcp

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "shadom": {
      "command": "npx",
      "args": ["-y", "@shadom.co/mcp"],
      "env": {
        "SHADOM_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Get your API key

Generate one from Settings > API Key in your shadom.co dashboard.

Environment Variables

| Variable | Required | Default | Description | |---|---|---|---| | SHADOM_API_KEY | Yes | — | API key from shadom.co settings | | SHADOM_BASE_URL | No | https://shadom.co | API base URL |

Available Tools

| Tool | Description | |---|---| | whois_lookup | WHOIS/RDAP lookup for any domain | | check_availability | Check if a domain is available for registration | | list_domains | List all monitored domains | | add_domain | Add a domain to monitoring | | remove_domain | Remove a monitored domain | | domain_details | Get domain details + latest WHOIS snapshot | | list_alerts | List alerts with optional type/unread filters | | mark_alerts_read | Mark all alerts as read |

API Reference

For full HTTP API documentation, see API.md.

Development

Run without building:

SHADOM_API_KEY=sk_... SHADOM_BASE_URL=http://localhost:3000 npm run dev