IsItDown MCP Server

# mcp-server-isitdown An MCP server that checks if a website is currently down by querying [www.isitdownrightnow.com](https://www.isitdownrightnow.com). <a href="https://glama.ai/mcp/servers/1wx4z4amkm"> <img width="380" height="200" src="https://glama.ai/mcp/servers/1wx4z4amkm/badge" alt="IsItDown Server MCP server" /> </a> ## 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 ```bash # 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: ```json "isitdown": { "command": "/path/to/uv", "args": [ "--directory", "/path/to/cloned/repo/src", "run", "mcp_server_isitdown" ] } ``` ## Usage ### Run as a standalone MCP server ```bash # 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 ```python 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 ```bash # 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 ```bash # Build the package uv build # Install the built package uv pip install dist/mcp_isitdown_service-*.whl ``` ## License MIT