> For the complete documentation index, see [llms.txt](https://docs.autommate.com/userguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/agents-get-health.md).

# agents\_get\_health — Inspect Mate Agent health

**Declared contract — reviewed 21 October 2026.** This page describes the tool exposed by the Autom Mate New connection in the inspected 71-tool profile. It does not establish support on every build or prove runtime success. Check the active connection and [installed product version](https://docs.autommate.com/userguide/start-here/documentation-scope-and-product-versions.md). Historical examples retain their original observation dates. Logical tool names may have a client-specific namespace prefix.

Inspect Mate Agent execution-host health using recent metrics. Set `live_check: true` only when a live reachability probe is needed.

## Declared request signature

The following is the exposed 21 October declaration; request types do not define an exhaustive response schema.

```ts
declare const tools: { mcp__codex_apps__autom_mate_new_agents_get_health(args: { cursor?: string; live_check?: boolean; page_size?: number; }): Promise<CallToolResult>; };
```

## Parameters

| Parameter    | Type    | Required | Meaning                                                                                                                   |
| ------------ | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `live_check` | boolean | No       | Request a live reachability probe. Without that probe, interpret health as recent metrics rather than a live socket test. |
| `page_size`  | number  | No       | Requested page size; no bounds or default are published in the exposed schema.                                            |
| `cursor`     | string  | No       | Returned pagination cursor.                                                                                               |

## Minimal request

This explicitly requests the recent-metrics view. A live probe checks reachability; it is not a flow execution or destination-credential test.

```json
{
  "live_check": false
}
```

## Read the result

* Without a live probe, the health result is based on recent metrics, not a live socket test.
* A healthy Mate Agent does not mean Hyperflows are completing successfully. This tool covers hosts, not run outcomes, credentials or queues.
* Shared deployments may list agents outside the connected tenant. Preserve the returned scope instead of attributing every host to the tenant.
* For another page, keep the same filters and pass the returned cursor unchanged. Treat the cursor as opaque; stop when no continuation is returned. The first page need not be the complete result set.

## Permissions and retries

Use only agents exposed by the authorized connection. Avoid repeated live probes when a recent health read is sufficient; follow any returned limits. Repeating a health check does not repair a host or retry an execution.

## Present a requested result

When the user asked to see this result, pass the returned `result_ref` to `show_result` once for the final requested answer. Do not show cards for intermediate lookups. A result reference expires after 15 minutes; read again if it has expired. This presentation step neither executes nor verifies a business action.

## Continue

* Next tools: [`runs_search`](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/runs-search) · [`runs_get_latest_error`](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/runs-get-latest-error) · [`credentials_search`](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/credentials-search).
* Workflow: [Inspection tool contracts](https://docs.autommate.com/userguide/mcp-and-ai-reference/inspection-tool-contracts.md).
* Worked reference: [Read platform summaries schedules and agent health](https://docs.autommate.com/userguide/mcp-and-ai-reference/read-platform-summaries-schedules-and-agent-health.md).
* [MCP tool reference](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools).
