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_isitdownExample 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 statusDevelopment
# 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.pyBuild
# Build the package
uv build
# Install the built package
uv pip install dist/mcp_isitdown_service-*.whlLicense
MIT
