Loading ToolBench

Reading the current corpus…

eclass-mcp MCP server · F · ToolBench

← Browse

eclass-mcp

github.com/SoroushRF/eclass-mcp

Local MCP server for York eClass, SIS, Cengage/WebAssign, course files, and RateMyProfessors.

2025-06-18+STDIO26 tools

49/100

Definition Quality64

Protocol Readiness42

Supportability30

Spec posture

Inferred effective spec 2025-06-18+·current baseline 2026-07-28

Static source inference · medium confidence · detected: Logging, Dynamic Client Registration

Deprecated protocol patterns detected

Summary

eclass-mcp has 26 tools with consistent naming (verb_noun pattern) and descriptions present for all. However, parameter descriptions are sparse or missing for many tools, and output schemas are not documented in the visible code. Error handling is structured (ToolErrorPayload, SessionExpiredError) but recovery guidance is minimal. Tool composition is reasonable (single responsibility), but several tools lack clarity on expected return formats and chaining IDs. The server demonstrates good intent with auth retry logic and cache management, but falls short of production-grade documentation standards.

Tools (26)

cache_delete_pinneddestructivesource verified60/100

Delete a pinned resource and its cache

cache_healthread onlysource verified63/100

Check the health and status of the local cache

cache_list_pinsread onlysource verified62/100

List all pinned resources

cache_pinwritesource verified67/100

Pin a resource to prevent cache eviction

cache_refresh_pinwritesource verified60/100

Refresh a pinned resource to update its cache

cache_unpinwritesource verified63/100

Unpin a previously pinned resource

clear_cachewritesource verified70/100

Clear the local cache with optional scope filtering

discover_cengage_linksread onlyauth

Issues (5)

CRITICALtool ↗

Output schemas not documented. No visible return type specifications for any tool. LLMs cannot infer what fields to expect or plan downstream tool calls.

list_coursesget_course_contentget_section_textget_gradesget_announcementsget_exam_scheduleget_class_timetablecache_healthcache_list_pins

HIGHtool-description ↗

Parameter descriptions missing or minimal for many tools. E.g., 'discoveredLink' in list_cengage_courses lacks format/structure guidance; 'entryUrl' lacks validation hints.

list_cengage_coursesget_cengage_assignmentsget_cengage_assignment_detailsprepare_assignment_submission

HIGHpaginated-result ↗

No pagination guidance in tool descriptions. Tools like get_assignments, get_announcements accept 'limit' but do not document max values, offset/cursor support, or total count returns.

get_assignmentsget_announcements

Recommendations

Document output schemas for all 26 tools. Include field names, types, and descriptions. Specify pagination structure (total_count, next_cursor, or offset) for list tools.
Add parameter descriptions for all inputs. For enums (scope, csvMode, resource_type), document what each value does. For optional params, state defaults explicitly.
Enhance error responses with recovery guidance. Map error codes to actions: 'SESSION_EXPIRED → call auth URL'; 'VALIDATION_FAILED → check parameter constraints'; 'SCRAPE_LAYOUT_CHANGED → contact maintainer'.
Ensure tool outputs include chaining IDs. E.g., get_assignments should return courseId, assignmentId, and URL for immediate use in get_item_details.
Add pagination limits to descriptions. E.g., 'get_announcements: Returns up to 10 announcements (limit param max 100). Use offset/limit for pagination.' Document total_count in response.

Spec posture evidence

Inferred effective spec: 2025-06-18+.

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

Score history

Overall score trend

First recorded score · v2 rubric

49/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	F	49	2025-06-18+	v2