FlowTruxFlowTrux/Docs
Docsmcp

Jira MCP Server

Connect FlowTrux workflows to Jira Cloud issues, projects, sprints, and transitions

The Jira MCP server provides 10 tools for managing Jira Cloud issues, projects, sprints, and workflow transitions.

Setup

  1. Go to Atlassian API Tokens and create a token.
  2. In FlowTrux, go to Settings > MCP Servers > Add > Jira Cloud.
  3. Enter your Jira site URL (e.g., https://yoursite.atlassian.net), email, and API token.

Tools

Issues

ToolDescriptionRequired Params
search_issuesSearch with JQL queryjql
get_issueGet issue by key (e.g., PROJ-123)issue_key
create_issueCreate an issueproject_key, summary, issue_type
update_issueUpdate issue fieldsissue_key
transition_issueMove issue to new statusissue_key, transition_name
add_commentAdd comment to issueissue_key, body

The transition_issue tool automatically finds the transition by name (e.g., "In Progress", "Done") from the available transitions for that issue.

Projects

ToolDescriptionRequired Params
list_projectsList accessible projects(none)
get_projectGet project detailsproject_key

Sprints (Agile)

ToolDescriptionRequired Params
list_sprintsList sprints for a boardboard_id
get_sprint_issuesGet issues in a sprintsprint_id

Examples

AI triages incoming bug reports:

Webhook (bug report) → Agent (classify severity, extract details) → Action:MCP(jira, create_issue, {project_key: "BUG", summary: "{{steps.agent-1.output.response.title}}", issue_type: "Bug", priority: "{{steps.agent-1.output.response.severity}}", description: "{{steps.agent-1.output.response.details}}"})

Auto-transition issue on deploy:

Webhook (deploy success) → Transform (extract ticket keys) → Loop → Action:MCP(jira, transition_issue, {issue_key: "{{item}}", transition_name: "Done"}) → Slack (notify team)

Daily sprint summary:

Cron → Action:MCP(jira, search_issues, {jql: "sprint in openSprints() AND status != Done"}) → Agent (summarize progress) → Slack (post to #standup)