Skip to main content
The DevHelm MCP server exposes 120 tools across 17 categories. Authentication is handled at the transport layer (Bearer header or env var) — api_token is accepted as a back-compat parameter on every tool but is hidden from LLM-facing schemas to prevent token leakage.

Monitors (10 tools)

ToolParametersDescription
list_monitorsList all monitors
get_monitormonitor_idGet a monitor by ID
create_monitorbodyCreate a monitor. Required: name, type, config, frequencySeconds
update_monitormonitor_id, bodyUpdate a monitor’s configuration
delete_monitormonitor_idDelete a monitor
pause_monitormonitor_idPause a monitor
resume_monitormonitor_idResume a paused monitor
test_monitormonitor_idRun an ad-hoc check
list_monitor_resultsmonitor_id, cursor?, limit?List recent check results (cursor-paginated)
list_monitor_versionsmonitor_id, page?, size?List version history

Incidents (4 tools)

ToolParametersDescription
list_incidentsList all incidents
get_incidentincident_idGet an incident with full details
create_incidentbodyCreate a manual incident. Required: title, severity (DOWN/DEGRADED/MAINTENANCE). Optional: monitorId, body
resolve_incidentincident_id, message?Resolve an active incident
Incidents cannot be deleted — only resolved. Once resolved, they remain in history for audit and reporting.

Alert channels (6 tools)

ToolParametersDescription
list_alert_channelsList all alert channels
get_alert_channelchannel_idGet a channel by ID
create_alert_channelbodyCreate a channel. Required: name, type, config
update_alert_channelchannel_id, bodyUpdate a channel
delete_alert_channelchannel_idDelete a channel
test_alert_channelchannel_idSend a test notification

Notification policies (6 tools)

ToolParametersDescription
list_notification_policiesList all policies
get_notification_policypolicy_idGet a policy by ID
create_notification_policybodyCreate a policy. Required: name, matchRules, escalation, enabled, priority
update_notification_policypolicy_id, bodyUpdate a policy
delete_notification_policypolicy_idDelete a policy
test_notification_policypolicy_idSend a test dispatch

Environments (5 tools)

ToolParametersDescription
list_environmentsList all environments
get_environmentslugGet an environment by slug
create_environmentbodyCreate an environment. Required: name, slug
update_environmentslug, bodyUpdate an environment
delete_environmentslugDelete an environment

Secrets (4 tools)

ToolParametersDescription
list_secretsList all secrets (metadata only, values are never returned)
create_secretbodyCreate an encrypted secret. Required: key, value
update_secretkey, bodyUpdate a secret’s value
delete_secretkeyDelete a secret

Tags (5 tools)

ToolParametersDescription
list_tagsList all tags
get_tagtag_idGet a tag by ID
create_tagbodyCreate a tag. Required: name
update_tagtag_id, bodyUpdate a tag
delete_tagtag_idDelete a tag

Resource groups (7 tools)

ToolParametersDescription
list_resource_groupsList all resource groups
get_resource_groupgroup_idGet a group by ID
create_resource_groupbodyCreate a group. Required: name
update_resource_groupgroup_id, bodyUpdate a group
delete_resource_groupgroup_idDelete a group
add_resource_group_membergroup_id, bodyAdd a monitor to a group
remove_resource_group_membergroup_id, member_idRemove a member from a group

Webhooks (6 tools)

ToolParametersDescription
list_webhooksList all webhook endpoints
get_webhookwebhook_idGet a webhook by ID
create_webhookbodyCreate a webhook. Required: url, subscribedEvents
update_webhookwebhook_id, bodyUpdate a webhook
delete_webhookwebhook_idDelete a webhook
test_webhookwebhook_idSend a test event

API keys (4 tools)

ToolParametersDescription
list_api_keysList all API keys
create_api_keybodyCreate a key. Required: name. Optional: expiresAt. Key value returned only once
revoke_api_keykey_idRevoke a key (disables without deleting)
delete_api_keykey_idDelete a key permanently

Dependencies (5 tools)

ToolParametersDescription
list_dependenciesList tracked service dependencies
get_dependencydependency_idGet a dependency by ID
track_dependencyslug, component_id?, alert_sensitivity?Start tracking a service (e.g., github, aws). Optionally track a single component and set alert sensitivity
update_dependency_alert_sensitivitysubscription_id, alert_sensitivityChange alert sensitivity: AWARENESS, INCIDENTS_ONLY, MAJOR_ONLY, or ALL
delete_dependencydependency_idStop tracking a service

Deploy lock (4 tools)

ToolParametersDescription
acquire_deploy_lockbodyAcquire a lock. Required: lockedBy. Optional: ttlMinutes (default 30, max 60)
get_current_deploy_lockGet current lock status (null if unlocked)
release_deploy_locklock_idRelease a lock
force_release_deploy_lockForce-release any active lock

Status (1 tool)

ToolParametersDescription
get_status_overviewDashboard overview with monitor counts and uptime stats

Forensics (5 tools)

Read-only audit trail for the detection engine — incident timelines, check traces, policy snapshots, rule evaluations, and state transitions. See Incident Forensics for the conceptual overview.
ToolParametersDescription
get_incident_timelineincident_idFull timeline: state transitions, triggering rule evaluations, and active policy snapshot
get_check_tracecheck_idEverything recorded for a single check execution
get_policy_snapshothash_hexFetch a policy snapshot by its SHA-256 hash
list_monitor_rule_evaluationsmonitor_id, rule_type?, region?, only_matched?, from_?, to?, page?, size?Paginated rule evaluations for a monitor
list_monitor_transitionsmonitor_id, from_?, to?, page?, size?Paginated state transitions for a monitor

Status pages (30 tools)

The largest category — covers the full status page surface: pages, components, groups, incidents, subscribers, and custom domains.

Pages

ToolParametersDescription
list_status_pagesList all status pages
get_status_pagepage_idGet a status page
create_status_pagebodyCreate a page. Required: name, slug
update_status_pagepage_id, bodyUpdate a page
delete_status_pagepage_idDelete a page (cascades to components, groups, incidents)
reorder_status_page_layoutpage_id, bodyReorder top-level groups and components

Components

ToolParametersDescription
list_status_page_componentspage_idList components on a page
create_status_page_componentpage_id, bodyAdd a component
update_status_page_componentpage_id, component_id, bodyUpdate a component
delete_status_page_componentpage_id, component_idRemove a component
reorder_status_page_componentspage_id, bodyReorder components within a group

Groups

ToolParametersDescription
list_status_page_groupspage_idList component groups
create_status_page_grouppage_id, bodyCreate a group
update_status_page_grouppage_id, group_id, bodyUpdate a group
delete_status_page_grouppage_id, group_idDelete a group

Incidents

ToolParametersDescription
list_status_page_incidentspage_id, page?, size?List published / draft incidents (paginated)
get_status_page_incidentpage_id, incident_idGet incident details
create_status_page_incidentpage_id, bodyDraft a new incident
update_status_page_incidentpage_id, incident_id, bodyUpdate title / impact / status
post_status_page_incident_updatepage_id, incident_id, bodyAppend a status update entry
publish_status_page_incidentpage_id, incident_idPromote a draft to public
dismiss_status_page_incidentpage_id, incident_idDiscard a draft incident
delete_status_page_incidentpage_id, incident_idDelete a published incident

Subscribers

ToolParametersDescription
list_status_page_subscriberspage_id, page?, size?List confirmed subscribers (paginated)
add_status_page_subscriberpage_id, bodyAdd a subscriber
remove_status_page_subscriberpage_id, subscriber_idRemove a subscriber

Custom domains

ToolParametersDescription
list_status_page_domainspage_idList custom domains
add_status_page_domainpage_id, bodyRegister a new domain
verify_status_page_domainpage_id, domain_idTrigger DNS verification
remove_status_page_domainpage_id, domain_idDetach a domain

Services (13 tools)

Browse the third-party service catalog — search services, check live status, pull uptime history, list vendor incidents and maintenance windows.
ToolParametersDescription
search_servicesquery?, category?, limit?Search the catalog by name or category
get_serviceslugGet a service summary by slug (e.g. github)
get_service_live_statusslugGet real-time operational status from the upstream status page
get_services_summaryGlobal status summary across the entire catalog
list_service_categoriesList catalog categories (cloud, payments, devtools, …)
list_service_componentsslugList a service’s components with individual statuses
get_service_uptimeslug, period?Historical uptime stats (default 30d)
list_service_incidentsslug?, status?List vendor incidents for a service or across all services
get_service_incidentslug, incident_idGet one vendor incident in full detail
get_service_day_rollupslug, dateOne-day rollup: uptime, impact windows, incidents (ISO date)
get_component_uptimeslug, component_id, period?Daily uptime history for a single component
get_all_components_uptimeslug, period?Daily uptime history for every leaf component in one call
list_service_maintenancesslugScheduled and past maintenance windows from a vendor

Maintenance windows (5 tools)

Schedule downtime to suppress alerts during planned work (deploys, migrations, vendor maintenance).
ToolParametersDescription
list_maintenance_windowsmonitor_id?, status?List maintenance windows. Filter by monitor or status (active/upcoming)
get_maintenance_windowwindow_idGet a single maintenance window by ID
create_maintenance_windowbodySchedule a window. Required: startsAt, endsAt. Optional: monitorId, reason, repeatRule, suppressAlerts
update_maintenance_windowwindow_id, bodyUpdate a window (full replacement). Required: startsAt, endsAt
cancel_maintenance_windowwindow_idCancel a window — alerts resume immediately

Body parameter format

Tools that accept a body parameter expect a JSON object matching the corresponding REST API request schema. Refer to the API Reference for field-level details.

Next steps

MCP configuration

Transport modes and client setup.

API Reference

REST API schemas for body parameters.