# Statuser

Connect an AI assistant to Statuser to check services, handle incidents, and update status pages. An account API key is required.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 24
- Author: statuser-cloud
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/statuser-cloud/mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/statuser

## What it does

The server lets an assistant work with Statuser service data: check current states and monitoring history, investigate incidents, update status pages, and manage notifications. Account and project settings are available too. Requests act as the API key’s owner, so plan limits still apply.

Choose the hosted Streamable HTTP endpoint or run the local server with `npx -y @statuser/mcp`. The local option requires Node.js 18.17 or newer. In Claude Code, setup passes the API key as an environment variable. OAuth-only clients cannot connect; changes through the hosted endpoint need confirmation in each call.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.statuser.cloud`
- Environment variables: `STATUSER_API_KEY`, `STATUSER_ALLOW_WRITE`, `STATUSER_TOOLSETS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env STATUSER_API_KEY=<STATUSER_API_KEY> --env STATUSER_ALLOW_WRITE=<STATUSER_ALLOW_WRITE> --env STATUSER_TOOLSETS=<STATUSER_TOOLSETS> --transport stdio statuser -- npx -y @statuser/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http statuser https://mcp.statuser.cloud
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add statuser --url https://mcp.statuser.cloud
```

2. **Platform CLI**
```bash
codex mcp add statuser --env STATUSER_API_KEY=<STATUSER_API_KEY> --env STATUSER_ALLOW_WRITE=<STATUSER_ALLOW_WRITE> --env STATUSER_TOOLSETS=<STATUSER_TOOLSETS> -- npx -y @statuser/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "statuser": {
            "url": "https://mcp.statuser.cloud"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "statuser": {
            "command": "npx",
            "args": [
                "-y",
                "@statuser/mcp"
            ],
            "env": {
                "STATUSER_API_KEY": "<STATUSER_API_KEY>",
                "STATUSER_ALLOW_WRITE": "<STATUSER_ALLOW_WRITE>",
                "STATUSER_TOOLSETS": "<STATUSER_TOOLSETS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "statuser": {
            "type": "http",
            "url": "https://mcp.statuser.cloud"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "statuser": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@statuser/mcp"
            ],
            "env": {
                "STATUSER_API_KEY": "<STATUSER_API_KEY>",
                "STATUSER_ALLOW_WRITE": "<STATUSER_ALLOW_WRITE>",
                "STATUSER_TOOLSETS": "<STATUSER_TOOLSETS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http statuser https://mcp.statuser.cloud
```

2. **Platform CLI**
```bash
gemini mcp add -e STATUSER_API_KEY=<STATUSER_API_KEY> -e STATUSER_ALLOW_WRITE=<STATUSER_ALLOW_WRITE> -e STATUSER_TOOLSETS=<STATUSER_TOOLSETS> statuser npx -y @statuser/mcp
```
Replace <…> with your own values

## When to use it
- check the current state of monitored services
- inspect an incident and review its diagnostics
- post an update to a status page
- configure notification rules for subscriber channels
- review DNS change history

## Example prompts
- Check the Statuser service states and show their monitoring history.
- Investigate the latest incident and prepare a report on its timings.
- Post an update about planned maintenance to the status page.

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23643
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17160
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12109

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md