<!--
  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_instructions

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


# get_agent_instructions

**Decisions the human made in immut**

Decisions a person made in the immut app that YOU must now carry out. CALL THIS AT THE START OF EVERY SWEEP, before you look at any files. `protect` = upload that path on this sweep; `reject` = leave it alone and record the decision declined_by_human. These are the human's answers about files they were shown; do not second-guess them. Mark each one done with ack_agent_instruction once you have actually acted — not when you have read it. Read-only.

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

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `status` | `pending` \| `applied` \| `cancelled` | no | Defaults to pending, which also excludes instructions that have expired |

## Tool contract

```json
{
  "name": "get_agent_instructions",
  "title": "Decisions the human made in immut",
  "description": "Decisions a person made in the immut app that YOU must now carry out. CALL THIS AT THE START OF EVERY SWEEP, before you look at any files. `protect` = upload that path on this sweep; `reject` = leave it alone and record the decision declined_by_human. These are the human's answers about files they were shown; do not second-guess them. Mark each one done with ack_agent_instruction once you have actually acted — not when you have read it. Read-only.",
  "access": "read",
  "destructive": false,
  "hostedOnProduction": true,
  "restEndpoint": "/api/v1/agent/instructions",
  "arguments": {
    "status": {
      "type": "enum",
      "required": false,
      "description": "Defaults to pending, which also excludes instructions that have expired",
      "values": [
        "pending",
        "applied",
        "cancelled"
      ]
    }
  }
}
```