If you are anything like me, you spend most of your day in a terminal. Switching to a browser dashboard to check whether your API is still responding feels like an interruption — a small one, but it adds up. What if you could ask your AI coding assistant to check on your monitors, create new ones, or post an incident update, all without leaving your editor?
That is exactly what CronAlert's MCP server enables. Using the Model Context Protocol, Claude Code can talk directly to your CronAlert account — listing monitors, pulling uptime stats, managing incidents, and more. This post walks through how to set it up and what you can actually do with it.
A quick primer on Claude Code
Claude Code is Anthropic's CLI tool that brings Claude into your terminal. You install it globally with npm:
npm install -g @anthropic-ai/claude-code
Then run claude in any directory to start a session. It can read your files, run commands, write code, and — crucially for this article — connect to external services through MCP servers. If you have used GitHub Copilot in the terminal or Cursor's AI features, Claude Code is in the same category, but with the added ability to plug into arbitrary APIs via MCP.
What is the Model Context Protocol (MCP)?
MCP is an open standard that defines how AI tools connect to external services. Think of it like a USB-C port for AI: a single protocol that lets any compliant AI client talk to any compliant server. Instead of copy-pasting curl output into a chat window, the AI calls tools directly and gets structured data back.
CronAlert publishes an MCP server as an npm package (cronalert-mcp). Once registered with Claude Code, it gives Claude direct access to 11 monitoring tools — everything from creating monitors to posting incident updates.
Prerequisites
You need four things:
- Node.js 18+ — the MCP server runs via
npx - Claude Code — installed globally (
npm install -g @anthropic-ai/claude-code) - A CronAlert account — the free plan works fine, no credit card needed
- An API key — generate one at Settings > API Keys
Setup: one command
The entire setup is a single line. Open your terminal and run:
claude mcp add cronalert -e CRONALERT_API_KEY=YOUR_API_KEY -- npx -y cronalert-mcp That is it. Here is what happens behind the scenes:
claude mcp addtells Claude Code to register a new MCP servercronalertis the name you are giving this server (you will see it in/mcplistings)-e CRONALERT_API_KEY=...passes your API key as an environment variable to the server processnpx -y cronalert-mcpis the command Claude Code will run to start the server —npxdownloads the package on first use, and-yskips the confirmation prompt
The server runs locally on your machine via stdio transport. Your API key never leaves your computer except when making authenticated requests to the CronAlert API.
Verify the connection: Start a Claude Code session and type /mcp. You should see cronalert listed with a green status. If it shows as disconnected, double-check that your API key is correct and that npx cronalert-mcp runs without errors on its own.
What you can actually do with it
The real value is not in the setup — it is in how this fits into your workflow. Here are concrete examples of prompts you can give Claude Code and what happens under the hood.
Create a monitor while you are deploying
You just finished setting up a new service. Instead of opening the CronAlert dashboard, you type:
# In your Claude Code session:
Create a monitor for https://api.myapp.com/health that checks every 3 minutes
Claude calls the create_monitor tool with the URL and interval. The monitor starts checking immediately. You stay in your terminal, move on to the next task.
Check what is down right now
List all my monitors and highlight any that are currently down
Claude calls list_monitors, gets back the full list with statuses, and presents a summary. No dashboard, no page load, no clicking through filters.
Pull uptime stats for a specific service
What's the uptime percentage and average response time for my production API this week?
This hits get_check_results with the appropriate monitor ID and time range. Claude parses the response and gives you the numbers in plain English — uptime percentage, average response time, any incidents that occurred.
Batch operations during maintenance
Pause all monitors that have "staging" in the name
Claude calls list_monitors first to find the relevant ones, then calls update_monitor on each to set them to paused. When your maintenance window is over, tell it to resume them. This kind of batch operation is tedious in any dashboard but trivial with natural language.
Post an incident update
Post an update to the active incident on api.myapp.com saying we identified the
root cause as a database connection pool exhaustion and a fix is being deployed
Claude finds the active incident via list_incidents, then calls add_incident_update with your message. Your status page subscribers get notified. You wrote it from the same terminal where you are fixing the bug.
Why this beats switching to a dashboard
There are a few reasons this workflow sticks once you try it:
- Zero context switching. You are already in the terminal writing code. Checking uptime or creating a monitor is just another prompt in the same session.
- Deployment + monitoring in one flow. Deploy your service, create a monitor for it, and verify it is responding — all in a single Claude Code session without touching a browser.
- Natural language over forms. "Create monitors for these 5 URLs with 1-minute intervals" is faster than filling out a form five times. Claude handles the repetition.
- Composability. Combine CronAlert's MCP with other MCP servers. If you have GitHub's MCP server connected, you could merge a PR, deploy, and set up monitoring in one conversation.
Tips for power users
Verify your connection with /mcp
If something feels off — Claude is not recognizing monitoring commands, or you are getting authentication errors — run /mcp inside your Claude Code session. It shows the status of all connected MCP servers and lets you restart them if needed.
Plan limits still apply
The MCP server uses the same API as the dashboard, so your plan limits are enforced server-side. On the free plan, you get 25 monitors with 3-minute check intervals. If you need 1-minute intervals or more monitors, upgrade to Pro ($5/month). The MCP server itself is free to use on any plan.
Combine with other MCP servers
This is where things get interesting. If you have GitHub, Sentry, or other MCP servers registered in Claude Code, you can build cross-service workflows in a single conversation. For example: "Check if there are any open incidents on my API, look at the recent Sentry errors for that service, and draft a post-mortem." Each MCP server contributes its piece.
Available tools reference
The CronAlert MCP server exposes 11 tools. Here is the full list:
| Tool | Description |
|---|---|
| list_monitors | List all monitors with filtering and pagination |
| create_monitor | Create a new HTTP monitor with URL, interval, and alert settings |
| get_monitor | Get detailed info for a specific monitor including current status |
| update_monitor | Update monitor configuration, or pause/resume checking |
| delete_monitor | Permanently delete a monitor and its check history |
| get_check_results | Retrieve check history with uptime percentage and response times |
| get_monitor_incidents | Get all incidents for a specific monitor |
| list_incidents | List all active incidents across your account |
| list_status_pages | List your public status pages |
| add_incident_update | Post a status update on an open incident |
| get_incident_updates | Get the full timeline of updates for an incident |
Every tool accepts and returns JSON. Claude handles the serialization — you just describe what you want in plain English.
Frequently asked questions
Do I need a paid CronAlert plan to use the MCP server?
No. The free plan gives you 25 monitors with 3-minute check intervals, email/Slack/Discord/webhook alerts, a status page, and full API access including MCP. Paid plans unlock 1-minute intervals, more monitors, and features like keyword monitoring and maintenance windows.
Does the MCP server work with Claude Code on all platforms?
Yes. Claude Code runs on macOS, Linux, and Windows. The MCP server is a Node.js process started via npx, so it works anywhere Node.js 18+ is installed.
Can I use the remote endpoint instead of the npm package?
CronAlert also offers a remote MCP endpoint at https://cronalert.com/mcp using Streamable HTTP transport. It works with any MCP-compatible client that supports remote servers. However, for Claude Code specifically, the npm package (cronalert-mcp) is recommended because it runs locally via stdio, which avoids network latency on every tool call.
What happens if the MCP server disconnects?
Claude Code manages MCP server lifecycle automatically and will attempt to reconnect. If you suspect a connection issue, type /mcp in your session to check the status of all registered servers. You can restart a specific server from that menu.
Wrapping up
Setting up CronAlert's MCP server in Claude Code takes about 30 seconds and removes the need to context-switch to a dashboard for routine monitoring tasks. Creating monitors, checking uptime, pausing checks during maintenance, posting incident updates — all of it becomes a natural language prompt in your terminal.
If you do not have a CronAlert account yet, sign up for free and generate an API key. Then run the one-liner:
claude mcp add cronalert -e CRONALERT_API_KEY=YOUR_API_KEY -- npx -y cronalert-mcp Your monitors are now a conversation away.