productivity
Jira MCP, CLI, and Lua Integration for AI Agents
Jira integration docs for AI agents: MCP gateway setup, Jira CLI commands, Lua API reference, credentials, and function schemas.Jira for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
jira.jira_create_issue | Write write | 7 | Create a new issue in a Jira project. Requires project_key, summary, and issue_type. Optionally set description, priority, assignee, and labels. |
jira.jira_get_issue | Read read | 1 | Get details for a specific Jira issue by its key (e.g. PROJ-123). Returns summary, status, assignee, description, and all fields. |
jira.jira_update_issue | Write write | 5 | Update an existing Jira issue. Provide the issue key and any fields to update (summary, description, priority, assignee). |
jira.jira_search_issues | Read read | 4 | Search for Jira issues using JQL (Jira Query Language). Examples: "project = PROJ AND status = Open", "assignee = currentUser() ORDER BY created DESC". |
jira.jira_add_comment | Write write | 2 | Add a comment to a Jira issue. Provide the issue key and the comment body text. |
jira.jira_list_comments | Read read | 1 | List all comments on a Jira issue. Returns comment body, author, and creation date. |
jira.jira_get_transitions | Read read | 1 | Get the available status transitions for a Jira issue. Returns transition IDs and target status names needed to change the issue status. |
jira.jira_transition_issue | Write write | 2 | Transition a Jira issue to a new status. Use jira_get_transitions first to find the available transition IDs for the issue. |
jira.jira_assign_issue | Write write | 2 | Assign a Jira issue to a user by their Atlassian account ID. Use jira_search_users to find account IDs. |
jira.jira_delete_issue | Write write | 1 | Delete a Jira issue by its key. This action is irreversible. |
jira.jira_list_projects | Read read | 2 | List Jira projects accessible to the authenticated user. Supports pagination with start_at and max_results. |
jira.jira_get_issue_types | Read read | 0 | Get all available issue types in Jira. Returns issue type names and IDs needed when creating issues. |
jira.jira_get_user | Read read | 1 | Get details for a specific Jira user by their Atlassian account ID. |
jira.jira_search_users | Read read | 2 | Search for Jira users by name or email. Returns account IDs needed for assigning issues. |
jira.jira_list_priorities | Read read | 0 | List all available issue priorities in Jira. Returns priority names and IDs needed when creating or updating issues. |
jira.jira_list_boards | Read read | 2 | List agile boards accessible to the authenticated user. Supports pagination with start_at and max_results. |
jira.jira_list_sprints | Read read | 2 | List sprints for a specific Jira board. Optionally filter by sprint state (active, closed, future). |
jira.jira_list_sprint_issues | Read read | 3 | List issues in a specific Jira sprint. Supports pagination with start_at and max_results. |
jira.jira_create_version | Write write | 5 | Create a new version (release) in a Jira project. Requires project_key and name. Optionally set description, start_date, and release_date. |
jira.jira_add_attachment | Write write | 3 | Add a file attachment to a Jira issue. Provide the issue key, filename, and file content. |