# PingCode MCP

> PingCode MCP connects your AI agent directly to an agile project management platform for R&D teams. It lets you manage work items, track sprints, monitor releases, and retrieve documentation without opening a dashboard. You talk naturally, and it updates your entire development pipeline.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** agile, sprint-planning, issue-tracking, rd-management, wiki, workflow-automation

## Description

Forget clicking through endless dashboards just to find out what's happening with a feature or who owns a bug. This MCP connects your AI agent to PingCode, the platform R&D teams use for complex project coordination. Instead of juggling tabs to list projects, check sprints, and then search the wiki, you talk to your agent like talking to a team lead who already knows everything. Your agent handles all that complexity: it lists active agile projects, creates new tasks with full descriptions, checks sprint progress, or pulls specific documentation from the knowledge base. It makes the entire software development lifecycle feel less like navigating complicated forms and more like having a natural conversation. Vinkius hosts this MCP so you can connect PingCode to any compatible client you already use. You get an R&D assistant that keeps your pipeline moving and your documentation instantly accessible.

## Tools

### create_work_item
Creates a new task, story, or bug item in the project management system.

### get_project
Fetches detailed information about a specific agile development project.

### get_wiki_page
Retrieves the full content of a specified wiki page by its name or ID.

### list_members
Provides a list of all people belonging to the organization and their roles.

### list_projects
Retrieves names and details for every agile project currently set up in PingCode.

### list_releases
Lists all planned or completed releases associated with a specific project.

### list_sprints
Shows the active and upcoming sprints for an agile development project.

### list_teams
Lists all departmental teams within the organization structure.

### list_wiki_pages
Provides a searchable list of available wiki pages across the entire platform.

### list_work_items
Retrieves a paginated list of all work items, like bugs or tasks, within a defined project scope.

## Prompt Examples

**Prompt:** 
```
List all agile projects in my PingCode organization.
```

**Response:** 
```
I've retrieved your PingCode projects. You have 5 active agile projects, including 'Core Engine Refactor' and 'Mobile App V3'. Which one would you like to view items for?
```

**Prompt:** 
```
Create a new bug item in project 'Checkout Flow' titled 'Payment timeout on mobile'.
```

**Response:** 
```
Done! I've created a new bug item 'Payment timeout on mobile' in the 'Checkout Flow' project. I've also set the item type to 'bug' for you. Would you like to add a description?
```

**Prompt:** 
```
Retrieve the content of the wiki page 'System Architecture' from repository 'PROJ-DOCS'.
```

**Response:** 
```
I've retrieved the 'System Architecture' page. It contains detailed diagrams and component descriptions for the current architecture. Would you like me to summarize the key modules?
```

## Capabilities

### Track Projects and Work Items
List all available agile projects and create new work items, such as tasks or bugs, directly through chat.

### Monitor Development Cycles
View active sprints, track upcoming releases, and get details about the overall project scope.

### Manage Team Structure
List all organizational teams and members to quickly figure out who is assigned to what.

### Access Project Documentation
Find and retrieve specific content from the wiki or list all available knowledge repositories.

## Use Cases

### A new feature requires immediate documentation.
The developer asks the agent: 'What are the auth requirements for V3?' The agent uses list_wiki_pages and then get_wiki_page to pull the correct section from the System Architecture page, saving a half-hour of manual searching.

### A high-priority bug needs tracking.
The Product Owner simply types: 'Create a critical bug for payment failure in the checkout flow.' The agent executes create_work_item and automatically sets the priority, ensuring the right people see it instantly.

### Need to update team assignments quickly.
The Agile Coach asks: 'Who is on the Core Engine Refactor team?' The agent runs list_teams and then lists_members to give a comprehensive roster, helping reassign tasks faster than manual email chains.

### Checking overall product readiness.
A manager asks: 'What's the status of the next two releases?' The agent uses list_releases and combines it with list_sprints to give a full, aggregated view of the delivery pipeline.

## Benefits

- Stop switching contexts. Instead of opening PingCode to list agile projects and then switching over to the wiki to find specs, your agent handles both requests instantly in one chat window.
- Never lose track of a bug again. You can ask your agent to create_work_item for a new issue, automatically capturing all necessary metadata and assigning it immediately.
- Get an instant project health check. With list_sprints and list_releases, you get a clear view of the delivery schedule without running reports or clicking through status dashboards.
- Knowledge is easy to find. Instead of guessing which wiki page holds the answer, use list_wiki_pages and then get_wiki_page to pull exact documentation content on demand.
- Understand ownership immediately. By using list_teams and list_members, you can figure out who owns a piece of code or who is assigned to a task without manual lookups.

## How It Works

The bottom line is, once connected, your AI agent handles the API calls and data parsing so you don't have to.

1. Subscribe to this MCP, then enter your PingCode Client ID and Client Secret.
2. Connect your preferred AI client (Claude, Cursor, etc.) using the credentials you just set up.
3. Tell your agent what you need; for example, 'List all active sprints for the Mobile App V3 project.'

## Frequently Asked Questions

**How do I list all my available projects using PingCode MCP?**
You use the list_projects tool. This gives you a comprehensive view of every agile project defined in your organization, helping you narrow down where to focus your efforts.

**Can PingCode MCP create tasks or bugs? What is the correct tool?**
Yes, you can use the create_work_item tool. This allows you to define a new piece of work—a bug, story, or task—and push it directly into your project backlog.

**Does PingCode MCP know where my technical documentation is?**
Yes, the list_wiki_pages tool lets you browse available knowledge areas. After finding the correct page, use get_wiki_page to pull the actual content.

**I need to check team assignments; which tool should I use with PingCode MCP?**
You can list_teams first to see all departments, and then list_members will provide a roster of people belonging to those teams or projects.

**What if I want to know the status of sprints and releases together? Can PingCode MCP handle that?**
You can combine list_sprints with list_releases. This allows your agent to give you a timeline view, showing what development cycles are active versus when the features ship.