<!--
  immut documentation, machine-readable.

  Everything in one file:  https://www.immut.io/llms-full.txt
    What immut is, which integration path to choose, authentication and scopes, and the COMPLETE
    API reference: every endpoint with parameters, responses and a runnable curl. Fetch this first
    if you intend to call the API.

  Index of all pages:      https://www.immut.io/llms.txt
  OpenAPI contract:        https://www.immut.io/docs/openapi.json
  This page as HTML:       https://www.immut.io/docs/mcp/get_agent_status

  Any page on this site is available as raw markdown by appending .md to its URL.
-->


# get_agent_status

**Has immut heard from this agent?**

Whether immut has heard from this organisation's agent recently. Returns hasEverRun, lastRunAt, silentDays, thresholdDays and isAbsent. ⚠️ lastRunAt is when immut last HEARD from the agent, which is NOT when it last ran: a sweep that ran and failed to report looks identical to one that never happened. So this tells you whether reporting is working — never present it as evidence that any particular file is or is not protected. Read-only.

- Access: read-only
- Calls: `/api/v1/agent/status`

Takes no arguments.

## Tool contract

```json
{
  "name": "get_agent_status",
  "title": "Has immut heard from this agent?",
  "description": "Whether immut has heard from this organisation's agent recently. Returns hasEverRun, lastRunAt, silentDays, thresholdDays and isAbsent. ⚠️ lastRunAt is when immut last HEARD from the agent, which is NOT when it last ran: a sweep that ran and failed to report looks identical to one that never happened. So this tells you whether reporting is working — never present it as evidence that any particular file is or is not protected. Read-only.",
  "access": "read",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/agent/status",
  "arguments": {}
}
```