Server has 25 tools with consistent naming (verb_noun pattern) and basic schemas using Zod. However, descriptions are generic and lack LLM-optimization guidance. Parameter descriptions exist but are minimal (avg ~30 chars, well below 72-char baseline). Output schemas are not documented, responses are JSON.stringify'd without field documentation. Error handling is absent; no recovery guidance or categorization. Security: credentials injected via env vars (good), but no permission gates on destructive tools (delete-user, delete-project). Composition is reasonable (tools are single-purpose), but some tools like seed-organization and create-project-from-sow are overly complex and combine multiple concerns.
Add a user to a group
Assign an issue type scheme to a project
Assign a permission scheme to a project
Assign a workflow scheme to a project
Create multiple tickets in a project efficiently
Create multiple users in bulk
Get cache statistics
No output schema documentation. All tools return JSON.stringify'd responses without field definitions. LLMs cannot plan downstream calls or extract specific fields reliably.
Destructive tools (delete-user, delete-project) lack permission gates, confirmation steps, or dry-run support. No error recovery guidance. Agents can delete resources without safeguards.
Parameter descriptions are minimal (avg 20-30 chars, baseline 72). Lack actionable constraints, format hints, and dependency documentation. E.g., 'Group ID' tells LLM nothing about format or how to obtain it.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
Clear the API response cache
Create a new Jira project
Parse a Statement of Work and automatically create a project with tickets
Create a project using predefined templates with sample data
Create a new Jira user
Delete a project (use with caution)
Delete a Jira user
Get details of a specific permission scheme
Get details of a specific project
Get groups for a specific user
List all issue type schemes
List all permission schemes
List all Jira projects
List Jira users with optional search query
List all workflow schemes
Remove a user from a group
Create a complete organization structure with departments, projects, and sample data
Update project details
Complex tools combine multiple concerns: seed-organization creates departments, projects, and sample data in one call; create-project-from-sow parses SOW and creates project+tickets. Should split into single-purpose tools.
No error handling or recovery guidance. Tools return raw API responses or generic success messages. LLMs cannot distinguish retryable errors from user-fixable ones.