provide_feedback
Submit assignment feedback and grades for students in Moodle to support learning progress and assessment.
Instructions
Proporciona feedback sobre una tarea entregada por un estudiante
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"studentId": "<studentId>",
"assignmentId": "<assignmentId>",
"feedback": "<feedback>"
},
"name": "provide_feedback"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| studentId | Yes | ID del estudiante | |
| assignmentId | Yes | ID de la tarea | |
| grade | No | Calificación numérica a asignar | |
| feedback | Yes | Texto del feedback a proporcionar |
Implementation Reference
- src/index.ts:446-483 (handler)The handler function for the 'provide_feedback' tool. Validates input parameters, calls the Moodle 'mod_assign_save_grade' API to assign grade and feedback, and returns a success message.
private async provideFeedback(args: any) { if (!args.studentId || !args.assignmentId || !args.feedback) { throw new McpError( ErrorCode.InvalidParams, 'Student ID, Assignment ID, and feedback are required' ); } console.error(`[API] Providing feedback for student ${args.studentId} on assignment ${args.assignmentId}`); const response = await this.axiosInstance.get('', { params: { wsfunction: 'mod_assign_save_grade', assignmentid: args.assignmentId, userid: args.studentId, grade: args.grade || 0, attemptnumber: -1, // Último intento addattempt: 0, workflowstate: 'released', applytoall: 0, plugindata: { assignfeedbackcomments_editor: { text: args.feedback, format: 1, // Formato HTML }, }, }, }); return { content: [ { type: 'text', text: `Feedback proporcionado correctamente para el estudiante ${args.studentId} en la tarea ${args.assignmentId}.`, }, ], }; } - src/index.ts:176-197 (schema)Input schema defining the parameters for the 'provide_feedback' tool: studentId, assignmentId (required), grade (optional), feedback (required).
inputSchema: { type: 'object', properties: { studentId: { type: 'number', description: 'ID del estudiante', }, assignmentId: { type: 'number', description: 'ID de la tarea', }, grade: { type: 'number', description: 'Calificación numérica a asignar', }, feedback: { type: 'string', description: 'Texto del feedback a proporcionar', }, }, required: ['studentId', 'assignmentId', 'feedback'], }, - src/index.ts:173-198 (registration)Tool registration in the ListTools response, including name, description, and input schema.
{ name: 'provide_feedback', description: 'Proporciona feedback sobre una tarea entregada por un estudiante', inputSchema: { type: 'object', properties: { studentId: { type: 'number', description: 'ID del estudiante', }, assignmentId: { type: 'number', description: 'ID de la tarea', }, grade: { type: 'number', description: 'Calificación numérica a asignar', }, feedback: { type: 'string', description: 'Texto del feedback a proporcionar', }, }, required: ['studentId', 'assignmentId', 'feedback'], }, }, - src/index.ts:251-252 (handler)Dispatcher case in CallToolRequestHandler that routes to the provideFeedback method.
case 'provide_feedback': return await this.provideFeedback(request.params.arguments);