Skip to main content
Glama
Mhdd-24

@mhdd_24/api-health-mcp

by Mhdd-24

@mhdd_24/api-health-mcp

Endpoint availability and health checks.

Same architecture as @mhdd_24/sublime-mcp.

Full documentation: docs/WIKI.md


How it works (30 seconds)

You (chat) → MCP client → api-health-mcp → API Health APIs / CLIs / local tools

Related MCP server: ssl-doctor

Prerequisites

Requirement

Notes

Node.js 18+

ESM TypeScript MCP server

Credentials / CLIs

See environment variables below


Install

Option A — npm (after publish)

npm install -g @mhdd_24/api-health-mcp

Option B — npx

npx @mhdd_24/api-health-mcp

Option C — clone and build

git clone https://github.com/Mhdd-24/API-Health-MCP.git
cd API-Health-MCP
npm install
npm run build
node dist/index.js

Configure Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "apihealth": {
      "command": "npx",
      "args": ["-y", "@mhdd_24/api-health-mcp"],
      "env": {
        "PROJECT_ROOT": "..."
      }
    }
  }
}

Local development:

{
  "command": "node",
  "args": ["/absolute/path/to/API-Health-MCP/dist/index.js"]
}

Environment variables

Variable

Description

PROJECT_ROOT

Default project/repository root


Tools

Tool

Description

apihealth_status

Show API health defaults.

apihealth_check

HTTP health check for a URL.

apihealth_check_many

Check multiple URLs.


License

ISC

Available Tools

3 tools
apihealth_checkB

HTTP health check for a URL.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYesURL

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It reveals that an HTTP health check is performed, but it does not disclose timeout behavior, redirects, error handling, authentication needs, side effects, or what constitutes a healthy result. This is a minimal disclosure for a network operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single front-loaded sentence with no filler. Every word earns its place, and the core purpose is immediately visible.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with one fully documented parameter, but there is no output schema and no annotations. The description says what the tool does but omits return-value semantics and operational details like timeout or failure behavior, which an agent might need to correctly interpret results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with the only parameter 'url' described as 'URL'. The description adds little beyond what the schema already provides, so the baseline score of 3 is appropriate; it does not introduce format, restrictions, or example values.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific operation ('HTTP health check') and resource ('a URL'), so an agent can tell it performs a network health check on a single target. It does not explicitly differentiate from siblings like apihealth_check_many or apihealth_status, but the singular 'a URL' provides some distinction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit when-to-use or when-not-to-use guidance is given, and no alternatives are named. The singular phrasing implies this is for one URL rather than many (apihealth_check_many), but the routing is left to inference rather than stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

apihealth_check_manyC

Check multiple URLs.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlsYesNewline-separated URLs

TDQS

C2.4/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure, but it only says 'Check multiple URLs.' It does not disclose network behavior, side effects, timeouts, error handling, output format, or whether any state is changed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The text is extremely brief, but this is under-specification rather than effective conciseness. The description provides almost no useful structure or context beyond what can be inferred from the tool name itself.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema and no annotations, yet the description does not explain what 'check' returns, how success/failure is represented, or any limitations. An agent could construct a request but would not be able to interpret or validate the result.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter is already fully described in the schema as 'Newline-separated URLs,' so the description adds no extra semantic meaning. Baseline 3 applies because schema description coverage is 100%.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a clear verb-resource pair ('Check multiple URLs') and the plural 'multiple' distinguishes it from sibling apihealth_check. However, 'check' is generic and does not explain what kind of check (health, status, reachability) is performed or how it relates to apihealth_status.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus apihealth_check or apihealth_status. The plural wording implies batch usage, but that is left to inference rather than explicitly stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

apihealth_statusB

Show API health defaults.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry the behavioral disclosure burden. 'Show' implies a read-only operation, but the description does not state what the tool returns, whether it performs any network calls, or how defaults are structured. The lack of an output schema makes this gap more significant.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single short sentence with no superfluous words. It front-loads the core action and resource, making it highly skimmable for an agent.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no annotations and no output schema, this description is too sparse. It does not define what 'API health defaults' are, what the response will contain, or how this tool relates to apihealth_check and apihealth_check_many, leaving an agent uncertain about its appropriate use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, so the 0-param baseline of 4 applies. The description adds nothing about parameters, but none are needed; the word 'defaults' does not imply additional arguments.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'Show' and targets the resource 'API health defaults,' which conveys a clear action and object. However, 'defaults' is somewhat ambiguous and doesn't explicitly contrast with the sibling tools apihealth_check and apihealth_check_many.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives no guidance on when to call this tool versus its siblings. There are no explicit conditions, alternatives, or exclusions, so the agent must infer usage entirely from the name and the word 'defaults.'

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 3 tool updatesv1.0.0
    • First observedapihealth_check
    • First observedapihealth_check_many
    • First observedapihealth_status

TDQS

B3.3/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: showing defaults, checking a single URL, and checking multiple URLs. There is no overlap in scope, so an agent can easily select the correct tool.

Naming Consistency5/5

All tools follow the consistent 'apihealth_' prefix followed by a verb-like descriptor (status, check, check_many). The naming pattern is uniform and intuitive.

Tool Count5/5

With 3 tools covering the core health-check operations, the count is well-scoped for the server's narrow purpose. It is neither sparse nor excessive.

Completeness4/5

The toolset covers checking one or multiple URLs and viewing defaults, which covers the primary workflow. A minor gap is the lack of a way to modify defaults, but this is not essential for typical health-check usage.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Enables live website health checks including TLS, HTTPS, and security headers, returning an A-F grade with specific fixes.
    2
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables live TLS/SSL certificate health checks for any hostname, providing expiry, hostname match, trust verdict, and a health score. Supports both free and paid deep tiers with protocol/cipher analysis.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to query and monitor service status, latency, and performance through configurable checks (HTTP, TCP, SSL, keyword, JSON-path) and exposes tools for listing services, retrieving metrics, and running on-demand checks.
    Apache 2.0