--- title: "Overall MCP health" method: GET path: "/mcp/health" tags: ["MCP Connectors"] --- # Overall MCP health `GET /mcp/health` ## Request - Base URL: `https://agent.getaxonflow.com` - URL: `https://agent.getaxonflow.com/mcp/health` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) Unauthenticated liveness probe. ⚠️ **`healthy_count` + `unhealthy_count` do not sum to `total_connectors`, by design** (`platform/agent/mcp_handler.go:3377-3405`). Because this route is anonymous, the live health checks it performs are limited to the **deployment-shared** (operator-configured, wildcard-tenancy `*`) connectors, while `total_connectors` keeps its pre-existing deployment-wide meaning so operator dashboards do not silently change scale. A deployment consisting only of tenant-owned connectors therefore reports `healthy: true` with zero counts even if every backend is down. Use the authenticated `GET /mcp/connectors` for per-tenant connector health. *(Behaviour change in #3067: this route previously opened a live connection to **every** tenant's backend on every anonymous GET — cross-tenant credential use plus a free amplification lever.)* ## Response `200` MCP system health - object - `healthy` boolean: True when no deployment-shared connector reported unhealthy. Says nothing about tenant-owned connectors. - `total_connectors` integer: Deployment-wide cached-connector count (`registry.Count()`) — a different scale from the two counts below. - `healthy_count` integer: Healthy **deployment-shared** connectors only - `unhealthy_count` integer: Unhealthy **deployment-shared** connectors only - `timestamp` string, date-time ## Other responses - `503`: MCP registry not initialized --- [API](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/revisions/34d30fcb7fa1?raw)