# Pivotal Tracker MCP for AI Agents AI Agent Connect

> Pivotal Tracker lets you manage your agile projects through natural conversation with your AI agent. You can list stories, track epics, and update task statuses without switching tabs. It connects your workspace to tools like Claude or Cursor, making it easy to manage backlogs, check project memberships, and organize labels in real time. This Connector turns your project management into a conversational experience, allowing you to keep your sprint goals updated as you work.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect
- **Tags:** agile, scrum, issue-tracking, software-development, task-management, sprint-planning

## Description

Pivotal Tracker lets you manage your agile projects through natural conversation with your AI agent. You can list tasks, track large work items, and update statuses without switching tabs. It connects your workspace to tools like Claude or Cursor, making it easy to manage backlogs, check memberships, and organize categories in real time.

Imagine you're in the middle of a deep coding session and realize a task status needs to change. Instead of context-switching to your browser, you just tell your agent to move it to finished. This Connector puts your entire agile workflow inside your primary workspace. You can ask about high-level progress on large goals, find specific issues, or see who's assigned to what project without digging through menus. It turns your project management tool into a conversational interface. By adding this to your Vinkius setup, you get a unified way to handle the tedious parts of sprint planning and backlog grooming. It's about getting the data you need exactly when you're working on it, whether that's checking a category distribution or creating a new task on the fly. You don't have to worry about losing your place in a complex project or forgetting to update a ticket. Everything stays in sync because your agent handles the heavy lifting of data entry and status tracking. It's the difference between manually maintaining a board and having a teammate who keeps it updated for you as you work.

## Prompt Examples

**Prompt:** 
```
Show me all the stories we have in project 101.
```

**Response:** 
```
I've retrieved the stories for project 101. Here is the current backlog:

| ID | Story Title | Status |
|---|---|---|
| 442 | Implement OAuth2 flow | **Started** |
| 443 | Fix CSS bug in dashboard | **To Do** |
| 444 | Add user profile export | **Done** |
```

**Prompt:** 
```
Create a bug in project 101 for the login screen crashing.
```

**Response:** 
```
Done! I've created a new bug story in project 101.

*   **Title:** Login screen crashing
*   **Project:** 101
*   **ID:** 987654321
*   **Status:** To Do
```

**Prompt:** 
```
Move story 987654321 to finished.
```

**Response:** 
```
Story 987654321 has been updated to **finished**. I've also updated the project board to reflect this change.
```

## Capabilities

### Create new bug stories
Add a new bug or chore to your project backlog using natural language.

### Update story statuses
Move tasks to different states like started, finished, or delivered.

### List active stories
Get a full list of current stories and features in a specific project.

### View project memberships
See which team members are assigned to specific projects instantly.

### Retrieve epic and label info
Get details on high-level epics and your workspace's categorization labels.

### Get profile context
Verify your current account information and context for the agent.

## Use Cases

### Updating status from the IDE
A developer wants to mark a bug as finished while they are still in VS Code. They can use update_story to change the status without opening a browser.

### Quick backlog checks during standups
A Product Owner needs to see all active stories for a specific project during a meeting. They use list_stories to get a quick summary.

### Monitoring team distribution
A manager wants to know how many people are on a specific project. They use list_project_memberships to see the current assignments.

### Logging issues on the fly
A developer wants to create a chore story for a new library integration. They use create_story to add it to the backlog immediately.

## Benefits

- Update story states like started or finished instantly without leaving your IDE by using update_story.
- Quickly create new bug stories or chores while you're still in the flow of a task using create_story.
- Get a bird's-eye view of project progress by listing all active stories in one prompt using list_stories.
- Check project memberships to see exactly who's assigned to what without opening the dashboard using list_project_memberships.
- Organize your work better by retrieving and listing labels for better categorization using list_labels.
- Keep your requirements up to date by updating story details on the fly using update_story.

## How It Works

The bottom line is you get a hands-free way to manage your agile backlog from any compatible AI client.

1. Subscribe to the Pivotal Tracker MCP on Vinkius.
2. Enter your Pivotal Tracker API Token from your Profile Settings.
3. Start managing your backlog directly from Claude, Cursor, or any Connector client.

## Frequently Asked Questions

**Can I use Pivotal Tracker MCP to manage my backlog?**
Yes, this Connector lets you manage your entire agile backlog through natural conversation. You can create tasks, update statuses, and view project details without ever opening the Pivotal Tracker website.

**How do I connect Pivotal Tracker to my AI agent?**
First, subscribe to the Connector on Vinkius. Then, grab your API Token from your Pivotal Tracker Profile Settings and paste it into your client's connection settings.

**Can I create bugs with Pivotal Tracker MCP?**
Absolutely. You can tell your agent to create a new bug or chore in a specific project, and it will handle the creation and return the new story ID for you.

**Does Pivotal Tracker MCP work with Cursor?**
Yes, it works with any MCP-compatible client, including Cursor, Claude, and Windsurf. It allows you to manage your project data directly from your coding environment.

**How do I find my API token for this?**
You can find your API Token in your Pivotal Tracker account. Just go to your Profile Settings and look for the API section to generate or copy your token.

**Can I see who is working on which project?**
Yes, you can ask your agent to list project memberships. It will retrieve the list of people assigned to your projects so you can see the team distribution instantly.

**How do I find my Pivotal Tracker API Token?**
Log in to Pivotal Tracker, click on your name in the top right, go to **Profile Settings**, and scroll down to the **API Token** section.

**Can I filter stories by their current state?**
Yes! Use the `list_stories` tool and provide a filter like `state:started` or `state:unscheduled` to narrow down the results.

**Does this support checking project memberships?**
Absolutely. Use the `list_memberships` tool with a Project ID to see all users associated with that specific project and their roles.