# ZenHub MCP for AI Agents AI Agent Connect

> ZenHub MCP lets you manage your GitHub agile boards and project estimates using natural language. You can move issues between pipelines, update story points, and inspect epics without leaving your IDE. It connects your ZenHub account to your AI client so you can handle sprint planning and release tracking through simple chat commands.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect
- **Tags:** agile-management, issue-tracking, sprint-planning, github-integration, kanban-boards, epics

## Description

You're tired of jumping between your code editor and the ZenHub web interface just to update a status or check an estimate. This Connector changes that by bringing your agile project management directly into your workspace. Instead of clicking through boards and menus, you can just tell your agent to move a specific issue to the "In Progress" pipeline or ask for a summary of a particular epic. It handles the heavy lifting of interacting with the ZenHub API so you can stay in your flow. You'll find it's a lot faster to manage your backlog when you don't have to keep tabs on multiple browser windows. It's one of the many tools you can find in the Vinkius catalog to bridge the gap between your project management and your actual development work. You can quickly pull release reports to see how the team is moving or grab the board view for a specific repository to get a bird's-eye view of the sprint. It's about making the administrative side of engineering feel as fluid as writing the code itself. By keeping all your data in one place, you stop losing track of what needs to happen next and spend more time actually shipping features.

## Tools

### get_repo_board
Pulls the ZenHub board for a specific repository. This lets you see the current pipeline structure and all active issues at a glance.

### get_epic_data
Fetches specific details for an epic. You can use this to see exactly what tasks are included in a major project goal.

### list_repo_epics
Shows all epics associated with a repository. This helps you organize large-scale work and see the full scope of your projects.

### get_zenhub_issue_data
Grabs the specific ZenHub metadata for a GitHub issue. It provides the agile context you need for tasks that aren't just standard issues.

### move_issue_between_pipelines
Shifts an issue from one pipeline to another. This reflects real-time status changes without you having to leave your workspace.

### set_issue_estimate
Updates the story point value for a GitHub issue. This keeps your sprint planning accurate as tasks evolve during development.

### list_release_reports
Retrieves release progress and metadata. Use this to track project milestones and see how close you are to a launch.

### get_workspace_board
Gets the full ZenHub board for a workspace and repository. This provides a big-picture view of the entire project's progress.

## Prompt Examples

**Prompt:** 
```
What's the status of the current sprint?
```

**Response:** 
```
Here is the current board for your repository. You have 4 pipelines: New, In Progress, QA, and Done. There are 12 issues total, with 5 currently in the QA phase.
```

**Prompt:** 
```
Move issue #45 to the Review pipeline.
```

**Response:** 
```
I've moved issue #45 to the Review pipeline in your ZenHub workspace. Is there anything else you'd like to update on the board?
```

**Prompt:** 
```
Show me the story points for the User Auth epic.
```

**Response:** 
```
The User Auth epic contains 6 issues. The total story point estimate is 24 points. Here is the breakdown:

| Issue | Points |
| :--- | :--- |
| #101 | 5 |
| #102 | 8 |
| #103 | 3 |
| #104 | 4 |
| #105 | 4 |
| #106 | 0 |
```

## Capabilities

### Move issues between pipelines
Shift tasks between different workflow stages using natural language commands.

### Update story point estimates
Adjust the effort values on GitHub issues to keep your sprint planning accurate.

### View repository boards
Pull the full ZenHub board for any repository to see the current pipeline layout.

### Inspect epic details
Get deep-dive information on specific epics and their associated issues.

### List all repository epics
See every high-level project goal associated with a specific repository.

### Retrieve release reports
Access metadata and progress reports for your upcoming project releases.

### Fetch workspace boards
Get the board view for a specific workspace and repository combined.

### Get issue metadata
Pull ZenHub-specific data for GitHub issues to see their agile context.

## Use Cases

### The Mid-Sprint Update
An engineer finishes a task and tells their agent to move issue #102 to the Done pipeline.

### Sprint Planning
A scrum master asks the agent to list all epics for the current repo to see what is left in the backlog.

### Estimate Correction
A developer realizes a task is harder than expected and asks the agent to set the story point estimate to 8.

### Status Check
A project manager asks for the release report to see how many issues are still in the Review phase.

## Benefits

- Stop context switching between your IDE and your browser by using move_issue_between_pipelines to update statuses instantly.
- Keep your sprint planning accurate by using set_issue_estimate to update story points without manual data entry.
- Get a bird's-eye view of your project by using get_repo_board to see the full pipeline layout of any repo.
- Track high-level goals more effectively by using list_repo_epics and get_epic_data to see what is in scope.
- Stay on top of deadlines by using list_release_reports to see project progress and release metadata quickly.

## How It Works

The bottom line is you get to manage your entire agile workflow without ever opening a browser tab.

1. Subscribe to the ZenHub MCP on Vinkius.
2. Enter your ZenHub API Token into your AI client configuration.
3. Ask your agent to move an issue, update an estimate, or pull a release report.

## Frequently Asked Questions

**Can the ZenHub MCP update my GitHub issues?**
Yes, it can update specific ZenHub metadata and move issues between your pipelines directly.

**Does ZenHub MCP work with Cursor and VS Code?**
Yes, it works with any MCP-compatible client including Cursor, VS Code, and Claude.

**How do I connect my ZenHub account?**
You'll need to provide your ZenHub API Token in your AI client's configuration after subscribing.

**Can I see my release reports with ZenHub MCP?**
Yes, you can ask your agent to list release reports to see progress metadata for your projects.

**Does ZenHub MCP support story point estimates?**
It allows you to set and retrieve story point estimates for any GitHub issue in your workspace.

**Can I see all my epics at once?**
You can ask your agent to list all epics for a specific repository to get a full overview.

**How do I find my GitHub Repository ID?**
You can find your Repository ID in your GitHub settings, or use a GitHub Connector to query your repository metadata.

**Can I move an issue to a different pipeline using this agent?**
Yes, the `move_issue_between_pipelines` tool allows you to specify a workspace, repository, issue number, and target pipeline ID to update the status.

**Is it possible to set story point estimates?**
Absolutely. Use the `set_issue_estimate` tool with the repository ID, issue number, and your desired point value.