tool_update_rubric_item
Modify rubric item descriptions or point values in Gradescope, with changes applying to all affected submissions after confirmation.
Instructions
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.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| course_id | Yes | ||
| question_id | Yes | ||
| rubric_item_id | Yes | ||
| description | No | ||
| weight | No | ||
| confirm_write | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- 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 )