---
name: "MCP tool to move stories between pipeline stages"
---

# Story 304: MCP tool to move stories between pipeline stages

## User Story

As a bot operator (Timmy), I want an MCP tool that moves stories between pipeline stages, so that I don't need shell mv permissions to manage the pipeline.

## Acceptance Criteria

- [ ] New MCP tool 'move_story' accepts story_id and target_stage (e.g. 'backlog', 'current', 'qa', 'merge', 'done')
- [ ] Validates the story exists before moving
- [ ] Handles the file move between stage directories
- [ ] Returns a confirmation message with the old and new stage
- [ ] Works for stories, bugs, spikes, and refactors
- [ ] Replaces the need for shell mv commands to move story files
- [ ] Tool description tells bots to prefer specific tools (accept_story, move_story_to_merge, request_qa) when available, and use move_story only for arbitrary moves that lack a dedicated tool (e.g. moving to backlog, moving ghost stories back to current)

## Out of Scope

- TBD
