Ionhour

Connect AI assistants to yourIonhouruptime monitoring workspace using theModel Context Protocol.

# Option 1: Interactive login (recommended) npx @ionhour/mcp-server login # Option 2: Set your API key manually export IONHOUR_API_KEY=ionh_your_key_here # Run the MCP server npx @ionhour/mcp-server

npx -y @smithery/cli install @ionhour/mcp-server --client claude

claude mcp add ionhour -- npx @ionhour/mcp-server

{ "mcpServers": { "ionhour": { "command": "npx", "args": ["@ionhour/mcp-server"], "env": { "IONHOUR_API_KEY": "ionh_your_key_here" } } } }

{ "mcpServers": { "ionhour": { "command": "npx", "args": ["@ionhour/mcp-server"], "env": { "IONHOUR_API_KEY": "ionh_your_key_here" } } } }

{ "servers": { "ionhour": { "command": "npx", "args": ["@ionhour/mcp-server"], "env": { "IONHOUR_API_KEY": "ionh_your_key_here" } } } }

Add to your~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "ionhour": { "command": "npx", "args": ["@ionhour/mcp-server"], "env": { "IONHOUR_API_KEY": "ionh_your_key_here" } } } }

- Go to your Ionhour workspaceSettings > API Keys
- Create a new key withRead & WriteorRead Onlypermission
- Copy the key (starts withionh_)

- get_workspace- Get workspace details
- whoami- Get API key info (workspace, user, permission level)
- get_workspace_summary- Overview of projects, checks by status, and active incidents
- get_workspace_reliability- Uptime, incident count, and MTTR over N days
- list_team_members- List workspace members and roles
- send_invitation- Invite users to the workspace

- list_projects/create_project/update_project

Ionhour probes a URL you own on a schedule and alerts on failure.

- create_check- Create an outbound check (accepts human-readable intervals like "every 5 minutes" or "hourly")
- list_checks/list_checks_by_status/find_check_by_name
- get_check_status- Detailed status with recent probe results
- get_check_uptime- Uptime percentage with daily buckets
- run_check_probe- Probe the check on demand
- pause_check/resume_check
- delete_check- Permanently delete a check and its data

register_checkis a deprecated tombstone: it creates nothing. Useregister_jobfor a heartbeat monitor orcreate_checkfor an outbound probe.

Your cron/worker pings Ionhour; Ionhour alerts if a ping is late or missing.

- register_job- Create a Job and get its heartbeat token (accepts human-readable intervals)
- list_jobs/find_job_by_name
- get_job_status- Detailed status with recent heartbeats
- get_job_uptime- Uptime percentage with daily buckets
- pause_job/resume_job
- delete_job- Delete a job and its data

- send_heartbeat- Send a success signal
- send_failure_signal- Report a failure
- list_signals- View signal history

- list_incidents/search_incidents/get_incident
- get_incident_timeline- Incident history for a check or job
- create_incident/acknowledge_incident/resolve_incident
- add_incident_note

- create_deployment- Start a deployment window (auto-pauses checks)
- end_deployment- End deployment and resume checks
- list_deployments

- list_dependencies/get_dependency/create_dependency
- update_dependency_status
- delete_dependency- Delete a dependency

- list_status_pages/create_status_page/update_status_page
- create_announcement- Post a status update

- list_alert_channels/create_alert_channel/update_alert_channel
- delete_alert_channel- Delete a notification channel

- list_escalation_rules/create_escalation_rule/update_escalation_rule
- delete_escalation_rule- Delete an escalation rule

The server exposes reference data that AI assistants can browse without calling tools:

Pre-built workflow templates that guide AI assistants through multi-step operations:

npx @ionhour/mcp-server [command] [options] Commands: (default) Start the MCP server (stdio proxy mode) setup Interactive wizard — install MCP server into your editors login Authenticate via browser and store API key logout Remove stored credentials whoami Show current authentication status Options: --api-key KEY Ionhour API key (or set IONHOUR_API_KEY env var) --base-url URL MCP base URL (default: https://mcp.ionhour.com) --version, -v Show version --help, -h Show help Environment Variables: IONHOUR_API_KEY API key for authentication IONHOUR_BASE_URL Base URL override IONHOUR_AUTH_URL Keycloak auth server URL (for login) IONHOUR_REALM Keycloak realm name (for login)

Interactive wizard that detects installed editors (Cursor, Claude Desktop, VS Code, Claude Code, Windsurf) and writes the Ionhour MCP server configuration into each one. Prompts for login if no credentials are stored:

Opens your browser to authenticate with Ionhour, then automatically creates and stores an API key:

Credentials are stored at~/.config/ionhour/credentials.json(file permissions: 600). After login, you can run the MCP server without settingIONHOUR_API_KEY.

Removes stored credentials from~/.config/ionhour/credentials.json:

Shows the current authentication status — the workspace, user, and permission level associated with the stored API key:

This package runs a local MCP server overstdiothat proxies requests to the Ionhour API. Your AI assistant communicates with this local server, which forwards tool calls to your Ionhour workspace.

AI Assistant <--stdio--> @ionhour/mcp-server <--HTTPS--> Ionhour API

- MCP Integration Guide— Full setup, architecture, and complete tool reference with parameters
- MCP Prompts & Workflows— Prompt documentation, project rules, and best practices

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB