Skip to main content
Uninstall a catalog agent from a project by revoking its agent access grant

Tool details

FieldValue
Nameuninstall_agent
GroupAgents

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "minLength": 1,
      "description": "Project identifier or slug that scopes the tool call."
    },
    "agent_id": {
      "type": "string",
      "minLength": 1,
      "description": "Provide the agent id."
    },
    "grant_scope": {
      "type": "string",
      "enum": [
        "project",
        "owner_projects"
      ],
      "description": "Provide the grant scope.",
      "default": "project"
    }
  },
  "required": [
    "project_reference",
    "agent_id"
  ],
  "additionalProperties": false,
  "description": "Input schema for the uninstall_agent tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

Output schema
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "const": true,
      "description": "Whether the operation completed successfully."
    },
    "id": {
      "type": "string",
      "description": "Unique identifier for the record."
    }
  },
  "required": [
    "success",
    "id"
  ],
  "additionalProperties": false,
  "description": "Structured delete agent output schema for MCP tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}