# VivifyScrum MCP MCP

> VivifyScrum lets you manage agile projects using natural conversation. It connects your AI client directly to Scrum and Kanban boards, letting you plan sprints, groom backlogs, and update tasks without leaving your chat window.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** agile-methodology, scrum-boards, kanban-boards, sprint-planning, backlog-grooming, task-tracking

## Description

Managing a software project is about juggling cycles—sprints, stories, bugs, and team assignments. This MCP lets your agent handle that complexity for you. Instead of jumping between the board UI, the backlog list, and the calendar view, you talk to it. You can ask what tasks are due this week or check out who's been logging time on a specific feature.

It handles everything from listing all available boards to creating brand new items. For example, if your team needs to shift focus after a sprint review, you simply tell the agent to update several stories and list the resulting changes. This automation is powerful because it lets you combine multiple systems in one flow; for instance, chaining this with a messaging MCP to notify stakeholders when a major task moves from 'In Progress' to 'Done'. You don't have to build that complex wiring yourself; you just connect everything through Vinkius, and the platform manages the secure connection using its zero-trust proxy. You get full visibility into every tool call via Vinkius AI Analytics so nothing happens in the dark.

## Tools

### create_item
Builds and adds a brand new task or story to an agile board.

### get_account_info
Retrieves basic account details for the connected VivifyScrum workspace.

### get_board
Fetches detailed configuration metadata and settings for a specific project board.

### get_item
Gets all the details, including history, of a single task or story item on a board.

### get_worklogs
Retrieves records showing who worked on which feature and for how long.

### list_boards
Provides a complete list of every board available in the account.

### list_board_items
Pulls a list of all tasks currently present on a specific board.

### list_organizations
Lists all distinct organizations connected to the VivifyScrum account.

### list_sprints
Shows a list of past, current, and future development sprints for a board.

### list_teams
Retrieves the names and members of all defined teams within the system.

### list_webhooks
Displays a list of configured webhooks, which track events for external systems.

### update_item
Modifies the description or status of an existing task item on a board.

## Prompt Examples

**Prompt:** 
```
List all boards in my VivifyScrum account.
```

**Response:** 
```
I've retrieved your boards. You have access to: 'Product Development' (Scrum), 'Marketing Content' (Kanban), and 'Customer Support'. Which one would you like to open?
```

**Prompt:** 
```
Show me the tasks for the 'Product Development' board.
```

**Response:** 
```
I've fetched the items. There are 5 active tasks including 'Implement MCP Server', 'Fix login bug', and 'Design new logo'. Would you like details on any specific task?
```

**Prompt:** 
```
Create a new task named 'Verify API Scopes' on board '88231'.
```

**Response:** 
```
Success! The task 'Verify API Scopes' has been created on board 88231 (ID: task_10293). Shall I add a description to it?
```

## Capabilities

### View Project Structure
List all boards, organizations, sprints, and teams to see the overall project scope.

### Inspect Board Details
Retrieve detailed configuration metadata for specific boards or get a full list of tasks currently on any board.

### Manage Tasks
Create, update descriptions for, and retrieve individual items (tasks or stories) on the agile boards.

### Track Time and History
Check worklogs to see who worked on what feature and when, or list configured webhooks for system monitoring.

## Use Cases

### The Sprint Review Cleanup
A Product Owner needs to document the progress for a key feature that was just completed. Instead of manually updating tickets, they ask the agent to `get_item` details on the 'Feature X' task and then use `update_item` to mark it as 'Ready for QA,' generating an audit trail automatically.

### Initial Project Setup
A new Scrum Master joins a client account. They start by asking the agent to `list_organizations`, then use `list_boards` and `list_teams` to map out everyone's access rights and understand the entire operational structure.

### Mid-Sprint Status Check
A Project Manager needs a quick status on a specific area. They ask the agent to list items for the 'Marketing Content' board, then check `get_worklogs` to see if the design team has logged time against any of those tasks yet.

### Backlog Grooming Session
The PO and two developers are chatting. The PO asks the agent to `create_item` for a new bug ('Fix payment gateway error') on the 'Product Development' board, immediately adding it to the backlog without opening the tool.

## Benefits

- Stop switching tabs to check task status. You can list board items and then get item details in a single conversational turn, giving you full visibility into the project's current state.
- Keep track of accountability without opening reports. Use `get_worklogs` to instantly see who worked on what feature and when, making retrospectives faster than ever.
- Planning is fast. Need to know where the team stands? List sprints or list boards to quickly understand development cycles and project scope.
- Never lose track of the backlog. You can use `create_item` for quick grooming sessions right from your chat window, adding tasks instantly without needing board access.
- It's all secured. Because this MCP runs on Vinkius, credentials pass through a zero-trust proxy. Your keys never sit on disk; they only move in transit.

## How It Works

The bottom line is you talk to your AI client, and it handles the complex series of API calls needed to get the answer from VivifyScrum.

1. Subscribe to this MCP and enter your VivifyScrum API Token in the Vinkius Marketplace.
2. Connect your preferred AI client (Claude, Cursor, etc.) once to the platform.
3. Start by asking the agent a question like 'Show me all boards' or 'Create a new task for X'. The agent executes the necessary tool calls in the background.

## Frequently Asked Questions

**How do I list all boards using the VivifyScrum MCP?**
Just ask to 'list all boards.' The agent calls `list_boards` and gives you a complete inventory of every project board in your account. This is great for figuring out where a task belongs.

**Can I update tasks using the VivifyScrum MCP? Which tool do I use?**
Yes, you use `update_item`. You just need to specify which item and what change you want—like updating its description or changing its status. It makes sure your changes are recorded.

**If I run out of board space, can the VivifyScrum MCP help?**
The MCP doesn't manage capacity, but if you need to track who is working on what, use `get_worklogs`. It shows historical time spent, which helps identify bottlenecks or underutilized resources.

**What if I want to create a new item without knowing the board ID?**
First, run `list_boards` to see your available boards. Then reference that name when you ask the agent to `create_item`, and it'll handle linking it correctly.

**How do I check my organization's access and scope using the `get_account_info` tool?**
It provides your current account details and defined scopes. This confirms which organizations you have permission to view before running complex queries like listing board items or sprints.

**Can I retrieve historical time tracking data using the `get_worklogs` tool?**
Yes, this tool pulls all recorded work logs for a specific board. You can see who worked on what and when, which is essential for accurate billing or capacity planning.

**What if I need to monitor external system triggers using the `list_webhooks` tool?**
The `list_webhooks` tool displays all configured webhooks for monitoring. This confirms what events trigger actions outside of VivifyScrum, helping you ensure no integrated process breaks.

**Which tool should I use to manage and view team membership using the `list_teams` tool?**
This tool fetches a list of all teams and their members within your organization. You can quickly verify who needs visibility on certain boards or who belongs to specific project groups.

**Can I list all the tasks assigned to a specific board?**
Yes! Use the `list_board_items` tool and provide the Board ID. Your agent will retrieve all tasks and stories for that project.

**How do I see the active sprints for my project?**
Run the `list_sprints` query with your Board ID. The agent will return a list of all sprints associated with that board, including their current status.

**Is it possible to track time logs via AI?**
Absolutely. Use the `get_worklogs` tool with your Board ID to retrieve the history of time tracking entries for that project.