Server has 13 tools with consistent naming (verb_noun pattern) and complete input schemas. Descriptions are present but generic, most lack actionable context for LLM selection. Parameter descriptions are minimal (often 1-2 words). No output schemas documented. Error handling returns raw error messages without recovery guidance. Missing tool annotations (readOnlyHint, destructiveHint). Pagination is implemented but inconsistently (page 0-indexed vs 1-indexed across tools). No idempotency or confirmation patterns for destructive operations.
Assign a guide to a user. Creates a new assignment linking a user to a guide with optional due date.
Assign a learning path to a user.
Create a new enterprise user in WorkRamp. Args: email: Required. User's email address. name: Optional full name. is_admin: Whether to grant admin privileges. groups: Optional list of group IDs.
Get all users in a specific group.
Get all assignments for a specific user. Returns guides, paths and other content assigned to this user with completion status.
List all groups in WorkRamp. Returns group IDs and names used for organizing users and assigning content.
No output schemas documented. Tools return JSON via fmt_json() but LLMs cannot predict response structure. Prevents downstream tool chaining and forces parsing of unstructured output.
Error handling returns raw error messages ('Error: {e.message}') without recovery guidance. LLM cannot determine if error is retryable, user-fixable, or fatal.
Pagination inconsistency: workramp_list_users uses page 0-indexed (default=0), but workramp_list_guides uses page 1-indexed (default=1). LLM must track two different conventions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
List all guide assignments across users. Optionally filter by date range. Returns assignment status, completion and due dates.
List all guides (courses/learning content) in WorkRamp. Returns guide IDs, titles and metadata. Guides are the primary content unit.
List all path assignments across users. Returns assignment details including completion status and due dates.
List all learning paths in WorkRamp. Paths are ordered collections of guides that form a curriculum.
List enterprise users (employees) in WorkRamp. Returns user profiles with IDs, emails, names, admin status and group memberships. Use email or name filters to find specific users.
Test the WorkRamp API connection and authentication. Returns connection status, base URL, and whether academy ID is configured. Use this to verify credentials before making other calls.
Update an enterprise user's profile. Pass only the fields you want to change. Omitted fields remain unchanged.
Destructive operations (create_user, update_user, create_guide_assignment) lack confirmation or dry-run patterns. No protection against accidental bulk modifications.
Parameter descriptions are minimal (1-2 words). E.g., 'Group ID' for group_id, 'User ID' for user_id. No guidance on format, constraints, or when to use each parameter.