---
title: "Check agent MCP-server health"
method: GET
path: "/v1/fleet/agents/{agent_id}/health"
tags: ["agents"]
---

# Check agent MCP-server health

`GET /v1/fleet/agents/{agent_id}/health`

Returns a per-MCP-server health summary for the agent. Each MCP
server referenced by the agent (its tools.json plus every
subagent's tools.json) is probed in parallel by issuing a single
MCP initialize JSON-RPC call. Credentials are resolved per
(tenant, server) using the configured authentication method.
Per-server failures surface as
`ok=false` with an `error_code` (auth_failed | unreachable |
invalid_response) and a human-readable `error` string.
`mcp_check.ok` is `true` only when every server returns a
healthy response; an empty server list is treated as healthy.

## Path parameters

- `agent_id` string, uuid, required

## Response `200`

OK

- AgentsHealthResponse
  - `agent_id` string
  - `checked_at` string, date-time
  - `mcp_check` AgentsMCPCheck
    - `ok` boolean
    - `servers` AgentsMCPServerHealth[]
      - `error` string
      - `error_code` 'auth_failed' | 'unreachable' | 'invalid_response'
      - `is_default` boolean
      - `name` string
      - `ok` boolean
      - `url` string

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/a0acb3a6a101/schema)