HeyOnCall MCP Server

Introduction

The HeyOnCall MCP Server provides integration with HeyOnCall, a comprehensive on-call rotation scheduling, alerting, escalations, and monitoring platform. HeyOnCall takes a spartan approach to managing DevOps operations, offering tools to monitor every part of a modern web application from personal projects to production systems.

This MCP server enables AI assistants to trigger critical alerts directly through HeyOnCall's alerting system. The integration allows for seamless escalation of issues to the appropriate on-call personnel through HeyOnCall's robust notification infrastructure, which includes mobile apps with special critical alert permissions, Slack integration, email, and other delivery channels.

The server provides a simple but powerful interface for creating incidents that will be automatically routed to the current on-call user for the relevant service, complete with escalation policies and comprehensive incident management features.

Use Cases

Critical System Failure Detection

When monitoring systems detect critical failures that require immediate human intervention.

• Sample prompt: The database server is showing 100% CPU usage and response times over 30 seconds. This is affecting our main application. Please alert the on-call team immediately with the message "Database server critical performance issue - immediate attention required" and include the monitoring dashboard URL https://monitoring.company.com/db-alerts

Security Incident Response

When security monitoring tools detect potential threats or breaches that need urgent attention.

• Sample prompt: I've detected multiple failed login attempts from suspicious IP addresses on our admin panel. Alert the security on-call team with the message "Potential brute force attack detected on admin panel" and include the security dashboard link https://security.company.com/incidents/2024001

Automated Deployment Failure Escalation

When CI/CD pipelines fail critically and automated recovery attempts are unsuccessful.

• Sample prompt: Our production deployment pipeline has failed three consecutive times and rollback attempts have also failed. The site is down. Please immediately alert the DevOps team with "Production deployment failure - site down, rollback failed" and include the build status page https://ci.company.com/build/prod-2024-001

Business-Critical Process Monitoring

When essential business processes like payment processing or data synchronization fail.

• Sample prompt: The nightly payment processing batch job has been stuck for 2 hours and customer payments are not being processed. Alert the payments team immediately with "Payment processing batch job stuck - customer payments delayed" and link to https://admin.company.com/payments/batch-status

Infrastructure Threshold Breach

When system metrics exceed critical thresholds that could lead to service degradation.

• Sample prompt: Our primary web server's disk usage has reached 95% and is growing rapidly. This could cause the application to crash within the hour. Alert the infrastructure team with "Web server disk space critical - 95% usage, immediate cleanup required" and include the server dashboard https://infra.company.com/servers/web-01

Third-Party Service Integration Failures

When critical integrations with external services fail and affect business operations.

• Sample prompt: Our Stripe payment integration has been failing for the last 20 minutes with API errors. Customers cannot complete purchases. Please alert the backend team immediately with "Stripe payment integration down - blocking all purchases" and include our payment errors dashboard https://monitoring.company.com/payments/errors

Data Backup and Recovery Issues

When automated backup systems fail or data integrity issues are detected.

• Sample prompt: The automated database backup job failed last night and this morning's backup also failed. We have no recent backups available. Alert the database team urgently with "Database backup system failure - no recent backups available" and include the backup monitoring page https://backups.company.com/status