---
title: "MCP server health"
method: GET
path: "/v1/mcp-servers/health"
tags: ["MCP"]
---

# MCP server health

`GET /v1/mcp-servers/health`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/mcp-servers/health`
- Auth: HTTP bearer

Per-server runtime metrics including restart count and last failure reason.

## Response `200`

Health snapshot

- object
  - `servers` object[], required
    - `name` string, required
    - `registryID` string, nullable
    - `transport` 'stdio' | 'http-sse', required
    - `status` 'running' | 'starting' | 'failed' | 'stopped' | 'not_started', required
    - `toolCount` integer, required
    - `restartCount` integer, required
    - `reason` string, nullable

## Other responses

- `503`: Server store not initialized

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)