get_my_peer_reviews_todo
Retrieve pending peer reviews assigned to you in Canvas courses, optionally filtered by specific course, to help you complete required evaluations.
Instructions
Get peer reviews you need to complete.
Args:
course_identifier: Optional course code or ID to filter by specific course
Returns list of peer reviews assigned to you that need completion.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| course_identifier | No |
Implementation Reference
- Main handler function implementing get_my_peer_reviews_todo tool. Fetches pending peer reviews by querying courses, assignments, and peer_reviews API endpoints, formats output listing incomplete reviews with course and student info.@mcp.tool() @validate_params async def get_my_peer_reviews_todo(course_identifier: str | int | None = None) -> str: """Get peer reviews you need to complete. Args: course_identifier: Optional course code or ID to filter by specific course Returns list of peer reviews assigned to you that need completion. """ if course_identifier: course_ids = [await get_course_id(course_identifier)] else: # Get all active courses courses = await fetch_all_paginated_results( "/courses", params={"enrollment_state": "active", "per_page": 100} ) if isinstance(courses, dict) and "error" in courses: return f"Error fetching courses: {courses['error']}" course_ids = [course.get("id") for course in courses if course.get("id")] all_peer_reviews = [] for course_id in course_ids: # Get assignments for this course assignments = await fetch_all_paginated_results( f"/courses/{course_id}/assignments", params={"per_page": 100} ) if isinstance(assignments, dict) and "error" in assignments: continue # Check each assignment for peer reviews for assignment in assignments if isinstance(assignments, list) else []: if assignment.get("peer_reviews"): assignment_id = assignment.get("id") # Get peer reviews for this assignment peer_reviews = await fetch_all_paginated_results( f"/courses/{course_id}/assignments/{assignment_id}/peer_reviews", params={"include[]": ["user"], "per_page": 100} ) if isinstance(peer_reviews, list): # Filter to reviews assigned to current user that are incomplete for review in peer_reviews: # Note: We'd need to filter by current user ID # For now, show all incomplete reviews if review.get("workflow_state") != "completed": review["_course_id"] = course_id review["_assignment_name"] = assignment.get("name") all_peer_reviews.append(review) if not all_peer_reviews: return "You have no pending peer reviews! ✅" output_lines = ["Peer Reviews You Need to Complete:\n"] for review in all_peer_reviews: assignment_name = review.get("_assignment_name", "Unknown Assignment") course_id = review.get("_course_id") course_display = await get_course_code(course_id) if course_id else "Unknown Course" user_id = review.get("user_id") assessor_id = review.get("assessor_id") output_lines.append( f"• {assignment_name}\n" f" Course: {course_display}\n" f" Reviewing: Student {user_id}\n" f" Status: Incomplete\n" ) return "\n".join(output_lines)
- src/canvas_mcp/server.py:55-55 (registration)Calls register_student_tools(mcp) within register_all_tools, which registers the student tools including get_my_peer_reviews_todo.register_student_tools(mcp)
- src/canvas_mcp/tools/student_tools.py:302-303 (registration)The @mcp.tool() decorator registers the function as an MCP tool within the register_student_tools function.@mcp.tool() @validate_params