# ZenHub MCP > ZenHub MCP connects your AI agent directly to ZenHub's project data. You can use natural language commands to view entire development boards, track epic progress, update issue statuses, and set story point estimates without leaving your IDE or chat client. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** agile-management, issue-tracking, sprint-planning, github-integration, kanban-boards, epics ## Description Your agent talks directly to ZenHub, giving it visibility into everything from the project board status to how many story points an epic needs. Instead of opening 15 tabs just to check on a sprint's health, you simply ask your AI client for a summary. It pulls in all relevant data—like which issues are stuck between 'In Progress' and 'Review/QA' or what the total estimate is for a large feature set. This MCP lets you manage complex agile boards and track release progress using plain conversation. Once connected through Vinkius, your agent becomes an embedded project assistant, making board visibility and status changes feel like talking to a coworker instead of logging into a dashboard. ## Tools ### get_repo_board Retrieves the complete ZenHub board view for a specific repository. ### get_epic_data Fetches detailed information about a specified ZenHub epic. ### list_repo_epics Generates a list of all available ZenHub epics within a repository. ### set_issue_estimate Updates the story point estimate for any given issue in ZenHub. ### get_zenhub_issue_data Pulls ZenHub-specific metadata about a particular GitHub issue. ### move_issue_between_pipelines Changes an issue's pipeline status, moving it between different stages of the workflow. ### list_release_reports Generates a list of comprehensive release reports for your projects. ### get_workspace_board Retrieves the ZenHub board view for an entire workspace and repository combination. ## Prompt Examples **Prompt:** ``` Show me the ZenHub board for repository ID '12345678'. ``` **Response:** ``` I've retrieved the ZenHub board for repository 12345678. You have 5 pipelines: 'New Issues', 'Backlog', 'In Progress', 'Review/QA', and 'Done'. Would you like to see the issues in a specific pipeline? ``` **Prompt:** ``` Move issue #45 in repo '12345678' to the 'In Progress' pipeline (ID: '56789') in workspace '98765'. ``` **Response:** ``` Successfully moved issue #45 to the 'In Progress' pipeline in your ZenHub workspace. ``` **Prompt:** ``` What are the estimates for all issues in the current epic? ``` **Response:** ``` For the current epic, I found 8 issues. Total estimated points: 34. Current distribution: 3 issues (8 pts), 2 issues (5 pts), 3 issues (3 pts). ``` ## Capabilities ### View Board Status The MCP retrieves the entire ZenHub board view for any specified repository or workspace. ### Adjust Issue Workflow You can instantly move issues between different pipelines to reflect their current development status. ### Set Task Estimates The system allows you to assign or retrieve story point estimates for specific project issues. ### Analyze Epic Details You get a full rundown of any ZenHub epic, including all the smaller constituent issues it contains. ### Monitor Project Releases Retrieve comprehensive release reports and progress metadata for the entire project cycle. ## Use Cases ### A PM needs an immediate status report on a major feature. The Project Manager asks their agent: 'What's the current state of the Q3 onboarding epic?' The agent uses `list_repo_epics` and `get_epic_data`, compiling a single answer detailing all constituent issues, which are currently stuck in the 'Review/QA' pipeline. ### A developer finishes code and needs to move the ticket. The Software Engineer runs: 'Move issue #45 from In Progress to Review.' The agent uses `move_issue_between_pipelines`, instantly updating the board status without requiring them to open the ZenHub UI. ### Scrum Master needs to estimate a new set of tasks. Instead of gathering team members, the Scrum Master asks: 'What are the estimated points for these three related issues?' The agent uses `get_zenhub_issue_data` and calculates the total needed capacity. ### Tracking a multi-stage release cycle. The PM queries: 'Show me the completion status of the last two releases.' The agent calls `list_release_reports`, providing key dates, progress metrics, and overall completion percentages immediately. ## Benefits - Stop manually clicking through boards. You can use natural language to view the entire ZenHub board status for a repository or workspace instantly. - Update issue progress without leaving your IDE. Commands allow you to move issues between pipelines immediately after coding them, keeping the workflow accurate. - Keep project estimates current. Use the tool to set or retrieve story point estimates for any issue, eliminating manual spreadsheet updates. - Gain full visibility into large features. List and inspect ZenHub epics to understand the scope of work before committing resources. - Get a clear picture of project history. Access release reports and progress metadata so you can track what was delivered and when. ## How It Works The bottom line is you manage complex project data through conversational commands, not clicks. 1. Subscribe to this MCP on Vinkius and enter your ZenHub API Token. 2. Connect your preferred AI client (like Claude or Cursor) to the service. 3. Ask your agent a question, like 'Show me all issues in the Backlog pipeline,' and get an instant, structured answer. ## Frequently Asked Questions **How do I check the full board status with ZenHub MCP?** You use `get_repo_board` or `get_workspace_board`. This retrieves all pipelines and issues for a given repository, giving you an instant overview of where everything stands. **Can I change an issue's status using ZenHub MCP?** Yes. The tool `move_issue_between_pipelines` allows your agent to update the workflow status for any issue, moving it from one pipeline stage to another with a single command. **What is required to set story point estimates using ZenHub MCP?** You must use `set_issue_estimate`. You provide the specific issue ID and the desired numerical estimate, and the tool handles updating that field directly in the system. **Does ZenHub MCP work with multiple epics?** Yes. You can list all available large features using `list_repo_epics` and then select a specific epic for deeper analysis using `get_epic_data`.