Manage the uptime monitoring, incidents and status pages of your Phare organization, with the permissions of your role.
Call whoami first: it returns your role, permissions and the projects you can access.
Everything but projects, users and integrations belongs to a project: pass the ID of one of your projects as project_id.
Discoverability
2/6 passed2 of 6 passed33/100
Client listings and public setup information.
mcp.json or server-card.json
Either mcp.json or an MCP Server Card declaring this endpoint passes.
The MCP Server Card declares this server's exact endpoint.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Get your user, role, organization, permissions and the projects you can access. Call it first: most tools act on one of these projects through their project_id argument, and your permissions decide which tools you can use.
The description explains the capability, when to use it, and what to expect.
Inputs100/100
This tool declares no inputs, so argument descriptions are not needed.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description82/100
Get a paginated list of the users of the organization, newest first. Filter them by email address to find the user IDs used by the project members and the email and SMS recipients.
Describe the returned information so the agent knows whether it will answer the request.
Inputs75/100
Explain the meaning of this value, not just its name.
email
Filter users by email. Can be specified multiple times to filter by multiple email addresses.
Clear enough to supply this argument.
page
Page number to show
Explain the meaning of this value, not just its name.
per_page
Number of resources to return per page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description79/100
Get a paginated list of the integrations of an app, newest first. Filter them by name. Integrations belong to the organization and deliver the notifications of the alert rules.
Describe the returned information so the agent knows whether it will answer the request.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
app
The app key to filter integrations
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
name
Filter integrations by name. Can be specified multiple times to filter by multiple names.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page
Page number to show
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
per_page
Number of resources to return per page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description77/100
Create an integration of an app for the whole organization, then used by alert rules to deliver their notifications. The apps connected from the dashboard, like Slack, Discord and Telegram, cannot be created this way, and the SMS app requires a Scale plan subscription.
The description explains the capability, when to use it, and what to expect.
Inputs69/100
Explain the meaning of this value, not just its name.
app
The app key
Explain the meaning of this value, not just its name.
name
Integration name
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
settings › anyOf › 1 › members
IDs of the organization members receiving the alerts
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
settings › anyOf › 2 › integration_key
ilert alert source integration key
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
settings › anyOf › 3 › hostname
Hostname of the Ntfy server
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
settings › anyOf › 3 › topic
Ntfy topic receiving the alerts
Clear enough to supply this argument.
settings › anyOf › 3 › access_token
Ntfy access token used for authenticated topics, must start with `tk_`
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
settings › anyOf › 4 › url
URL receiving the webhook requests
Clear enough to supply this argument.
settings › anyOf › 4 › secret
Secret used to sign the webhook requests
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
settings › anyOf › 5 › user_key
Pushover user or group key
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
settings › anyOf › 5 › api_key
Pushover application API token
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
settings › anyOf › 6 › members
IDs of the organization members receiving the alerts
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Get a paginated list of the projects you can access, newest first, with the IDs of their members. Most tools act on one of them through their project_id argument.
The description explains the capability, when to use it, and what to expect.
Inputs87/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page
Page number to show
Clear enough to supply this argument.
per_page
Number of resources to return per page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Delete a project by ID with everything it contains: monitors with their incidents and check history, maintenance windows, status pages with their custom domain certificates, project alert rules and API keys. This cannot be undone, and the last project of an organization cannot be deleted.
The description explains the capability, when to use it, and what to expect.
Inputs50/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to delete
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "delete_project",
"title": "Delete a project",
"description": "Delete a project by ID with everything it contains: monitors with their incidents and check history, maintenance windows, status pages with their custom domain certificates, project alert rules and API keys. This cannot be undone, and the last project of an organization cannot be deleted.",
"inputSchema": {
"type": "object",
"required": [
"project_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to delete"
}
}
},
"annotations": {
"title": "Delete a project",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description83/100
Get a paginated list of the alert rules notifying an integration when an event happens in the project: the project alert rules first, then the organization-wide ones.
The description explains the capability, when to use it, and what to expect.
Inputs67/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
page
Page number to show
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
per_page
Number of resources to return per page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description78/100
Create an alert rule notifying an integration each time an event happens in the project, or in every project with the `organization` scope. The app of the integration must support the event.
The description explains the capability, when to use it, and what to expect.
Inputs73/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
scope
Scope of the alert rule, `organization` to execute it for the events of every project or `project` to only execute it for the events of the current project
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
event
Name of the event that will trigger the execution of the alert rule
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
integration_id
The ID of the integration used to send a notification when the alert rule is executed
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
rate_limit
Minimum time in minutes between two executions of the alert rule, used to minimize the number of alerts received.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
event_settings › anyOf › 1 › type
Type of incident to notify about
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
event_settings › anyOf › 2 › days_before_expiry
Days to notify before the certificate expires
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
integration_settings › anyOf › 1 › priority
Notification priority level
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
integration_settings › anyOf › 2 › schema
JSON schema defining the webhook payload structure
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
integration_settings › anyOf › 3 › priority
Notification priority level
Clear enough to supply this argument.
integration_settings › anyOf › 3 › retry
Seconds between the repeats of an `emergency` priority notification until it is acknowledged. Required by the `emergency` priority, unused by the others.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
integration_settings › anyOf › 3 › expire
Seconds after which an unacknowledged `emergency` priority notification stops repeating. Required by the `emergency` priority, unused by the others.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description77/100
Update an alert rule by ID, the fields left out keep their current value. Changing its event or integration replaces their settings, send the settings of the new event or integration.
Explain mutations, irreversible effects, or prerequisites that matter before calling this tool.
Inputs85/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clear enough to supply this argument.
alert_rule_id
ID of the alert rule to update
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
scope
Scope of the alert rule, `organization` to execute it for the events of every project or `project` to only execute it for the events of the current project
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
event
Name of the event that will trigger the execution of the alert rule
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
integration_id
The ID of the integration used to send a notification when the alert rule is executed
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
rate_limit
Minimum time in minutes between two executions of the alert rule, used to minimize the number of alerts received.
Clear enough to supply this argument.
event_settings › anyOf › 1 › type
Type of incident to notify about
Clear enough to supply this argument.
event_settings › anyOf › 2 › days_before_expiry
Days to notify before the certificate expires
Clear enough to supply this argument.
integration_settings › anyOf › 1 › priority
Notification priority level
Explain the meaning of this value, not just its name.
integration_settings › anyOf › 2 › schema
JSON schema defining the webhook payload structure
Clear enough to supply this argument.
integration_settings › anyOf › 3 › priority
Notification priority level
Clear enough to supply this argument.
integration_settings › anyOf › 3 › retry
Seconds between the repeats of an `emergency` priority notification until it is acknowledged. Required by the `emergency` priority, unused by the others.
Clear enough to supply this argument.
integration_settings › anyOf › 3 › expire
Seconds after which an unacknowledged `emergency` priority notification stops repeating. Required by the `emergency` priority, unused by the others.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description88/100
Create an HTTP, TCP or ICMP monitor checking a service at a regular interval from 1 to 10 regions, it opens an incident once the failures are confirmed. The first check runs right away when the organization has monitoring events left in its quota, and the `uptime.monitor.created` alert rules are triggered.
Explain mutations, irreversible effects, or prerequisites that matter before calling this tool.
Inputs82/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
name
Monitor name
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
display_name
Public name of the monitor on status pages, defaults to the monitor name
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
protocol
Monitoring protocol
Clear enough to supply this argument.
request › oneOf › 0 › method
HTTP request method
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › url
HTTP request url
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › tls_skip_verify
Skip SSL verification
Clear enough to supply this argument.
request › oneOf › 0 › body
HTTP request body for POST, PUT and PATCH requests
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › follow_redirects
Follow redirects
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › user_agent_secret
A secret value to be used in the User-Agent header for authenticating the request
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › headers › items › name
Header name, the User-Agent, Signature, Signature-Input and Signature-Agent headers are not allowed
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › headers › items › value
Header value
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 1 › host
TCP request hostname or IP address
Clear enough to supply this argument.
request › oneOf › 1 › port
TCP request port, between 1 and 65535
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 1 › connection
Connection type for TCP protocol
Clear enough to supply this argument.
request › oneOf › 1 › tls_skip_verify
Skip TLS verification
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 2 › host
ICMP request hostname or IP address
Clear enough to supply this argument.
interval
Monitoring interval in seconds
Clear enough to supply this argument.
timeout
Monitoring timeout in milliseconds
Clear enough to supply this argument.
success_assertions › items › oneOf › 0 › type
Type of assertion, only one status code assertion is allowed
Clear enough to supply this argument.
success_assertions › items › oneOf › 0 › operator
Operator to use for the assertion
Clear enough to supply this argument.
success_assertions › items › oneOf › 0 › value
A comma-separated list of status code values, you can use x as a wildcard for any digit.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 1 › type
Type of assertion
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 1 › selector
The name of the header to assert
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 1 › operator
Operator to use for the assertion
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 1 › value
The value of the header to assert
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 2 › type
Type of assertion, not available for HEAD and OPTIONS requests
Clear enough to supply this argument.
success_assertions › items › oneOf › 2 › operator
Operator to use for the assertion
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 2 › value
A word or sentence to check in the response body
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
incident_confirmations
Number of uninterrupted failed checks required to create an incident
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
recovery_confirmations
Number of uninterrupted successful checks required to resolve an incident
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
region_threshold
Number of regions that must fail before an incident is confirmed, cannot exceed the number of selected regions
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
regions
List of regions where monitoring checks are performed
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
tags
Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description83/100
Update a monitor by ID, the fields left out keep their current value and the ones sent replace it entirely, like the whole `request` object. A check runs right away when the organization has monitoring events left in its quota, and the changes are logged in the timeline of its ongoing incidents.
Explain mutations, irreversible effects, or prerequisites that matter before calling this tool.
Inputs76/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
monitor_id
ID of the monitor to update
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
name
Monitor name
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
display_name
Public name of the monitor on status pages, defaults to the monitor name
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
protocol
Monitoring protocol
Explain the meaning of this value, not just its name.
request › oneOf › 0 › method
HTTP request method
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › url
HTTP request url
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › tls_skip_verify
Skip SSL verification
Clear enough to supply this argument.
request › oneOf › 0 › body
HTTP request body for POST, PUT and PATCH requests
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › follow_redirects
Follow redirects
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › user_agent_secret
A secret value to be used in the User-Agent header for authenticating the request
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › headers › items › name
Header name, the User-Agent, Signature, Signature-Input and Signature-Agent headers are not allowed
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 0 › headers › items › value
Header value
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 1 › host
TCP request hostname or IP address
Clear enough to supply this argument.
request › oneOf › 1 › port
TCP request port, between 1 and 65535
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 1 › connection
Connection type for TCP protocol
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 1 › tls_skip_verify
Skip TLS verification
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
request › oneOf › 2 › host
ICMP request hostname or IP address
Clear enough to supply this argument.
interval
Monitoring interval in seconds
Clear enough to supply this argument.
timeout
Monitoring timeout in milliseconds
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 0 › type
Type of assertion, only one status code assertion is allowed
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 0 › operator
Operator to use for the assertion
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 0 › value
A comma-separated list of status code values, you can use x as a wildcard for any digit.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 1 › type
Type of assertion
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 1 › selector
The name of the header to assert
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 1 › operator
Operator to use for the assertion
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 1 › value
The value of the header to assert
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 2 › type
Type of assertion, not available for HEAD and OPTIONS requests
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 2 › operator
Operator to use for the assertion
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
success_assertions › items › oneOf › 2 › value
A word or sentence to check in the response body
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
incident_confirmations
Number of uninterrupted failed checks required to create an incident
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
recovery_confirmations
Number of uninterrupted successful checks required to resolve an incident
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
region_threshold
Number of regions that must fail before an incident is confirmed, cannot exceed the number of selected regions
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
regions
List of regions where monitoring checks are performed
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
tags
Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "pause_monitor",
"title": "Pause a monitor",
"description": "Pause a monitor by ID, its checks stop until it is resumed. Its ongoing incidents stay open.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"monitor_id"
],
"properties": {
"monitor_id": {
"type": "integer",
"description": "ID of the monitor to pause"
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
}
}
},
"annotations": {
"title": "Pause a monitor",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "resume_monitor",
"title": "Resume a monitor",
"description": "Resume a paused monitor by ID, its checks start again and the next one runs right away when the last one is older than its interval.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"monitor_id"
],
"properties": {
"monitor_id": {
"type": "integer",
"description": "ID of the monitor to resume"
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
}
}
},
"annotations": {
"title": "Resume a monitor",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Delete a monitor by ID with its check history, its status page components, and the incidents and maintenance windows of this monitor only, the ones shared with other monitors are kept. This cannot be undone, and triggers the `uptime.monitor.deleted` alert rules.
The description explains the capability, when to use it, and what to expect.
Inputs74/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clear enough to supply this argument.
monitor_id
ID of the monitor to delete
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "delete_monitor",
"title": "Delete a monitor",
"description": "Delete a monitor by ID with its check history, its status page components, and the incidents and maintenance windows of this monitor only, the ones shared with other monitors are kept. This cannot be undone, and triggers the `uptime.monitor.deleted` alert rules.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"monitor_id"
],
"properties": {
"monitor_id": {
"type": "integer",
"description": "ID of the monitor to delete"
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
}
}
},
"annotations": {
"title": "Delete a monitor",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Get the availability, downtime, incident count, MTTR and MTBF of a monitor by ID, with its incidents, between two past dates up to 1 year apart, the last 30 days by default.
The description explains the capability, when to use it, and what to expect.
Inputs63/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
monitor_id
ID of the monitor to report on
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
from
Start of the reporting window, defaults to 30 days ago. Must be in the past, required when `to` is provided.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
to
End of the reporting window, defaults to now. Must be after `from` and not in the future, required when `from` is provided.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
12
],
"description": "Monitor ID"
},
"mtbf": {
"type": [
"integer",
"null"
],
"examples": [
43200
],
"description": "Mean time between failures (MTBF) for this monitor, in seconds"
},
"mttr": {
"type": [
"integer",
"null"
],
"examples": [
750
],
"description": "Mean time to recovery (MTTR) for this monitor, in seconds"
},
"name": {
"type": "string",
"examples": [
"Website"
],
"description": "Monitor name"
},
"downtime": {
"type": "integer",
"examples": [
1500
],
"description": "Total downtime for this monitor in seconds"
},
"incidents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
},
"description": "Incidents that affected this monitor in the selected range"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.944
],
"description": "Availability for this monitor in the selected range, as a percentage"
},
"incident_count": {
"type": "integer",
"examples": [
2
],
"description": "Number of incidents affecting this monitor in the selected range"
},
"highest_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"examples": [
"major_outage"
],
"description": "Highest impact level observed for this monitor in the selected range"
}
}
}
Original tool metadata
{
"name": "get_monitor_report",
"title": "Get a monitor report",
"description": "Get the availability, downtime, incident count, MTTR and MTBF of a monitor by ID, with its incidents, between two past dates up to 1 year apart, the last 30 days by default.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"monitor_id"
],
"properties": {
"to": {
"type": "string",
"format": "date-time",
"examples": [
"2026-04-30T23:59:59Z"
],
"description": "End of the reporting window, defaults to now. Must be after `from` and not in the future, required when `from` is provided."
},
"from": {
"type": "string",
"format": "date-time",
"examples": [
"2026-04-01T00:00:00Z"
],
"description": "Start of the reporting window, defaults to 30 days ago. Must be in the past, required when `to` is provided."
},
"monitor_id": {
"type": "integer",
"description": "ID of the monitor to report on"
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
12
],
"description": "Monitor ID"
},
"mtbf": {
"type": [
"integer",
"null"
],
"examples": [
43200
],
"description": "Mean time between failures (MTBF) for this monitor, in seconds"
},
"mttr": {
"type": [
"integer",
"null"
],
"examples": [
750
],
"description": "Mean time to recovery (MTTR) for this monitor, in seconds"
},
"name": {
"type": "string",
"examples": [
"Website"
],
"description": "Monitor name"
},
"downtime": {
"type": "integer",
"examples": [
1500
],
"description": "Total downtime for this monitor in seconds"
},
"incidents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
},
"description": "Incidents that affected this monitor in the selected range"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.944
],
"description": "Availability for this monitor in the selected range, as a percentage"
},
"incident_count": {
"type": "integer",
"examples": [
2
],
"description": "Number of incidents affecting this monitor in the selected range"
},
"highest_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"examples": [
"major_outage"
],
"description": "Highest impact level observed for this monitor in the selected range"
}
}
},
"annotations": {
"title": "Get a monitor report",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description92/100
Get the availability, downtime, incident count, MTTR and MTBF of every monitor of the project and their aggregates, between two past dates up to 1 year apart, the last 30 days by default.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
from
Start of the reporting window, defaults to 30 days ago. Must be in the past, required when `to` is provided.
Clear enough to supply this argument.
to
End of the reporting window, defaults to now. Must be after `from` and not in the future, required when `from` is provided.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"properties": {
"mtbf": {
"type": [
"number",
"null"
],
"format": "float",
"examples": [
43200
],
"description": "Mean time between failures (MTBF) average for monitors with downtime, in seconds"
},
"mttr": {
"type": [
"number",
"null"
],
"format": "float",
"examples": [
735
],
"description": "Mean time to recovery (MTTR) average for monitors with downtime, in seconds"
},
"downtime": {
"type": "integer",
"examples": [
2940
],
"description": "Total downtime across all monitors in seconds"
},
"monitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
12
],
"description": "Monitor ID"
},
"mtbf": {
"type": [
"integer",
"null"
],
"examples": [
43200
],
"description": "Mean time between failures (MTBF) for this monitor, in seconds"
},
"mttr": {
"type": [
"integer",
"null"
],
"examples": [
750
],
"description": "Mean time to recovery (MTTR) for this monitor, in seconds"
},
"name": {
"type": "string",
"examples": [
"Website"
],
"description": "Monitor name"
},
"downtime": {
"type": "integer",
"examples": [
1500
],
"description": "Total downtime for this monitor in seconds"
},
"incidents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
},
"description": "Incidents that affected this monitor in the selected range"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.944
],
"description": "Availability for this monitor in the selected range, as a percentage"
},
"incident_count": {
"type": "integer",
"examples": [
2
],
"description": "Number of incidents affecting this monitor in the selected range"
},
"highest_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"examples": [
"major_outage"
],
"description": "Highest impact level observed for this monitor in the selected range"
}
}
},
"description": "Per-monitor statistics for all monitors included in the report"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9634
],
"description": "Mean monitor availability across the selected range, as a percentage"
},
"report_end_at": {
"type": "string",
"format": "date-time",
"examples": [
"2026-04-30T23:59:59Z"
],
"description": "Effective end of the generated report window"
},
"report_start_at": {
"type": "string",
"format": "date-time",
"examples": [
"2026-04-01T00:00:00Z"
],
"description": "Effective start of the generated report window"
},
"max_availability": {
"type": "number",
"format": "float",
"examples": [
100
],
"description": "Highest monitor availability in the selected range, as a percentage"
},
"min_availability": {
"type": "number",
"format": "float",
"examples": [
99.9125
],
"description": "Lowest monitor availability in the selected range, as a percentage"
},
"highest_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"examples": [
"major_outage"
],
"description": "Highest impact level observed among incidents in the selected range"
}
}
}
Original tool metadata
{
"name": "get_report",
"title": "Get report",
"description": "Get the availability, downtime, incident count, MTTR and MTBF of every monitor of the project and their aggregates, between two past dates up to 1 year apart, the last 30 days by default.",
"inputSchema": {
"type": "object",
"required": [
"project_id"
],
"properties": {
"to": {
"type": "string",
"format": "date-time",
"examples": [
"2026-04-30T23:59:59Z"
],
"description": "End of the reporting window, defaults to now. Must be after `from` and not in the future, required when `from` is provided."
},
"from": {
"type": "string",
"format": "date-time",
"examples": [
"2026-04-01T00:00:00Z"
],
"description": "Start of the reporting window, defaults to 30 days ago. Must be in the past, required when `to` is provided."
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"mtbf": {
"type": [
"number",
"null"
],
"format": "float",
"examples": [
43200
],
"description": "Mean time between failures (MTBF) average for monitors with downtime, in seconds"
},
"mttr": {
"type": [
"number",
"null"
],
"format": "float",
"examples": [
735
],
"description": "Mean time to recovery (MTTR) average for monitors with downtime, in seconds"
},
"downtime": {
"type": "integer",
"examples": [
2940
],
"description": "Total downtime across all monitors in seconds"
},
"monitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
12
],
"description": "Monitor ID"
},
"mtbf": {
"type": [
"integer",
"null"
],
"examples": [
43200
],
"description": "Mean time between failures (MTBF) for this monitor, in seconds"
},
"mttr": {
"type": [
"integer",
"null"
],
"examples": [
750
],
"description": "Mean time to recovery (MTTR) for this monitor, in seconds"
},
"name": {
"type": "string",
"examples": [
"Website"
],
"description": "Monitor name"
},
"downtime": {
"type": "integer",
"examples": [
1500
],
"description": "Total downtime for this monitor in seconds"
},
"incidents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
},
"description": "Incidents that affected this monitor in the selected range"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.944
],
"description": "Availability for this monitor in the selected range, as a percentage"
},
"incident_count": {
"type": "integer",
"examples": [
2
],
"description": "Number of incidents affecting this monitor in the selected range"
},
"highest_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"examples": [
"major_outage"
],
"description": "Highest impact level observed for this monitor in the selected range"
}
}
},
"description": "Per-monitor statistics for all monitors included in the report"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9634
],
"description": "Mean monitor availability across the selected range, as a percentage"
},
"report_end_at": {
"type": "string",
"format": "date-time",
"examples": [
"2026-04-30T23:59:59Z"
],
"description": "Effective end of the generated report window"
},
"report_start_at": {
"type": "string",
"format": "date-time",
"examples": [
"2026-04-01T00:00:00Z"
],
"description": "Effective start of the generated report window"
},
"max_availability": {
"type": "number",
"format": "float",
"examples": [
100
],
"description": "Highest monitor availability in the selected range, as a percentage"
},
"min_availability": {
"type": "number",
"format": "float",
"examples": [
99.9125
],
"description": "Lowest monitor availability in the selected range, as a percentage"
},
"highest_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"examples": [
"major_outage"
],
"description": "Highest impact level observed among incidents in the selected range"
}
}
},
"annotations": {
"title": "Get report",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description82/100
Get a paginated list of the incidents of the project, newest first: the ones opened by failing monitors and the manual ones. Filter them by monitor or tag.
Describe the returned information so the agent knows whether it will answer the request.
Inputs82/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
monitor_id
Filter incidents by monitor ID. Can be specified multiple times to filter by multiple monitor IDs.
Clear enough to supply this argument.
tag
Filter incidents by tag. Can be specified multiple times to only return incidents having all the given tags.
Clear enough to supply this argument.
page
Page number to show
Clear enough to supply this argument.
per_page
Number of resources to return per page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
}
Original tool metadata
{
"name": "get_incident",
"title": "Get an incident",
"description": "Get an incident by ID, with its impact, status, state, dates and affected monitors.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"incident_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"incident_id": {
"type": "integer",
"description": "ID of the incident to show"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
},
"annotations": {
"title": "Get an incident",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description93/100
Create a manual incident affecting monitors of the project, for an outage the monitors did not catch. It triggers the `uptime.incident.created` alert rules, unless it is created already recovered with `recovery_at`. Status pages show its title once an incident update is published.
The description explains the capability, when to use it, and what to expect.
Inputs72/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
title
Incident title
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
description
Description of the error that caused the incident
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
exclude_from_downtime
Flag to exclude the incident from downtime calculations
Clear enough to supply this argument.
incident_at
Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
recovery_at
Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
monitors
List of monitors linked to the incident
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
tags
Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
impact
Incident impact
Explain the meaning of this value, not just its name.
Align the output schema with the tool’s documented result.
View output schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
}
Original tool metadata
{
"name": "create_incident",
"title": "Create an incident",
"description": "Create a manual incident affecting monitors of the project, for an outage the monitors did not catch. It triggers the `uptime.incident.created` alert rules, unless it is created already recovered with `recovery_at`. Status pages show its title once an incident update is published.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"impact",
"title",
"exclude_from_downtime",
"monitors"
],
"properties": {
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
],
"maxLength": 100,
"minLength": 1
},
"maxItems": 20,
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"maxLength": 250,
"minLength": 1,
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"maxItems": 100,
"minItems": 1,
"description": "List of monitors linked to the incident"
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"maxLength": 2000,
"minLength": 1,
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
},
"annotations": {
"title": "Create an incident",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description91/100
Update an incident by ID, the fields left out keep their current value. A `monitors` list replaces the affected monitors of a manual incident and is ignored on the incidents opened by monitors. Setting `recovery_at` on an ongoing incident recovers it and triggers the `uptime.incident.recovered` alert rules, and the changes are logged in its timeline.
Explain mutations, irreversible effects, or prerequisites that matter before calling this tool.
Inputs78/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
incident_id
ID of the incident to update
Clear enough to supply this argument.
title
Incident title
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
description
Description of the error that caused the incident
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
exclude_from_downtime
Flag to exclude the incident from downtime calculations
Clear enough to supply this argument.
incident_at
Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
recovery_at
Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
monitors
List of monitors linked to the incident
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
tags
Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
impact
Incident impact
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Align the output schema with the tool’s documented result.
View output schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
}
Original tool metadata
{
"name": "update_incident",
"title": "Update an incident",
"description": "Update an incident by ID, the fields left out keep their current value. A `monitors` list replaces the affected monitors of a manual incident and is ignored on the incidents opened by monitors. Setting `recovery_at` on an ongoing incident recovers it and triggers the `uptime.incident.recovered` alert rules, and the changes are logged in its timeline.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"incident_id"
],
"properties": {
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
],
"maxLength": 100,
"minLength": 1
},
"maxItems": 20,
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"maxLength": 250,
"minLength": 1,
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"maxItems": 100,
"minItems": 1,
"description": "List of monitors linked to the incident"
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"maxLength": 2000,
"minLength": 1,
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"incident_id": {
"type": "integer",
"description": "ID of the incident to update"
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"slug": {
"type": "string",
"examples": [
"APP-123"
],
"description": "Incident unique slug name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"type": {
"enum": [
"monitor",
"manual"
],
"type": "string",
"description": "Incident type"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitors linked to the incident"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"The server answered with an unexpected status code: 503."
],
"description": "Description of the error that caused the incident"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery. Must be after `incident_at`, within the last year and no more than 10 minutes in the future. Cannot be removed once the incident is recovered."
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
},
"annotations": {
"title": "Update an incident",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "recover_incident",
"title": "Recover an incident",
"description": "Recover an ongoing incident by ID, setting its recovery date to the current date, and trigger the `uptime.incident.recovered` alert rules.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"incident_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"incident_id": {
"type": "integer",
"description": "ID of the incident to recover"
}
}
},
"annotations": {
"title": "Recover an incident",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Delete an incident by ID with its updates, comments and timeline, it disappears from the status pages and the reports. This cannot be undone and triggers no alert rule.
The description explains the capability, when to use it, and what to expect.
Inputs50/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
incident_id
ID of the incident to delete
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "delete_incident",
"title": "Delete an incident",
"description": "Delete an incident by ID with its updates, comments and timeline, it disappears from the status pages and the reports. This cannot be undone and triggers no alert rule.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"incident_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"incident_id": {
"type": "integer",
"description": "ID of the incident to delete"
}
}
},
"annotations": {
"title": "Delete an incident",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Incident update ID"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "State of the incident update"
},
"content": {
"type": "string",
"examples": [
"We are investigating the issue."
],
"description": "Content of the incident update"
},
"creator": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Creator ID"
},
"type": {
"enum": [
"user",
"api_key"
],
"type": "string",
"examples": [
"user"
],
"description": "Creator type"
},
"label": {
"type": "string",
"examples": [
"[email protected]"
],
"description": "Creator label"
}
},
"description": "Creator of the incident update"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"published_at": {
"type": "string",
"format": "date-time",
"description": "Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
}
}
}
Original tool metadata
{
"name": "get_incident_update",
"title": "Get an incident update",
"description": "Get an incident update by ID, with its state, message, publication date and author.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"incident_id",
"incident_update_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"incident_id": {
"type": "integer",
"description": "ID of the incident"
},
"incident_update_id": {
"type": "integer",
"description": "ID of the incident update to show"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Incident update ID"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "State of the incident update"
},
"content": {
"type": "string",
"examples": [
"We are investigating the issue."
],
"description": "Content of the incident update"
},
"creator": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Creator ID"
},
"type": {
"enum": [
"user",
"api_key"
],
"type": "string",
"examples": [
"user"
],
"description": "Creator type"
},
"label": {
"type": "string",
"examples": [
"[email protected]"
],
"description": "Creator label"
}
},
"description": "Creator of the incident update"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"published_at": {
"type": "string",
"format": "date-time",
"description": "Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
}
}
},
"annotations": {
"title": "Get an incident update",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description89/100
Publish an update of an incident on the status pages and trigger the `uptime.incident_update.published` alert rules. Its state raises the state of the incident, and the `resolved` state recovers an ongoing incident.
Explain mutations, irreversible effects, or prerequisites that matter before calling this tool.
Inputs65/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
incident_id
ID of the incident
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
state
State of the incident update
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
content
Content of the incident update
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
published_at
Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Incident update ID"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "State of the incident update"
},
"content": {
"type": "string",
"examples": [
"We are investigating the issue."
],
"description": "Content of the incident update"
},
"creator": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Creator ID"
},
"type": {
"enum": [
"user",
"api_key"
],
"type": "string",
"examples": [
"user"
],
"description": "Creator type"
},
"label": {
"type": "string",
"examples": [
"[email protected]"
],
"description": "Creator label"
}
},
"description": "Creator of the incident update"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"published_at": {
"type": "string",
"format": "date-time",
"description": "Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
}
}
}
Original tool metadata
{
"name": "create_incident_update",
"title": "Create an incident update",
"description": "Publish an update of an incident on the status pages and trigger the `uptime.incident_update.published` alert rules. Its state raises the state of the incident, and the `resolved` state recovers an ongoing incident.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"incident_id",
"state",
"content"
],
"properties": {
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "State of the incident update"
},
"content": {
"type": "string",
"examples": [
"We are investigating the issue."
],
"maxLength": 10000,
"minLength": 1,
"description": "Content of the incident update"
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"incident_id": {
"type": "integer",
"description": "ID of the incident"
},
"published_at": {
"type": "string",
"format": "date-time",
"description": "Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Incident update ID"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "State of the incident update"
},
"content": {
"type": "string",
"examples": [
"We are investigating the issue."
],
"description": "Content of the incident update"
},
"creator": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Creator ID"
},
"type": {
"enum": [
"user",
"api_key"
],
"type": "string",
"examples": [
"user"
],
"description": "Creator type"
},
"label": {
"type": "string",
"examples": [
"[email protected]"
],
"description": "Creator label"
}
},
"description": "Creator of the incident update"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"published_at": {
"type": "string",
"format": "date-time",
"description": "Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
}
}
},
"annotations": {
"title": "Create an incident update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description91/100
Update the state and message of an incident update by ID, the state of the incident is recalculated. Its publication date cannot be changed, no alert rule is triggered and the `resolved` state does not recover the incident. Only its author or a user with the `incidents:moderate` permission can update it.
The description explains the capability, when to use it, and what to expect.
Inputs71/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
incident_id
ID of the incident
Explain the meaning of this value, not just its name.
incident_update_id
ID of the incident update to update
Clear enough to supply this argument.
state
State of the incident update
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
content
Content of the incident update
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
published_at
Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Incident update ID"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "State of the incident update"
},
"content": {
"type": "string",
"examples": [
"We are investigating the issue."
],
"description": "Content of the incident update"
},
"creator": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Creator ID"
},
"type": {
"enum": [
"user",
"api_key"
],
"type": "string",
"examples": [
"user"
],
"description": "Creator type"
},
"label": {
"type": "string",
"examples": [
"[email protected]"
],
"description": "Creator label"
}
},
"description": "Creator of the incident update"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"published_at": {
"type": "string",
"format": "date-time",
"description": "Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
}
}
}
Original tool metadata
{
"name": "update_incident_update",
"title": "Update an incident update",
"description": "Update the state and message of an incident update by ID, the state of the incident is recalculated. Its publication date cannot be changed, no alert rule is triggered and the `resolved` state does not recover the incident. Only its author or a user with the `incidents:moderate` permission can update it.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"incident_id",
"incident_update_id"
],
"properties": {
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "State of the incident update"
},
"content": {
"type": "string",
"examples": [
"We are investigating the issue."
],
"maxLength": 10000,
"minLength": 1,
"description": "Content of the incident update"
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"incident_id": {
"type": "integer",
"description": "ID of the incident"
},
"published_at": {
"type": "string",
"format": "date-time",
"description": "Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
},
"incident_update_id": {
"type": "integer",
"description": "ID of the incident update to update"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Incident update ID"
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "State of the incident update"
},
"content": {
"type": "string",
"examples": [
"We are investigating the issue."
],
"description": "Content of the incident update"
},
"creator": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Creator ID"
},
"type": {
"enum": [
"user",
"api_key"
],
"type": "string",
"examples": [
"user"
],
"description": "Creator type"
},
"label": {
"type": "string",
"examples": [
"[email protected]"
],
"description": "Creator label"
}
},
"description": "Creator of the incident update"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"published_at": {
"type": "string",
"format": "date-time",
"description": "Date of publication of the incident update, defaults to the current date on creation. Must be within the last year and no more than 10 minutes in the future."
}
}
},
"annotations": {
"title": "Update an incident update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Delete an incident update by ID, it disappears from the status pages and the state of the incident is recalculated, a recovered incident stays recovered. Only its author or a user with the `incidents:moderate` permission can delete it.
The description explains the capability, when to use it, and what to expect.
Inputs66/100
Explain the meaning of this value, not just its name.
project_id
ID of the project to act on, see whoami
Clear enough to supply this argument.
incident_id
ID of the incident
Explain the meaning of this value, not just its name.
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "delete_incident_update",
"title": "Delete an incident update",
"description": "Delete an incident update by ID, it disappears from the status pages and the state of the incident is recalculated, a recovered incident stays recovered. Only its author or a user with the `incidents:moderate` permission can delete it.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"incident_id",
"incident_update_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"incident_id": {
"type": "integer",
"description": "ID of the incident"
},
"incident_update_id": {
"type": "integer",
"description": "ID of the incident update to delete"
}
}
},
"annotations": {
"title": "Delete an incident update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description88/100
Schedule a maintenance window for monitors of the project, shown right away on the linked status pages. It starts at `starts_at` and ends at `ends_at` on its own, and its `monitoring_mode` sets what happens to the monitors meanwhile: `pause` pauses them, `mute` keeps checking them without incident alerts, `normal` only announces the maintenance.
The description explains the capability, when to use it, and what to expect.
Inputs67/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
title
Maintenance window title
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
description
Description of the maintenance window
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
monitoring_mode
Monitoring mode during maintenance
Explain the meaning of this value, not just its name.
starts_at
Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
ends_at
Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
monitors
List of monitor IDs linked to the maintenance window
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
status_pages
List of status page IDs linked to the maintenance window
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
tags
Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Maintenance window ID"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"state": {
"enum": [
"scheduled",
"in_progress",
"completed",
"cancelled"
],
"type": "string",
"description": "Maintenance window state"
},
"title": {
"type": "string",
"examples": [
"Database upgrade"
],
"description": "Maintenance window title"
},
"ends_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year."
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitor IDs linked to the maintenance window"
},
"starts_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"Planned database upgrade and maintenance"
],
"description": "Description of the maintenance window"
},
"status_pages": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"examples": [
[
1,
2
]
],
"description": "List of status page IDs linked to the maintenance window"
},
"monitoring_mode": {
"enum": [
"pause",
"mute",
"normal"
],
"type": "string",
"description": "Monitoring mode during maintenance"
}
}
}
Original tool metadata
{
"name": "create_maintenance_window",
"title": "Create a maintenance window",
"description": "Schedule a maintenance window for monitors of the project, shown right away on the linked status pages. It starts at `starts_at` and ends at `ends_at` on its own, and its `monitoring_mode` sets what happens to the monitors meanwhile: `pause` pauses them, `mute` keeps checking them without incident alerts, `normal` only announces the maintenance.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"title",
"monitoring_mode",
"starts_at",
"ends_at",
"monitors"
],
"properties": {
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
],
"maxLength": 100,
"minLength": 1
},
"maxItems": 20,
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"title": {
"type": "string",
"examples": [
"Database upgrade"
],
"maxLength": 250,
"minLength": 1,
"description": "Maintenance window title"
},
"ends_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year."
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"maxItems": 100,
"minItems": 1,
"description": "List of monitor IDs linked to the maintenance window"
},
"starts_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year."
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"Planned database upgrade and maintenance"
],
"maxLength": 2000,
"minLength": 1,
"description": "Description of the maintenance window"
},
"status_pages": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"examples": [
[
1,
2
]
],
"maxItems": 100,
"description": "List of status page IDs linked to the maintenance window"
},
"monitoring_mode": {
"enum": [
"pause",
"mute",
"normal"
],
"type": "string",
"description": "Monitoring mode during maintenance"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Maintenance window ID"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"state": {
"enum": [
"scheduled",
"in_progress",
"completed",
"cancelled"
],
"type": "string",
"description": "Maintenance window state"
},
"title": {
"type": "string",
"examples": [
"Database upgrade"
],
"description": "Maintenance window title"
},
"ends_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year."
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitor IDs linked to the maintenance window"
},
"starts_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"Planned database upgrade and maintenance"
],
"description": "Description of the maintenance window"
},
"status_pages": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"examples": [
[
1,
2
]
],
"description": "List of status page IDs linked to the maintenance window"
},
"monitoring_mode": {
"enum": [
"pause",
"mute",
"normal"
],
"type": "string",
"description": "Monitoring mode during maintenance"
}
}
},
"annotations": {
"title": "Create a maintenance window",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description77/100
Update a maintenance window by ID. The `monitoring_mode`, `starts_at`, `ends_at`, `monitors` and `status_pages` fields can only be modified while the maintenance window is scheduled, except for `ends_at` which can be extended while the maintenance window is in progress.
Explain mutations, irreversible effects, or prerequisites that matter before calling this tool.
Inputs68/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
maintenance_window_id
ID of the maintenance window to update
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
title
Maintenance window title
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
description
Description of the maintenance window
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
monitoring_mode
Monitoring mode during maintenance
Explain the meaning of this value, not just its name.
starts_at
Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
ends_at
Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
monitors
List of monitor IDs linked to the maintenance window
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
status_pages
List of status page IDs linked to the maintenance window
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
tags
Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Maintenance window ID"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"state": {
"enum": [
"scheduled",
"in_progress",
"completed",
"cancelled"
],
"type": "string",
"description": "Maintenance window state"
},
"title": {
"type": "string",
"examples": [
"Database upgrade"
],
"description": "Maintenance window title"
},
"ends_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year."
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitor IDs linked to the maintenance window"
},
"starts_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"Planned database upgrade and maintenance"
],
"description": "Description of the maintenance window"
},
"status_pages": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"examples": [
[
1,
2
]
],
"description": "List of status page IDs linked to the maintenance window"
},
"monitoring_mode": {
"enum": [
"pause",
"mute",
"normal"
],
"type": "string",
"description": "Monitoring mode during maintenance"
}
}
}
Original tool metadata
{
"name": "update_maintenance_window",
"title": "Update a maintenance window",
"description": "Update a maintenance window by ID. The `monitoring_mode`, `starts_at`, `ends_at`, `monitors` and `status_pages` fields can only be modified while the maintenance window is scheduled, except for `ends_at` which can be extended while the maintenance window is in progress.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"maintenance_window_id"
],
"properties": {
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
],
"maxLength": 100,
"minLength": 1
},
"maxItems": 20,
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"title": {
"type": "string",
"examples": [
"Database upgrade"
],
"maxLength": 250,
"minLength": 1,
"description": "Maintenance window title"
},
"ends_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year."
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"maxItems": 100,
"minItems": 1,
"description": "List of monitor IDs linked to the maintenance window"
},
"starts_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year."
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"Planned database upgrade and maintenance"
],
"maxLength": 2000,
"minLength": 1,
"description": "Description of the maintenance window"
},
"status_pages": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"examples": [
[
1,
2
]
],
"maxItems": 100,
"description": "List of status page IDs linked to the maintenance window"
},
"monitoring_mode": {
"enum": [
"pause",
"mute",
"normal"
],
"type": "string",
"description": "Monitoring mode during maintenance"
},
"maintenance_window_id": {
"type": "integer",
"description": "ID of the maintenance window to update"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Maintenance window ID"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"state": {
"enum": [
"scheduled",
"in_progress",
"completed",
"cancelled"
],
"type": "string",
"description": "Maintenance window state"
},
"title": {
"type": "string",
"examples": [
"Database upgrade"
],
"description": "Maintenance window title"
},
"ends_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year."
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitor IDs linked to the maintenance window"
},
"starts_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"Planned database upgrade and maintenance"
],
"description": "Description of the maintenance window"
},
"status_pages": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"examples": [
[
1,
2
]
],
"description": "List of status page IDs linked to the maintenance window"
},
"monitoring_mode": {
"enum": [
"pause",
"mute",
"normal"
],
"type": "string",
"description": "Monitoring mode during maintenance"
}
}
},
"annotations": {
"title": "Update a maintenance window",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description98/100
Cancel a scheduled or in-progress maintenance window by ID and trigger the `uptime.maintenance_window.cancelled` alert rules, the monitors it paused are resumed. Completed or already cancelled maintenance windows cannot be cancelled.
The description explains the capability, when to use it, and what to expect.
Inputs50/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
maintenance_window_id
ID of the maintenance window to cancel
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "cancel_maintenance_window",
"title": "Cancel a maintenance window",
"description": "Cancel a scheduled or in-progress maintenance window by ID and trigger the `uptime.maintenance_window.cancelled` alert rules, the monitors it paused are resumed. Completed or already cancelled maintenance windows cannot be cancelled.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"maintenance_window_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"maintenance_window_id": {
"type": "integer",
"description": "ID of the maintenance window to cancel"
}
}
},
"annotations": {
"title": "Cancel a maintenance window",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description98/100
Complete an in-progress maintenance window by ID and trigger the `uptime.maintenance_window.completed` alert rules, the monitors it paused are resumed and `ends_at` is set to the current time if it is in the future. Only in-progress maintenance windows can be completed.
The description explains the capability, when to use it, and what to expect.
Inputs50/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
maintenance_window_id
ID of the maintenance window to complete
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Maintenance window ID"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"state": {
"enum": [
"scheduled",
"in_progress",
"completed",
"cancelled"
],
"type": "string",
"description": "Maintenance window state"
},
"title": {
"type": "string",
"examples": [
"Database upgrade"
],
"description": "Maintenance window title"
},
"ends_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year."
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitor IDs linked to the maintenance window"
},
"starts_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"Planned database upgrade and maintenance"
],
"description": "Description of the maintenance window"
},
"status_pages": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"examples": [
[
1,
2
]
],
"description": "List of status page IDs linked to the maintenance window"
},
"monitoring_mode": {
"enum": [
"pause",
"mute",
"normal"
],
"type": "string",
"description": "Monitoring mode during maintenance"
}
}
}
Original tool metadata
{
"name": "complete_maintenance_window",
"title": "Complete a maintenance window",
"description": "Complete an in-progress maintenance window by ID and trigger the `uptime.maintenance_window.completed` alert rules, the monitors it paused are resumed and `ends_at` is set to the current time if it is in the future. Only in-progress maintenance windows can be completed.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"maintenance_window_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"maintenance_window_id": {
"type": "integer",
"description": "ID of the maintenance window to complete"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Maintenance window ID"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"state": {
"enum": [
"scheduled",
"in_progress",
"completed",
"cancelled"
],
"type": "string",
"description": "Maintenance window state"
},
"title": {
"type": "string",
"examples": [
"Database upgrade"
],
"description": "Maintenance window title"
},
"ends_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window ends, with minute precision (seconds must be `00`). Must be after `starts_at` and within the next year."
},
"monitors": {
"type": "array",
"items": {
"type": "integer"
},
"examples": [
[
1,
2,
3
]
],
"description": "List of monitor IDs linked to the maintenance window"
},
"starts_at": {
"type": "string",
"format": "date-time",
"description": "Date and time when the maintenance window starts, with minute precision (seconds must be `00`). Must be within the next year."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": [
"string",
"null"
],
"examples": [
"Planned database upgrade and maintenance"
],
"description": "Description of the maintenance window"
},
"status_pages": {
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"examples": [
[
1,
2
]
],
"description": "List of status page IDs linked to the maintenance window"
},
"monitoring_mode": {
"enum": [
"pause",
"mute",
"normal"
],
"type": "string",
"description": "Monitoring mode during maintenance"
}
}
},
"annotations": {
"title": "Complete a maintenance window",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Delete a maintenance window by ID in any state, it disappears from the status pages and the monitors it paused are resumed. This cannot be undone and triggers no alert rule.
The description explains the capability, when to use it, and what to expect.
Inputs50/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
maintenance_window_id
ID of the maintenance window to delete
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "delete_maintenance_window",
"title": "Delete a maintenance window",
"description": "Delete a maintenance window by ID in any state, it disappears from the status pages and the monitors it paused are resumed. This cannot be undone and triggers no alert rule.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"maintenance_window_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"maintenance_window_id": {
"type": "integer",
"description": "ID of the maintenance window to delete"
}
}
},
"annotations": {
"title": "Delete a maintenance window",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Status page ID"
},
"name": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"is_private": {
"type": "boolean",
"examples": [
false
],
"description": "Whether access to the status page is restricted by a password, a secret token or an IP allowlist"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"description": "URL to redirect users clicking the status page logo"
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"access_token_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a secret token. Requires an active Scale plan subscription."
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"description": "List of active subscription channels"
},
"access_password_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a password. Requires an active Scale plan subscription."
}
}
}
},
"meta": {
"type": "object",
"properties": {
"to": {
"type": [
"integer",
"null"
],
"examples": [
20
]
},
"from": {
"type": [
"integer",
"null"
],
"examples": [
11
]
},
"per_page": {
"type": "integer",
"examples": [
100
]
},
"current_page": {
"type": "integer",
"examples": [
2
]
},
"has_more_pages": {
"type": "boolean",
"description": "Whether a next page exists, fetched with the page argument"
}
},
"description": "Meta data for pagination"
}
}
}
Original tool metadata
{
"name": "list_status_pages",
"title": "List status pages",
"description": "Get a paginated list of the status pages of the project, newest first, with their components. Filter them by tag.",
"inputSchema": {
"type": "object",
"required": [
"project_id"
],
"properties": {
"tag": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter status pages by tag. Can be specified multiple times to only return status pages having all the given tags."
},
"page": {
"type": "integer",
"default": 1,
"examples": [
1
],
"description": "Page number to show"
},
"per_page": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"examples": [
20
],
"description": "Number of resources to return per page"
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Status page ID"
},
"name": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"is_private": {
"type": "boolean",
"examples": [
false
],
"description": "Whether access to the status page is restricted by a password, a secret token or an IP allowlist"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"description": "URL to redirect users clicking the status page logo"
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"access_token_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a secret token. Requires an active Scale plan subscription."
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"description": "List of active subscription channels"
},
"access_password_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a password. Requires an active Scale plan subscription."
}
}
}
},
"meta": {
"type": "object",
"properties": {
"to": {
"type": [
"integer",
"null"
],
"examples": [
20
]
},
"from": {
"type": [
"integer",
"null"
],
"examples": [
11
]
},
"per_page": {
"type": "integer",
"examples": [
100
]
},
"current_page": {
"type": "integer",
"examples": [
2
]
},
"has_more_pages": {
"type": "boolean",
"description": "Whether a next page exists, fetched with the page argument"
}
},
"description": "Meta data for pagination"
}
}
},
"annotations": {
"title": "List status pages",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description73/100
Get the settings of a status page by ID, with its components. The status it shows is returned by its current status.
Describe the returned information so the agent knows whether it will answer the request.
Inputs50/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
status_page_id
ID of the status page to show
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
Annotations100/100
All four behavior hints are declared.
{
"title": "Get a status page",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
Output schema86/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Status page ID"
},
"name": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"is_private": {
"type": "boolean",
"examples": [
false
],
"description": "Whether access to the status page is restricted by a password, a secret token or an IP allowlist"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"description": "URL to redirect users clicking the status page logo"
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"access_token_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a secret token. Requires an active Scale plan subscription."
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"description": "List of active subscription channels"
},
"access_password_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a password. Requires an active Scale plan subscription."
}
}
}
Original tool metadata
{
"name": "get_status_page",
"title": "Get a status page",
"description": "Get the settings of a status page by ID, with its components. The status it shows is returned by its current status.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"status_page_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"status_page_id": {
"type": "integer",
"description": "ID of the status page to show"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Status page ID"
},
"name": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"is_private": {
"type": "boolean",
"examples": [
false
],
"description": "Whether access to the status page is restricted by a password, a secret token or an IP allowlist"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"description": "URL to redirect users clicking the status page logo"
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"access_token_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a secret token. Requires an active Scale plan subscription."
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"description": "List of active subscription channels"
},
"access_password_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a password. Requires an active Scale plan subscription."
}
}
},
"annotations": {
"title": "Get a status page",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description86/100
Create a public status page showing monitors of the project, online right away at `{subdomain}.status.phare.io`. A custom domain needs a CNAME record pointing to `cname.status.phare.io`, its SSL certificate is then issued automatically. Logos and favicons can only be uploaded with a `multipart/form-data` request.
The description explains the capability, when to use it, and what to expect.
Inputs88/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
project_id
ID of the project to act on, see whoami
Clear enough to supply this argument.
name
Status page name
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
subdomain
Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
domain
Custom domain name for the status page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
title
Status page HTML title
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
description
Status page HTML description
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
search_engine_indexed
Whether search engines are allowed to index the page
Clear enough to supply this argument.
website_url
URL to redirect users clicking the status page logo
Clear enough to supply this argument.
color_scheme
Choose the available color schemes for the status page
Explain the meaning of this value, not just its name.
theme › light › operational
Color of the operational status, and of the timeline days without incident
Clear enough to supply this argument.
theme › light › degraded_performance
Color of the degraded performance status, and of the timeline days with a degraded performance incident
Clear enough to supply this argument.
theme › light › partial_outage
Color of the partial outage status, and of the timeline days with a partial outage incident
Clear enough to supply this argument.
theme › light › major_outage
Color of the major outage status, and of the timeline days with a major outage incident
Clear enough to supply this argument.
theme › light › maintenance
Color of the maintenance status, and of the timeline days with a maintenance
Clear enough to supply this argument.
theme › light › empty
Color of the timeline days without data, before the monitor was created
Clear enough to supply this argument.
theme › light › background
Page background color
Clear enough to supply this argument.
theme › light › border
Border color
Clear enough to supply this argument.
theme › light › foreground
Text color
Clear enough to supply this argument.
theme › light › foreground_muted
Secondary text color
Clear enough to supply this argument.
theme › light › background_card
Background color of the cards
Clear enough to supply this argument.
theme › dark › operational
Color of the operational status, and of the timeline days without incident
Clear enough to supply this argument.
theme › dark › degraded_performance
Color of the degraded performance status, and of the timeline days with a degraded performance incident
Clear enough to supply this argument.
theme › dark › partial_outage
Color of the partial outage status, and of the timeline days with a partial outage incident
Clear enough to supply this argument.
theme › dark › major_outage
Color of the major outage status, and of the timeline days with a major outage incident
Clear enough to supply this argument.
theme › dark › maintenance
Color of the maintenance status, and of the timeline days with a maintenance
Clear enough to supply this argument.
theme › dark › empty
Color of the timeline days without data, before the monitor was created
Clear enough to supply this argument.
theme › dark › background
Page background color
Clear enough to supply this argument.
theme › dark › border
Border color
Clear enough to supply this argument.
theme › dark › foreground
Text color
Clear enough to supply this argument.
theme › dark › foreground_muted
Secondary text color
Clear enough to supply this argument.
theme › dark › background_card
Background color of the cards
Clear enough to supply this argument.
theme › rounded
Whether the corners of the page elements are rounded, square otherwise
Clear enough to supply this argument.
theme › border_width
Width of the borders, in pixels, from 2 the icons are drawn bolder too
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
timeframe
Number of days of status and incident history to display.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
show_response_times
Whether to display response times for monitors on the status page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
timezone
Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
subscription_channels
List of active subscription channels
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
access_ips
List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
tags
Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
logo_light
Light theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
logo_dark
Dark theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
favicon_light
Light theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
favicon_dark
Dark theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
access_token
Token to restrict access to the status page. Requires an active Scale plan subscription.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
access_password
Password to restrict access to the status page. Requires an active Scale plan subscription.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Create a status page",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
Output schema84/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Status page ID"
},
"name": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"is_private": {
"type": "boolean",
"examples": [
false
],
"description": "Whether access to the status page is restricted by a password, a secret token or an IP allowlist"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"description": "URL to redirect users clicking the status page logo"
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"access_token_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a secret token. Requires an active Scale plan subscription."
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"description": "List of active subscription channels"
},
"access_password_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a password. Requires an active Scale plan subscription."
}
}
}
Original tool metadata
{
"name": "create_status_page",
"title": "Create a status page",
"description": "Create a public status page showing monitors of the project, online right away at `{subdomain}.status.phare.io`. A custom domain needs a CNAME record pointing to `cname.status.phare.io`, its SSL certificate is then issued automatically. Logos and favicons can only be uploaded with a `multipart/form-data` request.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"name",
"subdomain",
"title",
"description",
"search_engine_indexed",
"website_url",
"components",
"timeframe"
],
"properties": {
"name": {
"type": "string",
"examples": [
"Phare status"
],
"maxLength": 30,
"minLength": 2,
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
],
"maxLength": 100,
"minLength": 1
},
"maxItems": 20,
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"maximum": 3,
"minimum": 0,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"maxLength": 150,
"minLength": 2,
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"maxLength": 60,
"minLength": 4,
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"logo_dark": {
"anyOf": [
{
"type": [
"string",
"null"
],
"format": "binary",
"description": "Image file to upload"
},
{
"enum": [
false
],
"type": "boolean",
"description": "Remove the logo"
}
],
"description": "Dark theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"maxLength": 30,
"minLength": 2,
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"maxItems": 50,
"minItems": 1,
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"title": "Monitor component",
"required": [
"componentable_type",
"componentable_id"
],
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"required": [
"componentable_type",
"name",
"components"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"required": [
"componentable_type",
"componentable_id"
],
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"maxItems": 100,
"minItems": 1,
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"logo_light": {
"anyOf": [
{
"type": [
"string",
"null"
],
"format": "binary",
"description": "Image file to upload"
},
{
"enum": [
false
],
"type": "boolean",
"description": "Remove the logo"
}
],
"description": "Light theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo."
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"maxLength": 250,
"minLength": 2,
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"maxLength": 250,
"description": "URL to redirect users clicking the status page logo"
},
"access_token": {
"type": [
"string",
"null"
],
"examples": [
"secret"
],
"maxLength": 500,
"minLength": 8,
"description": "Token to restrict access to the status page. Requires an active Scale plan subscription."
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"favicon_dark": {
"anyOf": [
{
"type": [
"string",
"null"
],
"format": "binary",
"description": "Image file to upload"
},
{
"enum": [
false
],
"type": "boolean",
"description": "Remove the favicon"
}
],
"description": "Dark theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon."
},
"favicon_light": {
"anyOf": [
{
"type": [
"string",
"null"
],
"format": "binary",
"description": "Image file to upload"
},
{
"enum": [
false
],
"type": "boolean",
"description": "Remove the favicon"
}
],
"description": "Light theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon."
},
"access_password": {
"type": [
"string",
"null"
],
"examples": [
"secret"
],
"maxLength": 500,
"minLength": 8,
"description": "Password to restrict access to the status page. Requires an active Scale plan subscription."
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"maxItems": 3,
"minItems": 0,
"description": "List of active subscription channels"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Status page ID"
},
"name": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"is_private": {
"type": "boolean",
"examples": [
false
],
"description": "Whether access to the status page is restricted by a password, a secret token or an IP allowlist"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"description": "URL to redirect users clicking the status page logo"
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"access_token_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a secret token. Requires an active Scale plan subscription."
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"description": "List of active subscription channels"
},
"access_password_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a password. Requires an active Scale plan subscription."
}
}
},
"annotations": {
"title": "Create a status page",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description83/100
Update a status page by ID, the fields left out keep their current value. A `components` list replaces the current components, and a new `domain` replaces its custom domain certificate, issued automatically once the domain has a CNAME record pointing to `cname.status.phare.io`. Logos and favicons can only be uploaded with a `multipart/form-data` request.
Explain mutations, irreversible effects, or prerequisites that matter before calling this tool.
Inputs84/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clear enough to supply this argument.
status_page_id
ID of the status page to update
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
name
Status page name
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
subdomain
Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
domain
Custom domain name for the status page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
title
Status page HTML title
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
description
Status page HTML description
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
search_engine_indexed
Whether search engines are allowed to index the page
Clear enough to supply this argument.
website_url
URL to redirect users clicking the status page logo
Clear enough to supply this argument.
color_scheme
Choose the available color schemes for the status page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
theme › light › operational
Color of the operational status, and of the timeline days without incident
Clear enough to supply this argument.
theme › light › degraded_performance
Color of the degraded performance status, and of the timeline days with a degraded performance incident
Clear enough to supply this argument.
theme › light › partial_outage
Color of the partial outage status, and of the timeline days with a partial outage incident
Clear enough to supply this argument.
theme › light › major_outage
Color of the major outage status, and of the timeline days with a major outage incident
Clear enough to supply this argument.
theme › light › maintenance
Color of the maintenance status, and of the timeline days with a maintenance
Clear enough to supply this argument.
theme › light › empty
Color of the timeline days without data, before the monitor was created
Clear enough to supply this argument.
theme › light › background
Page background color
Clear enough to supply this argument.
theme › light › border
Border color
Clear enough to supply this argument.
theme › light › foreground
Text color
Clear enough to supply this argument.
theme › light › foreground_muted
Secondary text color
Clear enough to supply this argument.
theme › light › background_card
Background color of the cards
Clear enough to supply this argument.
theme › dark › operational
Color of the operational status, and of the timeline days without incident
Clear enough to supply this argument.
theme › dark › degraded_performance
Color of the degraded performance status, and of the timeline days with a degraded performance incident
Clear enough to supply this argument.
theme › dark › partial_outage
Color of the partial outage status, and of the timeline days with a partial outage incident
Clear enough to supply this argument.
theme › dark › major_outage
Color of the major outage status, and of the timeline days with a major outage incident
Clear enough to supply this argument.
theme › dark › maintenance
Color of the maintenance status, and of the timeline days with a maintenance
Clear enough to supply this argument.
theme › dark › empty
Color of the timeline days without data, before the monitor was created
Clear enough to supply this argument.
theme › dark › background
Page background color
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
theme › dark › border
Border color
Clear enough to supply this argument.
theme › dark › foreground
Text color
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
theme › dark › foreground_muted
Secondary text color
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
theme › dark › background_card
Background color of the cards
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
theme › rounded
Whether the corners of the page elements are rounded, square otherwise
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
theme › border_width
Width of the borders, in pixels, from 2 the icons are drawn bolder too
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
timeframe
Number of days of status and incident history to display.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
show_response_times
Whether to display response times for monitors on the status page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
timezone
Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
subscription_channels
List of active subscription channels
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
access_ips
List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
tags
Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
logo_light
Light theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
logo_dark
Dark theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
favicon_light
Light theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
favicon_dark
Dark theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
access_token
Token to restrict access to the status page. Requires an active Scale plan subscription.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
access_password
Password to restrict access to the status page. Requires an active Scale plan subscription.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Update a status page",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
Output schema84/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Status page ID"
},
"name": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"is_private": {
"type": "boolean",
"examples": [
false
],
"description": "Whether access to the status page is restricted by a password, a secret token or an IP allowlist"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"description": "URL to redirect users clicking the status page logo"
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"access_token_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a secret token. Requires an active Scale plan subscription."
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"description": "List of active subscription channels"
},
"access_password_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a password. Requires an active Scale plan subscription."
}
}
}
Original tool metadata
{
"name": "update_status_page",
"title": "Update a status page",
"description": "Update a status page by ID, the fields left out keep their current value. A `components` list replaces the current components, and a new `domain` replaces its custom domain certificate, issued automatically once the domain has a CNAME record pointing to `cname.status.phare.io`. Logos and favicons can only be uploaded with a `multipart/form-data` request.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"status_page_id"
],
"properties": {
"name": {
"type": "string",
"examples": [
"Phare status"
],
"maxLength": 30,
"minLength": 2,
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
],
"maxLength": 100,
"minLength": 1
},
"maxItems": 20,
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"maximum": 3,
"minimum": 0,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"maxLength": 150,
"minLength": 2,
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"maxLength": 60,
"minLength": 4,
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"logo_dark": {
"anyOf": [
{
"type": [
"string",
"null"
],
"format": "binary",
"description": "Image file to upload"
},
{
"enum": [
false
],
"type": "boolean",
"description": "Remove the logo"
}
],
"description": "Dark theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"maxLength": 30,
"minLength": 2,
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"maxItems": 50,
"minItems": 1,
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"title": "Monitor component",
"required": [
"componentable_type",
"componentable_id"
],
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"required": [
"componentable_type",
"name",
"components"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"required": [
"componentable_type",
"componentable_id"
],
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"maxItems": 100,
"minItems": 1,
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"maxItems": 100,
"minItems": 1,
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"logo_light": {
"anyOf": [
{
"type": [
"string",
"null"
],
"format": "binary",
"description": "Image file to upload"
},
{
"enum": [
false
],
"type": "boolean",
"description": "Remove the logo"
}
],
"description": "Light theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo."
},
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"maxLength": 250,
"minLength": 2,
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"maxLength": 250,
"description": "URL to redirect users clicking the status page logo"
},
"access_token": {
"type": [
"string",
"null"
],
"examples": [
"secret"
],
"maxLength": 500,
"minLength": 8,
"description": "Token to restrict access to the status page. Requires an active Scale plan subscription."
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"favicon_dark": {
"anyOf": [
{
"type": [
"string",
"null"
],
"format": "binary",
"description": "Image file to upload"
},
{
"enum": [
false
],
"type": "boolean",
"description": "Remove the favicon"
}
],
"description": "Dark theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon."
},
"favicon_light": {
"anyOf": [
{
"type": [
"string",
"null"
],
"format": "binary",
"description": "Image file to upload"
},
{
"enum": [
false
],
"type": "boolean",
"description": "Remove the favicon"
}
],
"description": "Light theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon."
},
"status_page_id": {
"type": "integer",
"description": "ID of the status page to update"
},
"access_password": {
"type": [
"string",
"null"
],
"examples": [
"secret"
],
"maxLength": 500,
"minLength": 8,
"description": "Password to restrict access to the status page. Requires an active Scale plan subscription."
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"maxItems": 3,
"minItems": 0,
"description": "List of active subscription channels"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"examples": [
1
],
"description": "Status page ID"
},
"name": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page name"
},
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"environment:production"
]
},
"description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags."
},
"theme": {
"type": "object",
"properties": {
"dark": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#3f3f46"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#111111"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#1a1a1a"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#959595"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Dark theme colors, as lowercase 6-digit hexadecimal codes"
},
"light": {
"type": "object",
"properties": {
"empty": {
"type": "string",
"examples": [
"#d3d3d3"
],
"description": "Color of the timeline days without data, before the monitor was created"
},
"border": {
"type": "string",
"examples": [
"#e5e5e5"
],
"description": "Border color"
},
"background": {
"type": "string",
"examples": [
"#ffffff"
],
"description": "Page background color"
},
"foreground": {
"type": "string",
"examples": [
"#000000"
],
"description": "Text color"
},
"maintenance": {
"type": "string",
"examples": [
"#6366f1"
],
"description": "Color of the maintenance status, and of the timeline days with a maintenance"
},
"operational": {
"type": "string",
"examples": [
"#16a34a"
],
"description": "Color of the operational status, and of the timeline days without incident"
},
"major_outage": {
"type": "string",
"examples": [
"#ef4444"
],
"description": "Color of the major outage status, and of the timeline days with a major outage incident"
},
"partial_outage": {
"type": "string",
"examples": [
"#f59e0b"
],
"description": "Color of the partial outage status, and of the timeline days with a partial outage incident"
},
"background_card": {
"type": "string",
"examples": [
"#fafafa"
],
"description": "Background color of the cards"
},
"foreground_muted": {
"type": "string",
"examples": [
"#737373"
],
"description": "Secondary text color"
},
"degraded_performance": {
"type": "string",
"examples": [
"#fbbf24"
],
"description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident"
}
},
"description": "Light theme colors, as lowercase 6-digit hexadecimal codes"
},
"rounded": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether the corners of the page elements are rounded, square otherwise"
},
"border_width": {
"type": "integer",
"default": 1,
"examples": [
2
],
"description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too"
}
},
"description": "Theme settings to customize the status page"
},
"title": {
"type": "string",
"examples": [
"Phare status"
],
"description": "Status page HTML title"
},
"domain": {
"type": [
"string",
"null"
],
"examples": [
"status.example.com"
],
"description": "Custom domain name for the status page"
},
"timezone": {
"type": "string",
"default": "UTC",
"examples": [
"Europe/Paris"
],
"description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`)."
},
"subdomain": {
"type": "string",
"examples": [
"example"
],
"description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io"
},
"timeframe": {
"enum": [
30,
60,
90
],
"type": "integer",
"examples": [
90
],
"description": "Number of days of status and incident history to display."
},
"access_ips": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"examples": [
"45.129.56.0/24"
]
},
"description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription."
},
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive)."
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"componentable_id": {
"type": "integer",
"description": "ID of the monitor to show"
},
"componentable_type": {
"enum": [
"uptime/monitor"
],
"type": "string",
"description": "Shows a monitor"
}
}
},
"description": "List of monitor components shown inside the group"
},
"is_expanded": {
"type": "boolean",
"default": false,
"examples": [
false
],
"description": "Whether the group components are expanded by default"
},
"componentable_type": {
"enum": [
"uptime/group"
],
"type": "string",
"description": "Shows a group of monitors"
}
}
}
]
},
"description": "List of components to show on the status page. A monitor can only be shown once on a status page."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Date of creation for the entity"
},
"is_private": {
"type": "boolean",
"examples": [
false
],
"description": "Whether access to the status page is restricted by a password, a secret token or an IP allowlist"
},
"project_id": {
"type": "integer",
"examples": [
1
],
"description": "Parent project ID"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of last update for the entity"
},
"description": {
"type": "string",
"examples": [
"Status page of phare.io"
],
"description": "Status page HTML description"
},
"website_url": {
"type": "string",
"examples": [
"https://phare.io"
],
"description": "URL to redirect users clicking the status page logo"
},
"color_scheme": {
"enum": [
"all",
"dark",
"light"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Choose the available color schemes for the status page"
},
"show_response_times": {
"type": "boolean",
"default": true,
"examples": [
true
],
"description": "Whether to display response times for monitors on the status page"
},
"access_token_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a secret token. Requires an active Scale plan subscription."
},
"search_engine_indexed": {
"type": "boolean",
"examples": [
true
],
"description": "Whether search engines are allowed to index the page"
},
"subscription_channels": {
"type": "array",
"items": {
"enum": [
"rss",
"atom",
"slack"
],
"type": "string"
},
"description": "List of active subscription channels"
},
"access_password_enabled": {
"type": "boolean",
"examples": [
false
],
"description": "Whether the status page is protected by a password. Requires an active Scale plan subscription."
}
}
},
"annotations": {
"title": "Update a status page",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Delete a status page by ID with its components and custom domain certificate, it goes offline right away. The monitors, incidents and maintenance windows it showed are kept. This cannot be undone.
Describe the returned information so the agent knows whether it will answer the request.
Inputs75/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clear enough to supply this argument.
status_page_id
ID of the status page to delete
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
Annotations100/100
All four behavior hints are declared.
{
"title": "Delete a status page",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
Output schema0/100
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared
Original tool metadata
{
"name": "delete_status_page",
"title": "Delete a status page",
"description": "Delete a status page by ID with its components and custom domain certificate, it goes offline right away. The monitors, incidents and maintenance windows it showed are kept. This cannot be undone.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"status_page_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"status_page_id": {
"type": "integer",
"description": "ID of the status page to delete"
}
}
},
"annotations": {
"title": "Delete a status page",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description85/100
Get what a status page shows right now: the impact of its active incidents or maintenance, its availability over its timeframe, the status of each component and its published active incidents.
The description explains the capability, when to use it, and what to expect.
Inputs50/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
project_id
ID of the project to act on, see whoami
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
status_page_id
ID of the status page to show the current status for
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
Annotations100/100
All four behavior hints are declared.
{
"title": "Get a status page current status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
Output schema91/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"properties": {
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"name": {
"type": "string",
"examples": [
"Website"
],
"description": "Monitor display name, or its name when none is set"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9999
],
"description": "Availability over the status page timeframe, in percents"
},
"component_id": {
"type": "integer",
"examples": [
1
]
},
"response_time": {
"type": [
"integer",
"null"
],
"examples": [
123
],
"description": "75th percentile (P75) response time of successful checks over the last 7 days, in milliseconds. Null if unavailable or if response times are hidden on the status page"
},
"component_type": {
"enum": [
"uptime/monitor"
],
"type": "string"
},
"current_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Highest impact of the active incidents linked to the monitor, `maintenance` if there is no active incident and the monitor is in an in-progress maintenance window"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"examples": [
"Websites"
],
"description": "Group name"
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"examples": [
"Website"
],
"description": "Monitor display name, or its name when none is set"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9999
],
"description": "Availability over the status page timeframe, in percents"
},
"component_id": {
"type": "integer",
"examples": [
1
]
},
"response_time": {
"type": [
"integer",
"null"
],
"examples": [
123
],
"description": "75th percentile (P75) response time of successful checks over the last 7 days, in milliseconds. Null if unavailable or if response times are hidden on the status page"
},
"component_type": {
"enum": [
"uptime/monitor"
],
"type": "string"
},
"current_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Highest impact of the active incidents linked to the monitor, `maintenance` if there is no active incident and the monitor is in an in-progress maintenance window"
}
}
},
"description": "Components of the group"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9999
],
"description": "Average availability of the group components over the status page timeframe, in percents"
},
"response_time": {
"type": [
"integer",
"null"
],
"examples": [
123
],
"description": "Average response time of the group components, in milliseconds"
},
"component_type": {
"enum": [
"uptime/group"
],
"type": "string"
},
"current_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Highest current incident impact of the group components"
}
}
}
]
},
"description": "Components of the status page and their current status"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of the data calculation"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9999
],
"description": "Average availability of all associated monitors over the status page timeframe (30, 60 or 90 days), in percents"
},
"active_incidents": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Incident",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact level"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation"
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery"
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
}
]
},
"description": "Active incidents linked to the status page, unpublished incidents are excluded"
},
"current_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Highest impact of all the active incidents linked to the status page, `maintenance` if there is no active incident and a maintenance window linked to the status page is in progress"
}
}
}
Original tool metadata
{
"name": "get_status_page_current_status",
"title": "Get a status page current status",
"description": "Get what a status page shows right now: the impact of its active incidents or maintenance, its availability over its timeframe, the status of each component and its published active incidents.",
"inputSchema": {
"type": "object",
"required": [
"project_id",
"status_page_id"
],
"properties": {
"project_id": {
"type": "integer",
"description": "ID of the project to act on, see whoami"
},
"status_page_id": {
"type": "integer",
"description": "ID of the status page to show the current status for"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"components": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Monitor component",
"properties": {
"name": {
"type": "string",
"examples": [
"Website"
],
"description": "Monitor display name, or its name when none is set"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9999
],
"description": "Availability over the status page timeframe, in percents"
},
"component_id": {
"type": "integer",
"examples": [
1
]
},
"response_time": {
"type": [
"integer",
"null"
],
"examples": [
123
],
"description": "75th percentile (P75) response time of successful checks over the last 7 days, in milliseconds. Null if unavailable or if response times are hidden on the status page"
},
"component_type": {
"enum": [
"uptime/monitor"
],
"type": "string"
},
"current_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Highest impact of the active incidents linked to the monitor, `maintenance` if there is no active incident and the monitor is in an in-progress maintenance window"
}
}
},
{
"type": "object",
"title": "Group component",
"properties": {
"name": {
"type": "string",
"examples": [
"Websites"
],
"description": "Group name"
},
"components": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"examples": [
"Website"
],
"description": "Monitor display name, or its name when none is set"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9999
],
"description": "Availability over the status page timeframe, in percents"
},
"component_id": {
"type": "integer",
"examples": [
1
]
},
"response_time": {
"type": [
"integer",
"null"
],
"examples": [
123
],
"description": "75th percentile (P75) response time of successful checks over the last 7 days, in milliseconds. Null if unavailable or if response times are hidden on the status page"
},
"component_type": {
"enum": [
"uptime/monitor"
],
"type": "string"
},
"current_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Highest impact of the active incidents linked to the monitor, `maintenance` if there is no active incident and the monitor is in an in-progress maintenance window"
}
}
},
"description": "Components of the group"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9999
],
"description": "Average availability of the group components over the status page timeframe, in percents"
},
"response_time": {
"type": [
"integer",
"null"
],
"examples": [
123
],
"description": "Average response time of the group components, in milliseconds"
},
"component_type": {
"enum": [
"uptime/group"
],
"type": "string"
},
"current_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Highest current incident impact of the group components"
}
}
}
]
},
"description": "Components of the status page and their current status"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Date of the data calculation"
},
"availability": {
"type": "number",
"format": "float",
"examples": [
99.9999
],
"description": "Average availability of all associated monitors over the status page timeframe (30, 60 or 90 days), in percents"
},
"active_incidents": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"title": "Incident",
"properties": {
"id": {
"type": "integer",
"examples": [
1
]
},
"state": {
"enum": [
"unknown",
"investigating",
"identified",
"monitoring",
"resolved"
],
"type": "string",
"description": "Incident state"
},
"title": {
"type": "string",
"examples": [
"Service is not working as expected"
],
"description": "Incident title"
},
"impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Incident impact level"
},
"status": {
"enum": [
"ongoing",
"recovering",
"recovered"
],
"type": "string",
"description": "Incident status"
},
"incident_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident confirmation"
},
"recovery_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Date of incident recovery"
},
"exclude_from_downtime": {
"type": "boolean",
"examples": [
false
],
"description": "Flag to exclude the incident from downtime calculations"
}
}
}
]
},
"description": "Active incidents linked to the status page, unpublished incidents are excluded"
},
"current_incident_impact": {
"enum": [
"unknown",
"operational",
"maintenance",
"degraded_performance",
"partial_outage",
"major_outage"
],
"type": "string",
"description": "Highest impact of all the active incidents linked to the status page, `maintenance` if there is no active incident and a maintenance window linked to the status page is in progress"
}
}
},
"annotations": {
"title": "Get a status page current status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
Loading score analytics…
Put your MCP to the test
A few tasks worth trying with this server, chosen from its reviewed tools. These have not been run.
01List projectsGet a paginated list of the projects you can access, newest first, with the IDs of their members.
02Get a projectGet a project by ID, with the IDs of its members and its incident settings.
03Get a userGet a user of the organization by ID, with their email address and role.
04Who am IGet your user, role, organization, permissions and the projects you can access.
05Get reportGet the availability, downtime, incident count, MTTR and MTBF of every monitor of the project and their aggregates, between two past dates up to 1 year apart…
Want to run these tasks against your MCP server with us?
Phare setup, tools, quality score, publishing readiness, and alternatives.
How do I add Phare to Claude, ChatGPT, or Cursor?
Add Phare to Claude, ChatGPT, or Cursor by connecting its remote MCP URL in each client's MCP settings. In Claude, add a custom connector. In ChatGPT, add an MCP app. In Cursor, add an MCP server under Settings. The MCP URL is https://mcp.phare.io/mcp.
Is Phare MCP ready for ChatGPT and Claude?
As of November 7, 2026, Phare scores 100/100 on Manufact's MCP publishing checklist. The scan meets ChatGPT publishing checks and meets Claude publishing checks. Passing these checks does not guarantee marketplace approval.
How clear is Phare's MCP tool documentation?
As of November 7, 2026, Phare scores 85/100 in Manufact's review of tool titles, descriptions, input and output schemas, and behavior annotations. The review covers 51 of 51 discovered tools. The quality score measures documentation clarity; runtime behavior and marketplace readiness require separate checks.
What are the best alternatives to Phare?
As of November 7, 2026, alternatives to Phare in developer-tools on the Manufact MCP leaderboard include Speko, Manufact, Context, AgentMail, and TPC Benchmarks.
How can Phare improve its MCP documentation?
resume_monitor is the lowest-scoring reviewed tool at 73/100. No output schema is declared. Add one for structured results so clients can interpret returned fields. Open its review for feedback and a copyable fix prompt, then rerun the documentation review after updating your tool metadata.
Not your MCP?
Review any public or OAuth MCP server for protocol compatibility, tool documentation, and ChatGPT and Claude publishing readiness. No account required.
Cursor
Grok Bot
Grok
Muse