# Phabricator MCP for AI Agents AI Agent Connect

> Phabricator MCP lets you manage tasks, code reviews, and repositories from your AI client. It connects to your Phabricator instance using the Conduit API to handle Maniphest tasks, Differential revisions, and Diffusion commits. You can search for specific work items, update statuses, and query repository data without leaving your IDE. It's the primary way to bring your Phabricator development workflow into your AI agent's reach.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DImuVRek95xjoDlWmnK3Ly0cuOyvrltJYjjMoI11/ai-agent-connect
- **Tags:** phabricator, conduit-api, code-review, task-tracking, monorepo, devops

## Description

This Connector connects your Phabricator instance to your AI client so you can handle project management and code review tasks without switching tabs. You can ask your agent to find specific tasks, update statuses, or pull repository data directly. It works by talking to the Conduit API, which means it handles the heavy lifting for Maniphest, Differential, and Diffusion. When you use this through the Vinkius catalog, you get a direct line to your dev data. You'll spend less time digging through nested menus and more time actually writing code. If you need to know the history of a task or find a specific commit in a massive monorepo, the AI does the searching for you. It handles the filtering and the retrieval so you can just get the answers you need in your IDE. You can see who is assigned to what, find the status of a pull request, and get the full audit trail of any task in seconds. Instead of copy-pasting IDs or searching through multiple browser windows, your agent just knows where everything is. You get a way to manage your monorepo and your team's progress through natural language. It turns Phabricator from a separate destination into a reachable part of your workspace. You can check your own permissions, find other team members, and keep your sprint moving forward with just a few prompts. It's about getting the data you need to make decisions without the friction of manual navigation.

## Tools

### diffusion_commit_search
Search for Diffusion commits. Use this to find a specific piece of code or a change in your repository history.

### diffusion_repository_search
Search for Diffusion repositories. This helps you locate the correct repo in a large monorepo.

### maniphest_search
Search for Maniphest tasks. It supports complex filtering so you can find specific tickets based on status or owner.

### maniphest_edit
Create or update a Maniphest task. Use this to change task owners, statuses, or add comments on the fly.

### differential_revision_edit
Create or update a Differential revision. Use this to accept changes or request edits on a code review.

### differential_revision_search
Search for Differential revisions. This helps you find specific code reviews quickly using search terms.

### maniphest_gettasktransactions
Get transaction history for a task. This provides a full audit trail of every change made to a ticket.

### user_search
Search for users. Use this to find the correct person to assign a task to or to find a specific contributor.

### differential_query
Query Differential revisions. This is the best way to access legacy revision data on your platform.

### user_whoami
Get details about the authenticated user. This confirms which account the AI is currently using for actions.

## Prompt Examples

**Prompt:** 
```
Who is the currently authenticated Phabricator user?
```

**Response:** 
```
I've checked your credentials. You are currently logged in as **dev_lead** (PHID-USER-1234567890).
```

**Prompt:** 
```
Search for all open tasks in Maniphest assigned to me.
```

**Response:** 
```
I found 3 open tasks assigned to you:

| ID | Title | Status |
| --- | --- | --- |
| T452 | Fix Auth Bug | In Progress |
| T458 | Update Documentation | To Do |
| T460 | Refactor Database | In Progress |

Would you like more details on any of these?
```

**Prompt:** 
```
Show me the recent history for task T101.
```

**Response:** 
```
Retrieving history for **T101**...

* **2 days ago**: Created by *alice*
* **Yesterday**: Moved to *In Progress* by *bob*
* **4 hours ago**: *charlie* added a comment regarding the API specs.
```

## Capabilities

### Search and filter tasks
Find specific Maniphest tasks using complex filters to identify blockers or progress.

### Update task status
Change owners, statuses, and add comments to tasks without leaving your editor.

### Manage code revisions
Query and edit Differential revisions to accept or request changes on your code.

### Query repository data
Search for Diffusion repositories and specific commits across your entire monorepo.

### Retrieve audit trails
Get the full transaction history for any task to see every change made over time.

### Identify team members
Search for users across the platform or check your own authenticated details.

## Use Cases

### Checking for blockers
A developer asks their agent to find all open tasks assigned to them with 'blocker' in the description. The agent uses `maniphest_search` to find them.

### Updating a pull request
A developer finishes a fix and tells the agent to accept changes on a revision using `differential_revision_edit`.

### Audit trail review
A manager wants to know why a task changed status three times. The agent uses `maniphest_gettasktransactions` to show the history.

### Repository discovery
A new hire needs to find where the auth logic lives. The agent uses `diffusion_repository_search` to find the right repo.

## Benefits

- Update task statuses instantly using `maniphest_edit` without leaving your editor.
- Find specific code changes faster with `differential_revision_search` and `differential_query`.
- Track monorepo history by searching for commits via `diffusion_commit_search`.
- Audit task lifecycles with `maniphest_gettasktransactions` to see every change made.
- Identify team members quickly using `user_search` to assign work or find owners.
- Reduce context switching by managing your entire Phabricator workflow from your AI client.

## How It Works

The bottom line is you get a direct line to your Phabricator data without leaving your development environment.

1. Subscribe to the Phabricator MCP and provide your Instance URL and Conduit API Token.
2. Connect the Connector to your AI client like Claude, Cursor, or Windsurf.
3. Ask your agent to find tasks, search commits, or update revisions using natural language.

## Frequently Asked Questions

**Can the Phabricator MCP help me manage my daily tasks?**
Yes, it lets your agent find and update Maniphest tasks for you. You can ask it to find specific items based on status or owner and make updates without leaving your editor.

**How does the Phabricator MCP handle code reviews?**
It connects to your Differential revisions. Your agent can search for specific reviews and perform actions like accepting changes or requesting edits.

**Can I use the Phabricator MCP to see who worked on a task?**
Yes, it can retrieve the full transaction history of any task. This shows you every change, including who made it and when.

**Does the Phabricator MCP work with my existing Phabricator setup?**
It works with any Phabricator instance that has the Conduit API enabled. You just need to provide your instance URL and a valid API token.

**Can I find specific commits using the Phabricator MCP?**
Yes, it can search for Diffusion commits across your platform. This is especially helpful for navigating large monorepos.

**Can I use the Phabricator MCP to find other team members?**
Yes, it includes a search tool to find users across your platform, making it easy to identify the right person for a task or a code review.

**Can I update the status of a Maniphest task using this server?**
Yes. You can use the `maniphest_edit` tool. You'll need to provide the task identifier (like T123) and a transaction object specifying the 'status' type and the desired value.

**How do I see the full history of changes for a specific task?**
Use the `maniphest_gettasktransactions` tool with the task ID (e.g., 'T123'). It will return a chronological list of all edits, comments, and status changes made to that task.

**Can I search for code revisions that are currently open?**
Absolutely. Use `differential_revision_search` and pass a constraint for statuses like 'open' or 'needs-review' to filter the results to active code reviews.