https://github.com/hesreallyhim/mcp-server-isitdown
An MCP server that checks if a website is currently down by querying the website https://www.isitdownrightnow.com
https://github.com/hesreallyhim/mcp-server-isitdown
isitdown mcp mcp-server
Last synced: 6 months ago
JSON representation
An MCP server that checks if a website is currently down by querying the website https://www.isitdownrightnow.com
- Host: GitHub
- URL: https://github.com/hesreallyhim/mcp-server-isitdown
- Owner: hesreallyhim
- License: mit
- Created: 2025-02-26T08:28:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-18T12:39:11.000Z (about 1 year ago)
- Last Synced: 2026-01-11T17:46:25.967Z (7 months ago)
- Topics: isitdown, mcp, mcp-server
- Language: Python
- Homepage:
- Size: 85.9 KB
- Stars: 1
- Watchers: 1
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **mcp-server-isitdown** - An MCP server that checks if a website is currently down by querying the website https://www.isitdownrightnow.com `python` `isitdown` `mcp` `mcp-server` `server` `pip install git+https://github.com/hesreallyhim/mcp-server-isitdown` (🤖 AI/ML)
- toolsdk-mcp-registry - ❌ isitdown - time availability information and last known downtime for monitoring and troubleshooting purposes. (python) (Monitoring / How to Submit)
- metorial-index - IsItDown Server - Checks the status of websites to determine if they are currently down and provides information on recent downtime events. (APIs and HTTP Requests)
README
[](https://mseep.ai/app/hesreallyhim-mcp-server-isitdown)
[](https://mseep.ai/app/24e83a9a-3b58-48c5-a490-04d6a631ed1e)
# mcp-server-isitdown
An MCP server that checks if a website is currently down by querying [www.isitdownrightnow.com](https://www.isitdownrightnow.com).
[](https://smithery.ai/server/@hesreallyhim/mcp-server-isitdown)
## 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
### Installing via Smithery
To install IsItDown Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hesreallyhim/mcp-server-isitdown):
```bash
npx -y @smithery/cli install @hesreallyhim/mcp-server-isitdown --client claude
```
> **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