gather-edgeex-enrollment-info

Gather EdgeEx Enrollment Information

Collect and summarize the full configuration and progress state for a given enrollment: section details, course structure customizations, supplemental individualizations, and gradebook results.

Step 0 — Confirm the Environment

If the environment is not clear from context, ask the user before proceeding. The MCP tools are namespaced by environment (e.g. mcp__edgeex-prod__*, mcp__edgeex-staging__*). Use the correct namespace for all calls in this skill.

Terminology

• Customized — course structure changes: HIDE, SHOW, ADD_UNIT, ADD_LESSON, ADD_ACTIVITY, REORDER, HIDE_ASSESSMENT_QUESTIONS, etc. Stored in the customization table.
• Individualized — course supplemental field overrides: grade weights, passing thresholds, assessment settings, etc. Stored in the course supplemental.
• Gradebook — the student's scored results for the enrollment: overall grade, per-category rollups, and per-activity scores. Sourced from cwng-grading-api, not the course/section configuration.

Keep these categories separate in your summary.

Step 1 — Fetch the Enrollment

Call mcp__edgeex-prod__enrollment_get with the enrollmentId.

Extract and note:

• courseId, sectionId, studentId
• districtId, schoolId
• courseMajorEdition, catalogManager
• customizationSectionEdition — edition of the section customization snapshot baked into this enrollment
• customizedAtEnrollmentLevel — true if enrollment has supplemental individualizations (not content customizations)

Step 2 — Fetch Based on the User's Question

Always fetch section details (mcp__edgeex-prod__section_get). Beyond that, only fetch what is relevant:

User is asking about...	Also fetch
Course structure, hidden content, added content	Section and enrollment customization summaries (mcp__edgeex-prod__course_customization_get_summary)
Grade weights, passing thresholds, assessment settings	Section and enrollment supplementals (mcp__edgeex-prod__course_get_supplemental)
Overall grade or progress (top-line only)	Enrollment gradebook (mcp__edgeex-prod__grading_gradebook_get_enrollment) — but do NOT load the full activities array into context
A specific activity's score, attempts, or bypass reason	mcp__edgeex-prod__grading_gradebook_get_activity — requires activityId from the user
General "what's going on with this enrollment"	Customizations + supplementals. Do not pull the full gradebook by default.

Make all relevant calls simultaneously. Always pass catalogManager from the enrollment to the customization summary calls.

Gradebook policy: the full enrollment gradebook is very large (often hundreds of activities, ~500KB+) and loading it into context is wasteful. Default to activity-level lookups via grading_gradebook_get_activity once the user names a specific activity. If the user has not provided an activityId, ask which activity they want to inspect rather than pulling the full gradebook. Only use grading_gradebook_get_enrollment when you need the top-line grade/progress/status fields and plan to discard the activities array.

Step 3 — Full Customization Detail (if needed)

Do not rely on course_customization_get_summary to determine whether customizations exist. The changes array it returns is only populated when a special metadata flag is passed to the course call — an empty changes array does not mean the section or enrollment is uncustomized.

To get the authoritative list of active customizations, use mcp__edgeex-prod__course_customization_query_active with districtId, schoolId, sectionId, and courseId. This queries DynamoDB directly and is the most reliable source.

For enrollment-level content customizations specifically, mcp__edgeex-prod__course_customization_list_for_section lists them by section; a 404 response means none exist at the enrollment level.

Step 4 — Summarize

Enrollment Overview

• Course, section, district/school, status, start/end dates

Customizations (course structure)

• Section level: count and breakdown by action type (HIDE, ADD_UNIT, ADD_LESSON, etc.), who published and when
• Enrollment level: whether any exist (check both the customization summary and customizedAtEnrollmentLevel flag — the latter only indicates supplemental overrides, not content changes)

Gradebook (if fetched)

Report only the top-line: overall grade, progress, pacing status, and enrollment status. Do not load or summarize the per-activity list. If the user wants detail on a specific activity, ask for the activityId and call grading_gradebook_get_activity for just that one.

Individualizations (supplemental)

Compare grade weights and other key options between section and enrollment scopes using a table. Use the fieldSources object in the supplemental response to identify which fields are overridden at which level — any field showing "enrollment" is individualized at the enrollment level, "section" means the section overrides the course default.

Grade weights comparison template:

Category	Section	Enrollment	Source
quiz	X	X	course / section / enrollment
test	X	X	...
exam	X	X	...
assignment	X	X	...
project	X	X	...
short writing	X	X	...
practice assessment	X	X	...
essay	X	X	...

Also note any other fields where enrollment scope differs from section scope (passing thresholds, assessment settings, etc.).