- Home
- MCP servers
- IsItDown
IsItDown
- python
2
GitHub Stars
python
Language
4 months ago
First Indexed
3 weeks ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"hesreallyhim-mcp-server-isitdown": {
"command": "uv",
"args": [
"--directory",
"/path/to/cloned/repo/src",
"run",
"mcp_server_isitdown"
]
}
}
}You can run a lightweight MCP Server that checks whether a website is currently down by querying isitdownrightnow and returns a concise status message along with recent downtime info. This makes it easy to integrate uptime checks into your Claude Desktop workflows or other MCP clients.
How to use
Use this MCP server with your MCP client to ask about a website’s current status. You supply the root domain (for example, example.com) and you receive a clear message indicating whether the site is up or down, plus context about the most recent downtime events. You can also invoke it directly as a standalone service or call it from Python as a library function to programmatically retrieve status information.
How to install
Prerequisites you need on your system:
- Python (and its package tools) installed
- uv (the MCP runner) available on your path
- Git for cloning repositories (recommended)
# 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 .
Claude Desktop configuration
To run the server from Claude Desktop, add this configuration to your Claude Desktop setup.
"isitdown": {
"command": "/path/to/uv",
"args": [
"--directory",
"/path/to/cloned/repo/src",
"run",
"mcp_server_isitdown"
]
}
Usage examples
Standalone usage from the command line:
- Run the MCP server directly with the installed script
- Or run it via the Python module if you prefer that startup method.
Usage as a library
You can call the server function from Python to check a website’s status programmatically.
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
Available tools
get_website_status
Checks if a website is currently down and returns a status message with the last recorded downtime information.