mcp-server-isitdown

An MCP server that checks if a website is currently down by querying www.isitdownrightnow.com.

Overview

This MCP server provides a simple tool to check if a website is experiencing downtime, and can provide some information about recent downtime events.

Tools

The following tools are implemented:

get_website_status: Checks if a website is currently down or not.
- Input: root_domain (string): The root domain of the website to check (e.g., "example.com")
- Output: A string message indicating whether the website is up or down, with the last recorded downtime information

Installation

Note: This package is not currently published to a public registry. Installation is only available from source.

From Source

# Clone the repository 
git clone https://github.com/yourusername/mcp-server-isitdown.git
cd mcp-server-isitdown

# Using uv (recommended)
uv pip install -e .

# Using pip
pip install -e .

Configuration for Claude Desktop

Add this configuration to your claude_desktop_config.json file:

"isitdown": {
  "command": "/path/to/uv",
  "args": [
    "--directory",
    "/path/to/cloned/repo/src",
    "run",
    "mcp_server_isitdown"
  ]
}

Usage

Run as a standalone MCP server

# Using the installed script
mcp-server-isitdown

# Using the Python module
python -m mcp_server_isitdown

Example usage with Claude for Dekstop:

"Is wikipedia down right now?"
"When was the last time reddit was down?"

Use as a library

from mcp_server_isitdown.server import get_website_status

# Check if a website is down (async function)
async def check_website():
    result = await get_website_status("example.com")
    print(result)  # Prints status message with up/down status

Development

# Type checking
uvx mypy .

# Run all pre-commit hooks
uv pre-commit run --all-files

# Install in development mode
uv pip install -e ".[dev]"

# Run the Inspector
mcp dev src/mcp_server_isitdown/server.py

Build

# Build the package
uv build

# Install the built package
uv pip install dist/mcp_isitdown_service-*.whl

License

MIT

IsItDown MCP Server