Available Tools
The Statly MCP (Model Context Protocol) server provides 25+ tools for managing your observability platform. These tools enable AI assistants to interact with uptime monitors, error tracking (Observe), incidents, maintenance windows, and public status pages. Tools are organized by category.
Documentation Tools
These tools are always available without authentication. Rate limited to 100 req/min per IP.
search_docs
Search Statly documentation for a topic.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query |
Example prompts:
- "Search Statly docs for Express integration"
- "Find documentation about webhook configuration"
get_sdk_reference
Get SDK API reference for a specific language.
| Parameter | Type | Required | Description |
|---|---|---|---|
language | string | Yes | javascript, python, or go |
Example prompts:
- "Show me the Python SDK reference"
- "What methods are available in the Go SDK?"
get_code_example
Get code examples for a specific use case.
| Parameter | Type | Required | Description |
|---|---|---|---|
language | string | Yes | javascript, python, or go |
topic | string | Yes | installation, init, capture_error, user_context, breadcrumbs |
Example prompts:
- "Show me how to install the JavaScript SDK"
- "Get a Python example for capturing errors"
get_api_reference
Get REST API reference documentation.
| Parameter | Type | Required | Description |
|---|---|---|---|
section | string | No | Specific API section |
Example prompts:
- "Show me the Statly API reference"
- "What endpoints are available for monitors?"
Monitor Tools
Manage uptime monitors. Requires authentication.
monitors/list
List all monitors for your organization.
| Parameter | Type | Required | Description |
|---|---|---|---|
active | boolean | No | Filter by active status |
status | string | No | Filter by status: operational, degraded, partial_outage, major_outage |
Example prompts:
- "List all my monitors"
- "Show me monitors that are currently down"
monitors/get
Get detailed information about a specific monitor.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Monitor ID |
Example prompts:
- "Get details for monitor mon_abc123"
- "Show me the production API monitor"
monitors/create
Create a new uptime monitor.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name |
url | string | Yes | URL to monitor |
method | string | No | HTTP method (default: GET) |
frequency | number | No | Check interval in seconds (60, 180, 300) |
timeout | number | No | Timeout in milliseconds |
expectedStatus | number | No | Expected HTTP status code |
headers | object | No | Custom request headers |
Example prompts:
- "Create a monitor for https://api.example.com/health (opens in a new tab)"
- "Add a POST monitor for the webhook endpoint with a 5-second timeout"
monitors/update
Update an existing monitor.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Monitor ID |
name | string | No | New display name |
url | string | No | New URL |
method | string | No | New HTTP method |
frequency | number | No | New check interval |
timeout | number | No | New timeout |
active | boolean | No | Enable/disable monitor |
Example prompts:
- "Update the API monitor URL to https://api-v2.example.com (opens in a new tab)"
- "Change the check frequency to every 3 minutes"
monitors/delete
Delete a monitor.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Monitor ID |
Example prompts:
- "Delete the staging API monitor"
- "Remove monitor mon_xyz789"
monitors/pause
Pause or resume a monitor.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Monitor ID |
paused | boolean | Yes | true to pause, false to resume |
Example prompts:
- "Pause the production monitor during maintenance"
- "Resume all paused monitors"
Incident Tools
Manage incidents and communicate status. Requires authentication.
incidents/list
List incidents for your organization.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter: investigating, identified, monitoring, resolved |
severity | string | No | Filter: minor, major, critical |
limit | number | No | Max results (default: 20) |
Example prompts:
- "Show all open incidents"
- "List critical incidents from today"
incidents/get
Get incident details with updates.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Incident ID |
Example prompts:
- "Show details for incident inc_abc123"
- "What's the latest on the database incident?"
incidents/create
Create a new incident.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Incident title |
description | string | No | Initial description |
status | string | No | Initial status (default: investigating) |
severity | string | No | Severity level (default: major) |
affectedMonitors | string[] | No | List of affected monitor IDs |
Example prompts:
- "Create an incident: Payment processing is failing"
- "Report a critical outage affecting the API and database"
incidents/update
Update incident status.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Incident ID |
status | string | No | New status |
message | string | No | Status update message |
Example prompts:
- "Update the incident: We've identified the cause as a database connection pool issue"
- "Mark the incident as monitoring"
incidents/resolve
Resolve an incident.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Incident ID |
message | string | No | Resolution message |
Example prompts:
- "Resolve the payment incident with message: Issue fixed by scaling up database connections"
- "Close all resolved incidents"
incidents/add_update
Add an update to an existing incident.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Incident ID |
message | string | Yes | Update message |
status | string | No | Optionally change status |
Example prompts:
- "Add update to incident: Engineering team is investigating"
- "Post an update that we're deploying a fix"
Maintenance Tools
Schedule and manage maintenance windows. Requires authentication.
maintenance/list
List maintenance windows.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter: scheduled, in_progress, completed |
Example prompts:
- "Show upcoming maintenance windows"
- "List all scheduled maintenance"
maintenance/get
Get maintenance window details.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Maintenance ID |
maintenance/create
Schedule a maintenance window.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Maintenance title |
description | string | No | Description of work |
startTime | string | Yes | ISO 8601 start time |
endTime | string | Yes | ISO 8601 end time |
affectedMonitors | string[] | No | Affected monitor IDs |
autoNotify | boolean | No | Auto-notify subscribers |
Example prompts:
- "Schedule maintenance for tomorrow at 2 AM for 2 hours"
- "Create a maintenance window for database migration next Saturday"
maintenance/update
Update a maintenance window.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Maintenance ID |
title | string | No | New title |
startTime | string | No | New start time |
endTime | string | No | New end time |
status | string | No | New status |
maintenance/delete
Cancel a scheduled maintenance.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Maintenance ID |
Example prompts:
- "Cancel the maintenance scheduled for tonight"
- "Delete maintenance window maint_abc123"
Status Tools
Query current system status. Requires authentication for detailed data.
status/summary
Get current status summary for your organization.
Returns overall status, active incidents, and component health.
Example prompts:
- "What's our current status?"
- "Give me a status summary"
status/components
List all status page components and their status.
Example prompts:
- "Show me all status page components"
- "Which components are degraded?"
status/history
Get historical uptime data.
| Parameter | Type | Required | Description |
|---|---|---|---|
days | number | No | Number of days (default: 30) |
Example prompts:
- "Show uptime history for the past week"
- "What was our uptime last month?"
Subscriber Tools
Manage status page subscribers. Requires authentication.
subscribers/list
List all subscribers.
| Parameter | Type | Required | Description |
|---|---|---|---|
verified | boolean | No | Filter by verification status |
subscribers/add
Add a new subscriber.
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Subscriber email |
notifyIncidents | boolean | No | Notify about incidents |
notifyMaintenance | boolean | No | Notify about maintenance |
subscribers/remove
Remove a subscriber.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Subscriber ID |
Integration Tools
Manage notification integrations. Requires authentication.
integrations/list
List configured integrations.
integrations/create
Create a new integration.
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Yes | slack, discord, pagerduty, webhook, teams, opsgenie |
name | string | Yes | Display name |
config | object | Yes | Integration-specific configuration |
integrations/update
Update an integration.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Integration ID |
name | string | No | New name |
config | object | No | New configuration |
enabled | boolean | No | Enable/disable |
integrations/delete
Delete an integration.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Integration ID |
integrations/test
Test an integration by sending a test notification.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Integration ID |
Example prompts:
- "Test the Slack integration"
- "Send a test message to our Discord channel"