Gradescope MCP Server

Instructions

This is useful for scanned exams where the prompt is only available in page
images and where agents may need to inspect adjacent pages before grading.

Args:
    course_id: The Gradescope course ID.
    assignment_id: The assignment ID.
    question_id: The question ID.
    submission_id: The question submission ID.

Implementation Reference

• src/gradescope_mcp/tools/grading_workflow.py:527-560 (handler)

  The actual implementation of the tool logic.

  def cache_relevant_pages(
      course_id: str,
      assignment_id: str,
      question_id: str,
      submission_id: str,
  ) -> str:
      """Download the crop page and its neighbors to /tmp for local inspection."""
      if not course_id or not assignment_id or not question_id or not submission_id:
          return (
              "Error: course_id, assignment_id, question_id, and submission_id "
              "are required."
          )
  
      try:
          ctx = _get_grading_context(course_id, question_id, submission_id)
          conn = get_connection()
      except AuthError as e:
          return f"Authentication error: {e}"
      except ValueError as e:
          return f"Error: {e}"
      except Exception as e:
          return f"Error caching relevant pages: {e}"
  
      props = ctx["props"]
      question = props.get("question", {})
      parameters = question.get("parameters") or {}
      crop_rects = parameters.get("crop_rect_list", [])
      pages = [
          page for page in props.get("pages", [])
          if isinstance(page, dict) and page.get("url")
      ]
      relevant_pages = _select_relevant_pages(pages, crop_rects)
      if not relevant_pages:
          return "No relevant pages were found for this submission."

• src/gradescope_mcp/server.py:666-686 (registration)

  The MCP tool registration and handler wrapper for tool_cache_relevant_pages.

  @mcp.tool()
  def tool_cache_relevant_pages(
      course_id: str,
      assignment_id: str,
      question_id: str,
      submission_id: str,
  ) -> str:
      """Download the crop page and neighboring pages to /tmp for local review.
  
      This is useful for scanned exams where the prompt is only available in page
      images and where agents may need to inspect adjacent pages before grading.
  
      Args:
          course_id: The Gradescope course ID.
          assignment_id: The assignment ID.
          question_id: The question ID.
          submission_id: The question submission ID.
      """
      return cache_relevant_pages(
          course_id, assignment_id, question_id, submission_id
      )