Revoke App Share

Revoke another user's access to one of your apps — removes a pending invitation or an accepted collaborator grant.

MCP name: unshare_app

Tool contract

{
  "annotations": {
    "destructiveHint": true,
    "openWorldHint": true,
    "readOnlyHint": false,
    "title": "Revoke App Share"
  },
  "description": "Revoke another user's access to one of your apps — removes a pending invitation or an accepted collaborator grant. Use this when the user wants to withdraw an invitation or remove a collaborator. Takes effect immediately for new requests. Idempotent: revoking a grant that does not exist is a no-op.",
  "execution": {
    "taskSupport": "forbidden"
  },
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "properties": {
      "app_id": {
        "description": "The app ID (UUID) to revoke access on",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "type": "string"
      },
      "grantee": {
        "description": "The grantee's Charming handle or account email",
        "minLength": 1,
        "type": "string"
      }
    },
    "required": [
      "app_id",
      "grantee"
    ],
    "type": "object"
  },
  "name": "unshare_app",
  "outputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "ok": {
        "const": true,
        "description": "Indicates success. Errors arrive as content with isError:true.",
        "type": "boolean"
      },
      "removed": {
        "description": "True when a pending invitation or active grant was removed; false when there was nothing to remove (idempotent no-op).",
        "type": "boolean"
      }
    },
    "required": [
      "ok",
      "removed"
    ],
    "type": "object"
  }
}