# Pivotal Tracker MCP > Pivotal Tracker connects your AI client directly to your agile project management workspace. You can manage your entire backlog, track stories and epics, and update tasks—all from a natural conversation. This MCP lets you list projects, create new bugs or features, and shift story statuses (like 'started' or 'delivered') without ever leaving your development environment. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** agile, scrum, issue-tracking, software-development, task-management, sprint-planning ## Description Managing an agile project usually means switching between the chat window, Jira, Asana, and then back to your code editor. It’s a cycle of context-switching that kills flow state. This MCP lets you manage all those steps using only natural language conversation with your AI agent. You tell it what needs doing—whether you need a list of active stories, want to create a new bug ticket for QA, or just need to mark a task as 'started'—and it handles the API calls. Because this connector is part of Vinkius’s catalog, it works with any MCP-compatible client you prefer, so you don't have to worry about which AI platform is handling the connection. You gain full control over your project visibility and backlogs right where you’re working. ## Prompt Examples **Prompt:** ``` List all active stories in project 12345. ``` **Response:** ``` I've retrieved 8 active stories from project 12345. Current ones include 'Implement OAuth2 flow', 'Fix CSS bug in dashboard', and 'Add user profile export'. ``` **Prompt:** ``` Create a new bug story in project 12345 called 'Broken login button'. ``` **Response:** ``` Bug story 'Broken login button' has been successfully created in project 12345. Story ID: 987654321. ``` **Prompt:** ``` Update story 987654321 to 'started' state. ``` **Response:** ``` Story 987654321 has been updated to 'started'. You can now begin work on this task. ``` ## Capabilities ### View Project Structure List all projects or retrieve detailed information on a specific project to maintain oversight of your entire workspace. ### Manage Stories and Features Create, read, update, or delete individual stories (including features, bugs, or general chores) across any configured project. ### Track High-Level Progress List epics and labels to get a clear picture of how your work is categorized and progressing against high-level goals. ### Check Team Assignments See which team members are currently assigned to specific projects or tasks. ### Verify Account Context Retrieve your own user profile information to verify permissions and account details within the system. ## Use Cases ### Mid-Sprint Status Check A Project Manager needs to report on progress for three different teams. Instead of logging into each project's dashboard, they prompt their agent: 'List all projects and check story status in the last week.' The agent uses `list_projects` and `update_stories` capabilities to pull a consolidated, real-time summary. ### Quick Bug Triage A QA specialist finds a UI glitch. They tell their AI client: 'Create a new bug story in the checkout project called Broken Payment Button.' The agent uses `create_story`, logging the ticket immediately and assigning it to the relevant development queue. ### Onboarding New Team Members A new engineer needs context. They ask their agent for 'Project membership details' (`get_memberships`). The agent provides a list of current contributors, allowing the new hire to immediately understand who owns which part of the codebase. ### Reviewing Scope Creep A Product Owner realizes project scope is ballooning. They ask the agent to `list_epics` and then pull related stories, providing a clean breakdown that proves exactly how many features fall under a specific high-level goal. ## Benefits - Stop switching tabs. Use the agent to `list stories` and immediately see all open bugs or features in a project without leaving your chat window. - Keep your project board accurate by having the agent run `update_stories`, shifting status from 'started' to 'delivered' with simple commands. - Get immediate visibility into team workload. Run `get_memberships` to see exactly who is assigned where, solving assignment bottlenecks instantly. - Maintain high-level context using `list_epics`. Quickly understand how a new feature relates to broader company goals just by asking the agent. - New requirements? Use `create_story` to log a bug or feature immediately. It handles the ticket creation and assigns it to the correct project automatically. ## How It Works The bottom line is that it takes complex API interactions needed for agile workflow management and reduces them to simple conversation prompts. 1. Subscribe to this MCP and provide your Pivotal Tracker API Token in the client settings. 2. Direct your AI agent with a command, like 'List all active stories in project X.' 3. The agent executes the necessary calls and returns structured data—like a list of current bugs or an updated story status—directly to you. ## Frequently Asked Questions **Can I use the Pivotal Tracker MCP to check if a user is on the team?** Yes. You can use `get_memberships` to list all team members assigned to any project, giving you immediate visibility into who owns which tasks. **How do I update story statuses using the Pivotal Tracker MCP?** You simply tell your agent to run `update_stories`. You can specify a story ID and the new status, like 'finished' or 'started', in one prompt. **Is listing projects with the Pivotal Tracker MCP restricted?** No. The `list_projects` capability allows you to see all available projects across your workspace, giving you a starting point for any query. **What if I need to add a new bug? Do I use the Pivotal Tracker MCP?** Yes. Use `create_story`. You can specify that it's a bug or feature and name it, logging it directly into the correct project backlog. **Does this MCP help with high-level planning like epics?** Absolutely. The `list_epics` tool lets you review the main organizational categories and labels, helping you understand how current stories fit into the broader roadmap.