MCP Recover

Inspect unresolved external effects and take bounded recovery actions.

This reference is generated from Crewhelm’s authenticated MCP catalog and progressive operation schemas. Tool availability does not grant authority; every call is subject to the authenticated owner, approved OAuth scopes, and current control-plane policy.

Read tools

Inspect state and obtain exact references without changing it.

crewhelm_inspect_recovery

Inspect Crewhelm recovery

Inspect bounded unresolved external effects that require independent provider verification before recovery.

Attributes: read-only, non-destructive, idempotent, closed-world.

How to use this tool:

1. Send {"request":"operations"} to list its subtools.
2. Send {"request":"schema","name":"…"} for one subtool’s exact inputs.
3. Send {"request":"execute","name":"…","input":{…}} to run it.

Subtool	Purpose
unresolved_effects	List unresolved external tool effects that require independent verification.

unresolved_effects

List unresolved external tool effects that require independent verification.

Input	Required	Type	Details
cursor	No	string	pattern: ^tool_call_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
limit	No	integer	minimum: 1; maximum: 25; default: 10

View exact JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "pattern": "^tool_call_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "additionalProperties": false
}

Write tools

Preview or perform bounded changes under the required owner authority.

crewhelm_recover

Recover Crewhelm

Reconcile independently verified provider effects or revoke exact authority.

Attributes: write, destructive, idempotent, closed-world.

How to use this tool:

1. Send {"request":"operations"} to list its subtools.
2. Send {"request":"schema","name":"…"} for one subtool’s exact inputs.
3. Send {"request":"execute","name":"…","input":{…}} to run it.

Subtool	Purpose
reconcile_effect	Record an independently verified external tool effect as applied or not applied.
disable_agent	Immediately disable one exact Agent.
revoke_connection	Permanently revoke one exact provider or remote MCP Connection.
revoke_capability	Permanently revoke one exact Agent capability grant.

reconcile_effect

Record an independently verified external tool effect as applied or not applied.

Input	Required	Type	Details
effect	Yes	object	—
resolution	Yes	“applied” | “not_applied”	—

View exact JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "effect": {
      "type": "object",
      "properties": {
        "toolCallId": {
          "type": "string",
          "pattern": "^tool_call_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
        }
      },
      "required": [
        "toolCallId"
      ],
      "additionalProperties": {}
    },
    "resolution": {
      "type": "string",
      "enum": [
        "applied",
        "not_applied"
      ]
    }
  },
  "required": [
    "effect",
    "resolution"
  ],
  "additionalProperties": false
}

disable_agent

Immediately disable one exact Agent.

Input	Required	Type	Details
agent	Yes	object	Copy-ready Agent identity returned by Crewhelm.

View exact JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "agent": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^agent_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
        }
      },
      "required": [
        "id"
      ],
      "additionalProperties": {},
      "description": "Copy-ready Agent identity returned by Crewhelm."
    }
  },
  "required": [
    "agent"
  ],
  "additionalProperties": false
}

revoke_connection

Permanently revoke one exact provider or remote MCP Connection.

Input	Required	Type	Details
connection	Yes	object | object	—

View exact JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "connection": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^connection_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": {}
        },
        {
          "type": "object",
          "properties": {
            "connectionId": {
              "type": "string",
              "pattern": "^connection_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            }
          },
          "required": [
            "connectionId"
          ],
          "additionalProperties": {}
        }
      ]
    }
  },
  "required": [
    "connection"
  ],
  "additionalProperties": false
}

revoke_capability

Permanently revoke one exact Agent capability grant.

Input	Required	Type	Details
grant	Yes	object	—

View exact JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "grant": {
      "type": "object",
      "properties": {
        "grantId": {
          "type": "string",
          "pattern": "^grant_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
        }
      },
      "required": [
        "grantId"
      ],
      "additionalProperties": {}
    }
  },
  "required": [
    "grant"
  ],
  "additionalProperties": false
}