instatus-mcp

MCP (Model Context Protocol) server for Instatus - manage status pages, incidents, components, and more via Claude Code or any MCP-compatible client.

Features

• Status Pages: Create, list, update, and delete status pages
• Components: Manage service components and their statuses
• Incidents: Create and manage incidents with status updates
• Maintenances: Schedule and manage planned maintenance windows
• Subscribers: Manage email subscribers for status updates
• Metrics: Track and visualize custom metrics with datapoints
• Teammates: Manage team member access to status pages

Installation

npm install -g instatus-mcp

Or run directly with npx:

npx instatus-mcp

Configuration

Set your Instatus API key as an environment variable:

export INSTATUS_API_KEY="your-api-key-here"

You can get your API key from Instatus User Settings > Developer Settings.

Claude Code Configuration

Add to your Claude Code MCP settings (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "instatus": {
      "command": "npx",
      "args": ["instatus-mcp"],
      "env": {
        "INSTATUS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

User Profile

| Tool | Description | |------|-------------| | instatus_get_user_profile | Get the authenticated user's profile |

Status Pages

| Tool | Description | |------|-------------| | instatus_list_status_pages | List all status pages | | instatus_create_status_page | Create a new status page | | instatus_update_status_page | Update an existing status page | | instatus_delete_status_page | Delete a status page |

Components

| Tool | Description | |------|-------------| | instatus_list_components | List all components for a status page | | instatus_get_component | Get a specific component | | instatus_create_component | Create a new component | | instatus_update_component | Update an existing component | | instatus_delete_component | Delete a component |

Incidents

| Tool | Description | |------|-------------| | instatus_list_incidents | List all incidents for a status page | | instatus_get_incident | Get a specific incident | | instatus_create_incident | Create a new incident | | instatus_create_incident_from_template | Create an incident from a template | | instatus_update_incident | Update an existing incident | | instatus_delete_incident | Delete an incident |

Maintenances

| Tool | Description | |------|-------------| | instatus_list_maintenances | List all scheduled maintenances | | instatus_get_maintenance | Get a specific maintenance | | instatus_create_maintenance | Create a scheduled maintenance | | instatus_update_maintenance | Update a scheduled maintenance | | instatus_delete_maintenance | Delete a scheduled maintenance |

Subscribers

| Tool | Description | |------|-------------| | instatus_list_subscribers | List all subscribers | | instatus_add_subscriber | Add a new subscriber | | instatus_remove_subscriber | Remove a subscriber |

Metrics

| Tool | Description | |------|-------------| | instatus_list_metrics | List all metrics | | instatus_get_metric | Get a specific metric with data | | instatus_create_metric | Create a new metric | | instatus_update_metric | Update a metric | | instatus_delete_metric | Delete a metric | | instatus_add_metric_datapoint | Add a single datapoint | | instatus_add_metric_datapoints | Add multiple datapoints | | instatus_delete_metric_datapoints | Delete all datapoints from a metric |

Teammates

| Tool | Description | |------|-------------| | instatus_list_teammates | List all team members | | instatus_add_teammate | Add a team member | | instatus_remove_teammate | Remove a team member |

Component Status Values

• OPERATIONAL - Component is functioning normally
• UNDERMAINTENANCE - Component is under maintenance
• DEGRADEDPERFORMANCE - Component has degraded performance
• PARTIALOUTAGE - Component has partial outage
• MAJOROUTAGE - Component has major outage

Incident Status Values

• INVESTIGATING - Investigating the issue
• IDENTIFIED - Issue has been identified
• MONITORING - Monitoring the fix
• RESOLVED - Issue has been resolved

Maintenance Status Values

• NOTSTARTEDYET - Maintenance hasn't started
• INPROGRESS - Maintenance is in progress
• COMPLETED - Maintenance is complete

Development

# Clone the repository
git clone https://github.com/TechnicalRhino/instatus-mcp.git
cd instatus-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

License

MIT