Loading ToolBench

Reading the current corpus…

Human_Like_AI_School_Assistant MCP server · D · ToolBench

Human_Like_AI_School_Assistant

github.com/amolrathod7875/Human_Like_AI_School_Assistant

FastAPI-based AI school assistant backend with role-based access control, attendance management, and escalation tools. Integrates with Cohere LLM for natural language processing and Firebase for authentication.

<=2025-11-25STREAMABLE_HTTP6 tools

57/100

Definition Quality73

Protocol Readiness62

Supportability28

Spec posture

Inferred effective spec <=2025-11-25·current baseline 2026-07-28

Static source inference · medium confidence · detected: Logging

Deprecated protocol patterns detected

Summary

Server has 6 tools with basic structure and authorization checks. Tool names follow verb_noun convention (get_*, create_*). Descriptions are present but brief (avg 95 chars, below 194-char baseline). Input schemas use Pydantic models with type hints, but parameter descriptions are minimal or missing. Error handling exists (ToolAuthorizationError, InvalidArgumentsError) but lacks recovery guidance. Output schemas are not documented. No tool annotations (readOnlyHint/destructiveHint). Authorization logic is sound but not exposed in tool metadata.

Tools (6)

create_management_contact_requestwriteauthsource verified75/100

Request human contact with school management (teacher or principal only). Requires a reason and explicit confirmation.

create_teacher_contact_requestwriteauthsource verified77/100

Request human contact with a student's teacher (parent or teacher only). Requires student_id, a reason, and explicit confirmation.

get_child_attendanceread onlyauthsource verified70/100

View a parent's child attendance records. Provide student_id or name.

get_overall_attendanceread onlyauthsource verified70/100

View school-wide attendance analytics (principal only).

get_own_attendanceread onlyauthsource verified70/100

View the calling student's own attendance records.

mark_attendancewriteauthsource verified75/100

Mark a student's attendance (PRESENT/ABSENT/LATE) for a date. Teacher only; provide student_id or name.

Issues (5)

HIGHtool-description ↗

Parameter descriptions are minimal or absent. 'start_date' and 'end_date' in attendance tools lack format guidance (ISO 8601?). 'status' in mark_attendance lacks enum constraint in schema. LLMs cannot infer valid values.

get_own_attendanceget_child_attendanceget_overall_attendancemark_attendance

HIGHresponse-shaper ↗

Output schemas are not documented. Tools return service layer objects without specifying what fields the LLM should expect. This forces the LLM to guess at response structure and breaks downstream tool chaining.

get_own_attendanceget_child_attendanceget_overall_attendancemark_attendancecreate_teacher_contact_requestcreate_management_contact_request

HIGHtool-annotations ↗

No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Attendance read tools should be marked readOnly=true; write tools should be marked destructive=true. This metadata is required for current MCP spec (2026-07-28).

Recommendations

Add enum constraint to 'status' parameter in mark_attendance schema: {type: 'string', enum: ['PRESENT', 'ABSENT', 'LATE']}. Document in parameter description: 'Attendance status: one of PRESENT, ABSENT, or LATE.'
Document date format for start_date/end_date: 'ISO 8601 date string (YYYY-MM-DD) or null for unbounded range.' Add to parameter descriptions in all attendance tools.
Add output schema documentation to each tool. Example for get_own_attendance: 'Returns {records: [{date: string, status: string, marked_by: string}], total: number, period: {start: string, end: string}}'.
Implement tool annotations in MCP registration: mark get_* tools with readOnlyHint=true; mark create_* and mark_attendance with destructiveHint=true. This signals to agents which tools are safe to retry.
Enhance error messages with recovery hints. For ambiguous student names, return: 'Multiple students match "John": John Smith (S001), John Doe (S002). Please specify the student ID or full name.' For authorization errors: 'You do not have permission to mark attendance. Only teachers can mark attendance for their assigned students.'

Spec posture evidence

Inferred effective spec: <=2025-11-25.

Relies on Logging (deprecated) - log to stderr or use OpenTelemetry

Score history

Overall score trend

First recorded score · v2 rubric

57/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	D	57	<=2025-11-25	v2