Statuser — Claude Code MCP server: features and setup
Connect an AI assistant to Statuser to check services, handle incidents, and update status pages. An account API key is required.
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/mcpWhat Statuser 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.
What it helps with
- 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 for the agent
- 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.
How to install Statuser
1Platform CLI
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/mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http statuser https://mcp.statuser.cloud1Platform CLI: remote server
codex mcp add statuser --url https://mcp.statuser.cloud2Platform CLI
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/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"statuser": {
"url": "https://mcp.statuser.cloud"
}
}
}{
"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
Config file
{
"servers": {
"statuser": {
"type": "http",
"url": "https://mcp.statuser.cloud"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http statuser https://mcp.statuser.cloud2Platform CLI
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/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Statuser
How do I install Statuser in Claude Code?
For a local setup, run claude mcp add mcp -e STATUSER_API_KEY=<STATUSER_API_KEY> -- npx -y @statuser/mcp. This option requires Node.js 18.17 or newer.
What does Statuser do?
It connects an assistant to Statuser for service monitoring, incident work, status page updates, and notification management.
Can I connect to Statuser with OAuth?
OAuth-only clients that cannot send a custom API key in a header cannot connect. Remote access uses an API key.
