Gradescope MCP Server

Instructions

**WARNING**: Changes cascade to ALL submissions with this item applied.

Args:
    course_id: The Gradescope course ID.
    question_id: The question ID.
    rubric_item_id: The rubric item ID to update.
    description: New description, or None to keep unchanged.
    weight: New point value, or None to keep unchanged.
    confirm_write: Must be True to apply the update.

Implementation Reference

• src/gradescope_mcp/tools/grading_ops.py:807-835 (handler)

  The actual logic for updating a rubric item.

  def update_rubric_item(
      course_id: str,
      question_id: str,
      rubric_item_id: str,
      description: str | None = None,
      weight: float | None = None,
      confirm_write: bool = False,
  ) -> str:
      """Update an existing rubric item's description or weight.
  
      **WARNING**: Changes cascade to ALL submissions that have this item applied.
      Updating the weight will immediately change every affected student's score.
  
      Args:
          course_id: The Gradescope course ID.
          question_id: The question ID.
          rubric_item_id: The rubric item ID to update.
          description: New description, or None to keep unchanged.
          weight: New point value, or None to keep unchanged.
          confirm_write: Must be True to apply the update.
      """
      if not course_id or not question_id or not rubric_item_id:
          return "Error: course_id, question_id, and rubric_item_id are required."
  
      if description is None and weight is None:
          return "Error: at least one of description or weight must be provided."
  
      if not confirm_write:
          details = [

• src/gradescope_mcp/server.py:505-527 (registration)

  The MCP tool registration for 'tool_update_rubric_item', which delegates to the 'update_rubric_item' helper function.

  def tool_update_rubric_item(
      course_id: str,
      question_id: str,
      rubric_item_id: str,
      description: str | None = None,
      weight: float | None = None,
      confirm_write: bool = False,
  ) -> str:
      """Update an existing rubric item's description or weight.
  
      **WARNING**: Changes cascade to ALL submissions with this item applied.
  
      Args:
          course_id: The Gradescope course ID.
          question_id: The question ID.
          rubric_item_id: The rubric item ID to update.
          description: New description, or None to keep unchanged.
          weight: New point value, or None to keep unchanged.
          confirm_write: Must be True to apply the update.
      """
      return update_rubric_item(
          course_id, question_id, rubric_item_id, description, weight, confirm_write
      )