Domain Monitoring for AI Agents (MCP Server)
An MCP server that gives Claude and other AI agents direct tools for WHOIS/RDAP lookups, domain monitoring, and alerts, authenticated with your shadom.co API key.
Install
Claude Code (one command)
claude mcp add shadom -e SHADOM_API_KEY=sk_your_key_here -- npx -y @shadom.co/mcpClaude Desktop
Add this 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"
}
}
}
}Generate an API key from the API Key page in your dashboard, then swap it in for sk_your_key_here above.
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
8 tools, all scoped to the account that owns the API key.
| 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 plus latest WHOIS snapshot |
| list_alerts | List alerts with optional type/unread filters |
| mark_alerts_read | Mark all alerts as read |
More ways to integrate
Building a script instead of talking to an agent? The shadom.co REST API exposes the same domain data over HTTP with Bearer token auth. For the full endpoint reference, see the in-app API documentation.
View the REST APIFrequently asked questions
What is the shadom.co MCP server?
It is a Model Context Protocol server that gives AI assistants like Claude direct tools to run WHOIS lookups, check domain availability, and manage your monitored domains and alerts, instead of you copy-pasting results between a browser and a chat window.
How do I install it in Claude Code?
Run one command: claude mcp add shadom -e SHADOM_API_KEY=sk_your_key_here -- npx -y @shadom.co/mcp. Replace the placeholder with a real API key from your dashboard and the server is available in that session.
Does it work with Claude Desktop and other MCP clients?
Yes. Any MCP client that supports stdio servers can run it via npx @shadom.co/mcp with the SHADOM_API_KEY environment variable set. See the Claude Desktop config example below for the JSON shape.
Do I need a paid plan to use the MCP server?
No. The MCP server uses the same free API key as the REST API, which covers up to 100 monitored domains with no credit card required.