Canvas MCP Server

Instructions

    Args:
        course_identifier: Optional course code or ID to filter by specific course

    Returns list of peer reviews assigned to you that need completion.
    

Implementation Reference

• src/canvas_mcp/tools/student_tools.py:302-378 (handler)

  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