---
title: "Check connector health"
method: GET
path: "/mcp/connectors/{name}/health"
tags: ["MCP Connectors"]
---

# Check connector health

`GET /mcp/connectors/{name}/health`

## Request

- Base URL: `https://agent.getaxonflow.com`
- URL: `https://agent.getaxonflow.com/mcp/connectors/{name}/health`
- Auth: one of:
  - HTTP basic
  - API key in header `X-Internal-Service-ID` and API key in header `X-Internal-Service-Token`
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/docs/mcp/connectors/:name/health/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns health status for one of the **authenticated tenant's**
connectors (or a deployment-shared one).

Naming another tenant's connector returns the same `404` as a
nonexistent one — there is no existence oracle, and no live
connection is opened with the other tenant's credentials
(`platform/agent/mcp_handler.go:665-676`).

**Authentication.** Wrapped in `apiAuthMiddleware`
(`platform/agent/mcp_handler.go:584`), `GET` only.

*(Behaviour change in #3067: this route was previously registered
with no auth middleware, so an anonymous caller could name any
tenant's connector and have the agent open a live connection with
that tenant's decrypted credentials.)*

## Path parameters

- `name` string, required

## Response `200`

Connector health status

- ConnectorHealthResponse
  - `healthy` boolean
  - `latency_ms` integer
  - `last_check` string, date-time
  - `error` string

## Other responses

- `401`: Missing or invalid authentication. Handler-written 401s use the `{success, error}` envelope; 401s written by the auth middleware use the `{"error": {"code", "message"}}` envelope (JSONError).
- `404`: Connector not found **within the caller's tenancy**. Returned both for a name that does not exist and for a name that belongs to another tenant.
- `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)