This Canvas LMS MCP server has 19 tools with READ_ONLY risk profiles. Tool naming follows verb_noun conventions (get_*, list_) which is positive. However, critical gaps appear across parameter descriptions, output schema documentation, and error handling. Most tool descriptions are present but generic (10-50 chars), falling well below the 50-200 char baseline for LLM-optimized descriptions. Parameter schemas are visible in the source but lack depth, many parameters have minimal descriptions ('Student ID (optional)') that don't explain format, constraints, or dependencies. Output schemas are not documented anywhere in the provided code. Error handling and recovery guidance are absent. The server shows foundational structure but lacks production-grade polish required for reliable agent interaction.

• Add output schema documentation for every tool. For get_courses, document that it returns [{id: number, name: string, course_code: string, enrollment: {grades: {current_grade: string, current_score: number}}}]. Include all fields the agent might need downstream.
• Expand tool descriptions to 50-200 chars, clarifying when to use each. Example: 'List all missing assignments marked by Canvas. Use this to identify work not yet submitted. If you need past-due assignments only, use get_unsubmitted_past_due instead.'
• Enrich parameter descriptions with format, constraints, and examples. E.g., 'student_id (string, optional): Student ID in email ([email protected]) or numeric format (123456), or omit to use the authenticated user (self).'
• Add pagination parameters (limit, offset) and document max results for list tools. E.g., 'get_announcements returns max 50 most recent items. Use limit and offset to paginate.'
• Document which parameters are mutually exclusive and parameter dependencies. E.g., 'In list_assignments, bucket filters results, only omit it when fetching all assignments.'
• Add per-tool error guidance. E.g., 'If get_courses returns permission denied, the authenticated user may not have student enrollment. Call get_students to list observed students instead.'
• Consolidate overlapping tools or clarify differences. Add descriptions that explain: 'get_missing_assignments returns assignments marked missing by Canvas; get_unsubmitted_past_due returns assignments past due AND not submitted; use one or the other based on Canvas's missing flag vs. your submission status.'