Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

MCP Health Monitor

by oaslanankaversion 1.4.0i★ 2iRuns on your computerRepository ↗
Registry nameio.github.oaslananka/health-monitor-mcp

How to install

What it does

Monitor MCP, CI, and HTTP targets with health history, TLS expiry, assertions, and diagnostics

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Clinics & health

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity6/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness0/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score6/100

Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install MCP Health Monitor. Follow https://mcp.popnx.com/i/oaslananka-health-monitor-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 2/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server MCP Health Monitor for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "health-monitor": { "command": "npx", "args": [ "-y", "health-monitor-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the MCP Health Monitor tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "health-monitor": {
          "command": "npx",
          "args": [
            "-y",
            "health-monitor-mcp"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use MCP Health Monitor and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using MCP Health Monitor or shows a MCP Health Monitor tool in the answer, you are connected

8 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • HEALTH_MONITOR_DB Custom path for the SQLite database
  • HEALTH_MONITOR_AUTO_CHECK Set to '1' to enable background scheduled checks
  • HEALTH_MONITOR_RETENTION_DAYS Number of days to retain health check history
  • HEALTH_MONITOR_MAX_CONCURRENCY Maximum concurrent scheduled and interactive server checks
  • GITHUB_TOKEN Optional GitHub token with Actions read access for private repositories and higher API rate limits
  • GITLAB_TOKEN Optional GitLab token with read access to private projects, pipelines, jobs, and traces
  • HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST Comma-separated self-hosted GitLab HTTPS origins allowed for monitoring
  • HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST Comma-separated private HTTP(S) origins allowed only in the full runtime profile

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect MCP Health Monitor yet

MCP Health Monitor runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect MCP Health Monitor

  • Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)

B · Others in Clinics & health that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server MCP Health Monitor for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user health-monitor -- npx -y health-monitor-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the MCP Health Monitor tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user health-monitor -- npx -y health-monitor-mcp
  4. Type /mcp in Claude Code

    You should see MCP Health Monitor listed as connected

  5. Try it

    Use MCP Health Monitor and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using MCP Health Monitor or shows a MCP Health Monitor tool in the answer, you are connected

8 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • HEALTH_MONITOR_DB Custom path for the SQLite database
  • HEALTH_MONITOR_AUTO_CHECK Set to '1' to enable background scheduled checks
  • HEALTH_MONITOR_RETENTION_DAYS Number of days to retain health check history
  • HEALTH_MONITOR_MAX_CONCURRENCY Maximum concurrent scheduled and interactive server checks
  • GITHUB_TOKEN Optional GitHub token with Actions read access for private repositories and higher API rate limits
  • GITLAB_TOKEN Optional GitLab token with read access to private projects, pipelines, jobs, and traces
  • HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST Comma-separated self-hosted GitLab HTTPS origins allowed for monitoring
  • HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST Comma-separated private HTTP(S) origins allowed only in the full runtime profile

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server MCP Health Monitor for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "health-monitor": { "command": "npx", "args": [ "-y", "health-monitor-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the MCP Health Monitor tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use MCP Health Monitor and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using MCP Health Monitor or shows a MCP Health Monitor tool in the answer, you are connected

8 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • HEALTH_MONITOR_DB Custom path for the SQLite database
  • HEALTH_MONITOR_AUTO_CHECK Set to '1' to enable background scheduled checks
  • HEALTH_MONITOR_RETENTION_DAYS Number of days to retain health check history
  • HEALTH_MONITOR_MAX_CONCURRENCY Maximum concurrent scheduled and interactive server checks
  • GITHUB_TOKEN Optional GitHub token with Actions read access for private repositories and higher API rate limits
  • GITLAB_TOKEN Optional GitLab token with read access to private projects, pipelines, jobs, and traces
  • HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST Comma-separated self-hosted GitLab HTTPS origins allowed for monitoring
  • HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST Comma-separated private HTTP(S) origins allowed only in the full runtime profile

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server MCP Health Monitor for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "health-monitor": { "type": "stdio", "command": "npx", "args": [ "-y", "health-monitor-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the MCP Health Monitor tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use MCP Health Monitor and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using MCP Health Monitor or shows a MCP Health Monitor tool in the answer, you are connected

8 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • HEALTH_MONITOR_DB Custom path for the SQLite database
  • HEALTH_MONITOR_AUTO_CHECK Set to '1' to enable background scheduled checks
  • HEALTH_MONITOR_RETENTION_DAYS Number of days to retain health check history
  • HEALTH_MONITOR_MAX_CONCURRENCY Maximum concurrent scheduled and interactive server checks
  • GITHUB_TOKEN Optional GitHub token with Actions read access for private repositories and higher API rate limits
  • GITLAB_TOKEN Optional GitLab token with read access to private projects, pipelines, jobs, and traces
  • HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST Comma-separated self-hosted GitLab HTTPS origins allowed for monitoring
  • HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST Comma-separated private HTTP(S) origins allowed only in the full runtime profile

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use MCP Health Monitor💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user health-monitor -- npx -y health-monitor-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "health-monitor": {
      "command": "npx",
      "args": [
        "-y",
        "health-monitor-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "health-monitor": {
      "command": "npx",
      "args": [
        "-y",
        "health-monitor-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "health-monitor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "health-monitor-mcp"
      ]
    }
  }
}

Values you fill in

  • HEALTH_MONITOR_DB env
    Custom path for the SQLite database
  • HEALTH_MONITOR_AUTO_CHECK env
    Set to '1' to enable background scheduled checks
  • HEALTH_MONITOR_RETENTION_DAYS env
    Number of days to retain health check history
  • HEALTH_MONITOR_MAX_CONCURRENCY env
    Maximum concurrent scheduled and interactive server checks
  • GITHUB_TOKEN secret env
    Optional GitHub token with Actions read access for private repositories and higher API rate limits
  • GITLAB_TOKEN secret env
    Optional GitLab token with read access to private projects, pipelines, jobs, and traces
  • HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST env
    Comma-separated self-hosted GitLab HTTPS origins allowed for monitoring
  • HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST env
    Comma-separated private HTTP(S) origins allowed only in the full runtime profile

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
120/wk
Connection
Runs on your computer
Latest versioni
1.4.0
Published to registryi
Jul 23, 2026
Code last changedi
Oct 24, 2026
Maker
oaslananka
Packages
npm: health-monitor-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 21, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account oaslananka, which owns the repo

  • ✕ Fail

    Still maintained

    No code changes for over a year, or the repo is archived

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for health-monitor-mcp@1.4.0

Checks only this package version, not every dependency · checked Nov 16, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/oaslananka-health-monitor-mcp.svg)](https://mcp.popnx.com/en/servers/oaslananka-health-monitor-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Clinics & healthi

  • More stars than 89% of the other 1202 servers in this category
  • Published to the registry more recently than 19% of the other 1202 servers in this category
  • Basic checks equal to or better than 52% of the other 1202 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is MCP Health Monitor safe?

It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 28 days ago, and the latest version (1.4.0) reached the registry 4 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Medplum MCP, Mirobody, Codescene MCP Server, Marrow, WHOOP — MissingMCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Medplum MCP

Securely access and manage FHIR healthcare data stored in Medplum.

by medplumWidely used★ 2.8KUpdated 4 months ago

Runs in the cloud✓ service owner · medplum.com

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

by thetahealthGrowing↓ 725/wk★ 1.6KUpdated 2 days ago

Runs on your computer✓ thetahealth.ai

Codescene MCP Server

An MCP server that provides CodeScene Code Health analysis tools.

by codescene-ossGrowing↓ 3.8K/wk★ 85Updated 8 months ago

Runs on your computer✓ service owner · codescene.com

Marrow

Marrow Health: your Apple Health data over MCP, from the free iOS app. Reads, and writes on demand.

by skeletonarmytechEarly↓ 62/wk★ 5Updated 30 days ago

Runs on your computer✓ skeletonarmy.tech
Compared with similar ones
This one
MCP Health Monitor
Medplum MCPMirobodyCodescene MCP ServerMarrowWHOOP — MissingMCP
Runs whereInstalls on your computerRuns in the cloud, nothing to installInstalls on your computerInstalls on your computerInstalls on your computerRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks2/34/43/32/33/32/4
LicenseMITApache-2.0Apache-2.0NOASSERTIONMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

health-monitor-mcp

MCP server, CI workflow, and generic HTTP endpoint monitoring with health history, TLS expiry, assertions, diagnostics, and operational reports.

What This Does

health-monitor-mcp keeps local registries of MCP servers, GitHub Actions workflows, GitLab pipelines, and generic HTTP endpoints. It performs live checks, records bounded evidence in SQLite, evaluates MCP alert thresholds, and returns JSON or Markdown diagnostics suitable for agents and operators.

Supported target transports:

  • Streamable HTTP for current remote MCP servers.
  • SSE for legacy MCP servers.
  • stdio for trusted local executables after explicit opt-in.
  • GitHub Actions workflow runs, failed jobs, and failed steps for public or private repositories.
  • GitLab CI/CD pipelines, failed jobs, stages, refs, commits, URLs, and bounded trace excerpts for GitLab.com or allowlisted self-hosted instances.
  • Generic HTTP/HTTPS endpoints with status, header, body-substring, JSON-value, redirect, latency, and TLS-expiry checks.

Azure DevOps monitoring was retired in v1.1.0. GitHub Actions shipped in v1.2.0 and GitLab CI/CD in v1.3.0; generic HTTP/TLS monitoring completes the current multi-provider feature line.

Quick Start

Run the published package noninteractively with Node.js 24:

npx -y health-monitor-mcp --version

Example MCP client configuration:

{

"mcpServers": { "health-monitor": { "command": "npx", "args": ["-y", "health-monitor-mcp"] } } }

Tools

ToolPurposeTypical prompt
register_serverRegister an MCP targetRegister inventory-prod
check_serverRun one MCP health checkCheck inventory-prod now
register_github_actionsRegister a GitHub workflowMonitor ci.yml in owner/repo
check_github_actionsCheck latest GitHub run and failed job/step diagnosticsCheck repo-ci now
register_gitlab_pipelineRegister a GitLab project pipelineMonitor group/project on GitLab
check_gitlab_pipelineCheck latest pipeline and bounded failed-job tracesCheck gitlab-ci now
register_http_targetRegister a GET-only HTTP/HTTPS endpointMonitor the public health endpoint
check_http_targetCheck response assertions and TLS expiryCheck service-health now
register_webhookRegister a webhook target for alert deliveryRegister alert-webhook for notifications
test_webhookSend a test payload and return delivery diagnosticsTest alert-webhook delivery
check_allCheck all target kinds with bounded concurrencyCheck all production targets
get_uptimeReturn MCP uptime and latency historyShow 24h uptime for inventory-prod
get_dashboardReturn a cross-provider JSON dashboardGive me a 24h dashboard
get_reportReturn a cross-provider Markdown reportGenerate a 24h health report
list_serversList registered MCP targetsList monitored MCP servers
list_github_actionsList registered GitHub workflow targetsList monitored workflows
list_gitlab_pipelinesList registered GitLab pipeline targetsList monitored GitLab pipelines
list_http_targetsList registered HTTP targetsList monitored HTTP endpoints
list_webhooksList registered webhook targetsList webhook targets
unregister_serverRemove an MCP targetStop monitoring local-debugger
unregister_github_actionsRemove a GitHub target and its historyStop monitoring repo-ci
unregister_gitlab_pipelineRemove a GitLab target and its historyStop monitoring gitlab-ci
unregister_http_targetRemove an HTTP target and its historyStop monitoring service-health
unregister_webhookRemove a webhook target and its historyStop monitoring alert-webhook
set_alertConfigure MCP health thresholdsAlert if inventory-prod exceeds 500ms
get_monitor_statsInspect cross-provider monitor activityHow many checks are stored?

Expected configuration mistakes return stable error codes and remediation hints, including SERVER_NOT_FOUND, GITHUB_ACTIONS_TARGET_NOT_FOUND, GITLAB_PIPELINE_TARGET_NOT_FOUND, GITLAB_BASE_URL_NOT_ALLOWED, HTTP_TARGET_NOT_FOUND, HTTP_TARGET_URL_NOT_ALLOWED, NO_SERVERS_REGISTERED, STDIO_DISABLED, STDIO_COMMAND_REJECTED, WEBHOOK_ENCRYPTION_KEY_REQUIRED, WEBHOOK_REGISTRATION_FAILED, and WEBHOOK_NOT_FOUND.

Register Targets

Streamable HTTP:

register_server name="inventory-prod" type="http" url="https://inventory.example.com/mcp" tags=["production","inventory"]

Legacy SSE:

register_server name="legacy-search" type="sse" url="https://search.example.com/sse" tags=["legacy"]

Trusted local stdio:

export HEALTH_MONITOR_ALLOW_STDIO=1

export HEALTH_MONITOR_STDIO_ALLOWLIST=npx,node

register_server name="local-debugger" type="stdio" command="npx" args=["-y","mcp-debug-recorder"] tags=["local"]

The command field must contain one executable only. Put package names and flags in args. Remote-safe runtime profiles always disable stdio.

Register GitHub Actions

Public repositories can be checked without authentication. Private repositories and higher API rate limits require a token with Actions read access:

export GITHUB_TOKEN=your-runtime-secret
register_github_actions name="repo-ci" owner="oaslananka" repository="health-monitor-mcp" workflow="ci.yml" branch="main" token_env="GITHUB_TOKEN" tags=["production","ci"]

check_github_actions name="repo-ci" timeout_ms=5000

Only the environment-variable name in token_env is stored. The token value is read at check time and is never written to SQLite, logs, reports, or tool responses.

Register GitLab Pipelines

Public GitLab.com projects can be checked without authentication. Private projects require a token exposed only through the runtime environment:

export GITLAB_TOKEN=your-runtime-secret
register_gitlab_pipeline name="gitlab-ci" project="group/project" ref="main" token_env="GITLAB_TOKEN" tags=["production","ci"]

check_gitlab_pipeline name="gitlab-ci" timeout_ms=5000

GitLab.com is allowed by default. A self-hosted instance must use an HTTPS origin and be explicitly allowed:

export HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST=https://gitlab.internal.example
register_gitlab_pipeline name="private-gitlab" base_url="https://gitlab.internal.example" project="platform/service" token_env="GITLAB_TOKEN"

Only token_env is persisted. Token values, response bodies, and full traces are never stored or returned. Failed-job trace excerpts are range-requested, sanitized, and bounded.

Register HTTP Targets

Public HTTP and HTTPS endpoints are allowed by default. The provider sends GET requests only and supports bounded status, header, body-substring, JSON scalar, and TLS-expiry assertions:

register_http_target name="service-health" url="https://status.example.com/health" expected_statuses=[200] header_assertions=[{"name":"x-ready","equals":"yes"}] body_contains=["ready"] json_assertions=[{"path":"status","equals":"ready"}] tls_expiry_days=30 tags=["production","http"]

check_http_target name="service-health" timeout_ms=5000

Private, loopback, link-local, and other non-public addresses are blocked. A trusted private origin is available only in the full runtime profile and must be explicitly listed:

export HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST=https://status.internal.example:8443

Every DNS answer and every redirect destination is revalidated. Responses are capped at 262144 bytes; full response bodies and certificate chains are never stored or returned.

Register Webhook Targets

Webhook targets receive alert notifications via HTTPS POST with optional HMAC-SHA256 signing. Secrets are encrypted at rest when HEALTH_MONITOR_WEBHOOK_ENCRYPTION_KEY is configured (32+ characters); otherwise secret registration is rejected.

register_webhook name="alert-webhook" url="https://hooks.example/alerts" secret="webhook-secret" events=["down","alert"] tags=["production","alerts"]

test_webhook name="alert-webhook"

Secrets are never returned in listings or diagnostics—always redacted. Delivery diagnostics include status, latency, HTTP status code, and error message.

Health Checks and Reports

check_server name="inventory-prod" timeout_ms=5000

check_all timeout_ms=5000 tags=["production"] get_uptime name="inventory-prod" hours=24 get_dashboard hours=24 include_tool_stats=true get_report hours=24

HEALTH_MONITOR_MAX_CONCURRENCY limits MCP, GitHub Actions, GitLab, and HTTP checks through one shared scheduled and interactive queue. Results preserve MCP-then-GitHub-then-GitLab-then-HTTP registration order even when checks complete out of order.

Alerts

set_alert name="inventory-prod" max_response_time_ms=500 min_uptime_percent=99 consecutive_failures_before_alert=2

Alert findings are evaluated by check_server, check_all, and get_dashboard. Configure webhook targets with register_webhook to receive alert notifications.

Configuration

VariableDefaultPurpose
HEALTH_MONITOR_DB~/.mcp-health-monitor/health.dbSQLite database path
HEALTH_MONITOR_AUTO_CHECK0Enable scheduled checks with 1
HEALTH_MONITOR_RETENTION_DAYS30Health-history retention

| HEALTH_MONITOR_MAX_CONCURRENCY

Only the beginning is shown; read the rest in the repo