mcp-keycloak

Instructions

Remove a user from a group.

Args:
    user_id: User ID
    group_id: Group ID
    realm: Target realm (uses default if not specified)

Returns:
    Status message

Implementation Reference

• src/tools/group_tools.py:191-212 (handler)

  The handler function decorated with @mcp.tool(), which registers the tool and defines the input schema via type hints. It removes the user from the group by making a DELETE request to Keycloak API.

  @mcp.tool()
  async def remove_user_from_group(
      user_id: str, group_id: str, realm: Optional[str] = None
  ) -> Dict[str, str]:
      """
      Remove a user from a group.
  
      Args:
          user_id: User ID
          group_id: Group ID
          realm: Target realm (uses default if not specified)
  
      Returns:
          Status message
      """
      await client._make_request(
          "DELETE", f"/users/{user_id}/groups/{group_id}", realm=realm
      )
      return {
          "status": "removed",
          "message": f"User {user_id} removed from group {group_id}",
      }