# downdetector-mcp

MCP server for Downdetector - check service status and outage information. This server provides tools to query Downdetector for service outages and status updates across various services and regions.

https://github.com/user-attachments/assets/746b8535-f8b2-4ffa-828c-7b39fbf6650b

- **Real-time Service Status**: Get current status reports for any service monitored by Downdetector
- **No Authentication Required**: Direct access to public Downdetector data
- **Global Coverage**: Support for different Downdetector domains (com, uk, it, fr, etc.)

## Installation

Follow the instructions on [install-mcp](https://adamjones.me/install-mcp/?config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvd25kZXRlY3Rvci1tY3AiXSwibmFtZSI6ImRvd25kZXRlY3RvciJ9), which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

## Example Usage

Once configured, you can ask Claude things like:

- "Check if Steam is down right now"
- "What's the current status of Netflix?"
- "Get the latest reports for Instagram in the UK"
- "Show me the recent activity for Discord"

## Limitations

- Data comes from Downdetector's public interface and may be rate-limited
- Some domains (especially .com) may be protected by Cloudflare and could be intermittently unavailable
- Service names must match those used by Downdetector (case-insensitive)

## Available Tools

### `downdetector`
Get current status and outage reports for any service monitored by Downdetector.

**Parameters:**
- `serviceName` (required): Name of the service (e.g., "steam", "netflix", "twitter")
- `domain` (optional): Downdetector domain ("com", "uk", "it", "fr", etc.)

## Contributing

Pull requests are welcomed on GitHub! To get started:

1. Install Git and Node.js
2. Clone the repository
3. Install dependencies with `npm install`
4. Run `npm run test` to run tests
5. Build with `npm run build`

## Releases

Versions follow the [semantic versioning spec](https://semver.org/).

To release:

1. Use `npm version <major | minor | patch>` to bump the version
2. Run `git push --follow-tags` to push with tags
3. Wait for GitHub Actions to publish to the NPM registry.