Server has 5 tools with complete input schemas and descriptions present. However, descriptions are generic and lack actionable context for LLM selection. Parameter descriptions are minimal (e.g., 'ID or key of the issue' without format guidance). Output schemas are not documented, LLMs cannot predict response structure for chaining. No error handling guidance. Tool names follow verb_noun convention (good), but descriptions do not explain WHEN to use each tool or dependencies between them. Schemas are well-formed JSON Schema with types, but lack constraints (enums, patterns, ranges) that would prevent invalid LLM inputs.
Create a new issue in JIRA
Retrieve details about an issue by its ID or key.
Get the sprint report for a specific sprint
Perform enhanced JQL search in Jira
Update an existing issue in JIRA
Output schemas not documented. LLMs cannot predict response structure, breaking tool chaining. E.g., does jql_search return issue_key or issueKey? Does create_issue return the new issue ID?
Descriptions lack actionable context. 'Perform enhanced JQL search in Jira' does not explain WHEN to use jql_search vs get_issue, or what 'enhanced' means. LLMs cannot disambiguate.
Parameter descriptions lack format/constraint guidance. 'Maximum results to fetch' does not specify range (1 - 100? 1 - 1000?). 'JQL query string' does not explain valid JQL syntax or common mistakes.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
No error handling guidance. If create_issue fails due to invalid project key, the error response does not tell the LLM how to recover (e.g., 'Call list_projects() first').
create_issue and update_issue descriptions do not indicate they are destructive/state-modifying. LLMs need to know which calls are safe to retry and which have irreversible consequences.