Construct or export the assessment as a QTI 2.1 XML package; ensure each question is an assessmentItem element with responseDeclaration, outcomeDeclaration, itemBody, responseProcessing, and a unique identifier attribute
Wrap items in an assessmentTest or assessmentSection XML file that references each assessmentItem by href
Include a manifest file (if required by the target platform) that lists all XML resources and their roles
Zip the package and import via the platform's QTI import endpoint or UI, noting whether the platform expects a flat zip or a specific directory structure
After import, run a sample attempt and verify that response processing maps correct answers to the correct outcome variable values
Known gotchas
QTI 2.1 and QTI 3.0 are not backward compatible; a package authored against QTI 3.0 schema will fail validation on a platform that only supports QTI 2.1
Many platforms implement only a subset of interaction types (e.g., choiceInteraction and textEntryInteraction) and silently drop or error on unsupported types like graphicGapMatchInteraction
Response processing templates (match_correct, map_response) are commonly misused; authors who hard-code a custom responseCondition that mirrors match_correct often introduce off-by-one errors in partial credit calculations
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp