AI: Managing Work Items

The MCP integration really shines when it comes to managing work items. Your AI assistant can do nearly everything you can do in the web app.

Creating Items

Just describe what you need:

"Create a Story called 'Add user profile page' under the Authentication epic" "Add a P1 Bug: Login button doesn't respond on mobile" "Create a Task for database migration with 3 story points, assigned to Sarah"

The AI handles all the details — type, priority, parent assignment, sprint, tags, story points, and more. It follows the same hierarchy rules as the web app (e.g., SubTasks must have a parent).

Reading & Searching

"Show me all blocked items" "List the stories in Sprint 3" "What's the status of WEB-42?" "Search for items about authentication"

The AI can filter by type, status, sprint, and parent item. Searching works across all projects in your organization.

Updating Items

"Move WEB-42 to In Progress" "Assign the login bug to Marcus" "Update the description of WEB-15 with the new requirements" "Set story points to 5 on WEB-42" "Add the tags 'frontend' and 'urgent' to WEB-42"

Only the fields you mention get changed — everything else stays the same.

Completing Items

"Mark WEB-42 as done" "Complete the entire Authentication epic and all its children"

The cascadeToChildren option lets the AI mark a parent and all its descendants as Done in one go — handy for closing out a completed feature.

Moving Items

"Move WEB-42 under the API epic" "Reparent this task to Story WEB-30"

Hierarchy rules are enforced — the AI will explain why if a move isn't allowed.

Deleting Items

"Delete WEB-42"

⚠️ Deletion is permanent and includes all child items. The AI will ask for confirmation before proceeding.

Smart Recommendations

"What should I work on next?"

The AI uses the get_next_recommendation tool to suggest the highest-priority items whose dependencies are all resolved — the items that are actually ready to be picked up.

Item Numbers

Throughout all of these interactions, you can reference items by their item number (like WEB-42) instead of UUIDs. The AI resolves them automatically.