# WhoisXML API MCP Server

> The official Model Context Protocol (MCP) server for WhoisXML API. It gives AI agents (Claude,
> Cursor, VS Code, ChatGPT, and any MCP-compatible client) 35 first-party tools for WHOIS, DNS,
> IP geolocation, threat intelligence, typosquatting, email verification, and bulk
> processing.

Key facts:
- Package (npm): `@whoisxmlapidotcom/mcp-whoisxmlapi`
- Docker image: `whoisxmlapidotcom/mcp-whoisxmlapi`
- Hosted endpoint (Streamable HTTP + OAuth 2.1): https://mcp-hosted.whoisxmlapi.com/mcp
- MCP Registry name: `io.github.whois-api-llc/mcp-whoisxmlapi`
- Repo: https://github.com/whoisxmlapi/mcp-whoisxmlapi
- License: Apache-2.0 (server). Requires a WhoisXML API key (free tier available).

Why this server (differentiators):
- First-party WhoisXML data, not scraped aggregation — stable schemas.
- Bulk: `bulk_whois`, `bulk_dns_lookup`, `bulk_ip_geolocation` accept arrays (no client-side fan-out).
- Historical telemetry: `whois_history`, `dns_history`.
- 35 tools under one auth.

## Docs
- [Full reference for LLMs](https://mcp.whoisxmlapi.com/llms-full.txt): this overview at full length in one plain-text file, with every tool, example agent workflows and install instructions
- [Quick start](https://mcp.whoisxmlapi.com/quickstart): connect Claude Desktop, Claude Code, Gemini CLI, Codex or ChatGPT Desktop to the hosted server, with nothing to install
- [Installation](https://mcp.whoisxmlapi.com/installation): run the server yourself with Docker, npm or a downloaded binary, with a comparison of the three
- [Install guide for AI agents](https://mcp.whoisxmlapi.com/llms-install.md): install instructions written for AI agents that set up MCP servers, such as Cline
- [Tools reference](https://mcp.whoisxmlapi.com/tools): all 35 tools, each with what it does and its arguments
- [Configuration](https://mcp.whoisxmlapi.com/configuration): command-line flags and environment variables, with examples
- [HTTP mode](https://mcp.whoisxmlapi.com/http-mode): run the server over Streamable HTTP for remote clients and tools such as n8n, or use the hosted endpoint, which needs nothing deployed

## AI client setup
- [Claude Desktop](https://mcp.whoisxmlapi.com/claude-desktop): install the one-file Claude Desktop bundle, or add the server to Claude Desktop's config file by hand
- [Claude Code](https://mcp.whoisxmlapi.com/claude-code): add the server with `claude mcp add`, run through npx, Docker or the binary
- [Cursor](https://mcp.whoisxmlapi.com/cursor): one-click install, or add the server to Cursor's `mcp.json` by hand
- [Gemini](https://mcp.whoisxmlapi.com/gemini): install Gemini CLI and add the server to its `settings.json`

## Install commands
- npm: `npx -y @whoisxmlapidotcom/mcp-whoisxmlapi`
- Docker: `docker run --rm -e WHOISXMLAPI_TOKEN=your-token whoisxmlapidotcom/mcp-whoisxmlapi:latest`
- Environment variable required: `WHOISXMLAPI_TOKEN` (get a key at https://whoisxmlapi.com)