Downloads

This page provides different ways to obtain the mcp-whoisxmlapi server.

The easiest way to use mcp-whoisxmlapi is via Docker. We provide multiple tags to suit different needs:

# Recommended: Use major version for automatic updates
docker pull whoisxmlapidotcom/mcp-whoisxmlapi:v1

# Alternative: Always latest (includes breaking changes)
docker pull whoisxmlapidotcom/mcp-whoisxmlapi:latest

# Specific version (no automatic updates)
docker pull whoisxmlapidotcom/mcp-whoisxmlapi:v1.0.0

You need Docker

You need to have Docker installed on your machine to use the Docker image.

Available Tags

  • :latest - Always the newest release (may include breaking changes)
  • :v1 (or :v2, :v3) - Latest patch/minor version within a major version
  • :v1.0.0 - Specific version tag for reproducible builds

We recommend using the major version tag (e.g., :v1) because:

  • ✅ Automatically receives bug fixes and new features
  • ✅ No breaking changes within the same major version
  • ✅ Balances stability with improvements
  • ✅ Easy to update when you're ready

Updating Your Docker Image

To get the latest updates for your major version:

# Pull the latest v1.x.x release
docker pull whoisxmlapidotcom/mcp-whoisxmlapi:v1

Run this command periodically to ensure you have the latest improvements and security updates.

Benefits of Docker

  • ✅ Always up-to-date
  • ✅ No manual downloads required
  • ✅ Multi-platform support
  • ✅ No dependencies to install
  • ✅ Isolated and secure execution

See the Docker guide for complete setup instructions.

npx

Install via npx for convenience:

# Install globally
npx -y @whoisxmlapidotcom/mcp-whoisxmlapi

# Or install locally in your project
npx -y @whoisxmlapidotcom/mcp-whoisxmlapi

You need Node.js

You need to have Node.js installed on your machine to use the npx package.

Benefits of npx Installation

  • ✅ Automatic platform detection (Linux, macOS, Windows)
  • ✅ Automatic architecture detection (x86_64, ARM64)
  • ✅ Easy updates with npx -y @whoisxmlapidotcom/mcp-whoisxmlapi
  • ✅ No manual downloads required
  • ✅ Integrates with existing Node.js workflows

Usage After npx Installation

After installing via npx, you can use the binary directly:

npx @whoisxmlapidotcom/mcp-whoisxmlapi --version

Binary Downloads

Download the appropriate archive for your platform. The latest version is featured prominently below, with all previous versions maintained for compatibility.

Info

Binary downloads are not available in this build. Use the Docker image instead.

Installation Notes

Linux

  1. Download the appropriate .tar.gz file for your platform
  2. Extract the archive: tar -xzf mcp-whoisxmlapi_*_linux_*.tar.gz
  3. Make it executable: chmod +x mcp-whoisxmlapi
  4. Optionally move to PATH: sudo mv mcp-whoisxmlapi /usr/local/bin/

macOS

  1. Download the appropriate .tar.gz file for your platform (Intel or Apple Silicon)
  2. Extract the archive: tar -xzf mcp-whoisxmlapi_*_darwin_*.tar.gz
  3. Make it executable: chmod +x mcp-whoisxmlapi
  4. Handle macOS Quarantine (see Troubleshooting - macOS Quarantine Issues)
  5. Optionally move to PATH: sudo mv mcp-whoisxmlapi /usr/local/bin/

Windows

  1. Download the appropriate .zip file for your platform
  2. Extract the archive (right-click → "Extract All" or use a tool like 7-Zip)
  3. Place the mcp-whoisxmlapi.exe file in a directory in your PATH, or run from current directory

General Verification

After installation on any platform, test the installation:

# Check version (works without API token)
./mcp-whoisxmlapi --version

# Set your API token for testing
export WHOISXMLAPI_TOKEN="your-token-here"

# Test MCP communication (this will fail gracefully without MCP client)
./mcp-whoisxmlapi

No output is normal

The binary might show no output if you run it like this since it will be waiting for requests to come in from an AI tool or MCP client. This is normal. Unless you see an error, not receiving any output is a good signal.

Last Updated: