@freelancercom/phabricator-mcp 2.0.8 → 2.0.10

package/README.md

@@ -290,6 +290,7 @@ To allowlist all tools including write operations, use `"mcp__phabricator__*"` i
 | Tool | Description |
 |------|-------------|
 | `phabricator_blog_search` | Search Phame blogs |
+| `phabricator_blog_edit` | Create or edit a Phame blog |
 | `phabricator_blog_post_search` | Search blog posts |
 | `phabricator_blog_post_create` | Create a new blog post |
 | `phabricator_blog_post_edit` | Edit an existing blog post |

package/dist/tools/conpherence.js

@@ -8,7 +8,7 @@ export function registerConpherenceTools(server, client) {
             ids: z.array(z.coerce.number()).optional().describe('Room IDs'),
             phids: z.array(z.string()).optional().describe('Room PHIDs'),
             participants: z.array(z.string()).optional().describe('Participant user PHIDs'),
-            query: z.string().optional().describe('Full-text search query'),
+            fulltext: z.string().optional().describe('Search for rooms containing these words'),
         })).optional().describe('Search constraints'),
         order: z.string().optional().describe('Result order'),
         limit: z.coerce.number().max(100).optional().describe('Maximum results (max 100)'),

package/dist/tools/differential.js

@@ -10,7 +10,7 @@ export function registerDifferentialTools(server, client) {
             authorPHIDs: z.array(z.string()).optional().describe('Author PHIDs'),
             reviewerPHIDs: z.array(z.string()).optional().describe('Reviewer PHIDs'),
             repositoryPHIDs: z.array(z.string()).optional().describe('Repository PHIDs'),
-            statuses: z.array(z.string()).optional().describe('Statuses: needs-review, needs-revision, accepted, published, abandoned, changes-planned'),
+            statuses: z.array(z.string()).optional().describe('Statuses: needs-review, needs-revision, accepted, published, abandoned, changes-planned, draft'),
             responsiblePHIDs: z.array(z.string()).optional().describe('User PHIDs who are responsible (as author or reviewer)'),
             affectedPaths: z.array(z.string()).optional().describe('File paths affected by the revision'),
             createdStart: z.coerce.number().optional().describe('Created after (epoch timestamp)'),

package/dist/tools/diffusion.js

@@ -162,6 +162,8 @@ export function registerDiffusionTools(server, client) {
         status: z.enum(['active', 'inactive']).optional().describe('Repository status'),
         addProjectPHIDs: z.array(z.string()).optional().describe('Project PHIDs to add'),
         removeProjectPHIDs: z.array(z.string()).optional().describe('Project PHIDs to remove'),
+        addSubscriberPHIDs: z.array(z.string()).optional().describe('Subscriber PHIDs to add'),
+        removeSubscriberPHIDs: z.array(z.string()).optional().describe('Subscriber PHIDs to remove'),
         space: z.string().optional().describe('Space PHID (for multi-space installations)'),
     }, async (params) => {
         const transactions = [];
@@ -192,6 +194,12 @@ export function registerDiffusionTools(server, client) {
         if (params.removeProjectPHIDs !== undefined) {
             transactions.push({ type: 'projects.remove', value: params.removeProjectPHIDs });
         }
+        if (params.addSubscriberPHIDs !== undefined) {
+            transactions.push({ type: 'subscribers.add', value: params.addSubscriberPHIDs });
+        }
+        if (params.removeSubscriberPHIDs !== undefined) {
+            transactions.push({ type: 'subscribers.remove', value: params.removeSubscriberPHIDs });
+        }
         if (params.space !== undefined) {
             transactions.push({ type: 'space', value: params.space });
         }

package/dist/tools/file.js

@@ -5,11 +5,20 @@ export function registerFileTools(server, client) {
     server.tool('phabricator_file_upload', 'Upload a file to Phabricator. Returns a file PHID that can be used with phabricator_file_info to get the file ID for embedding in Remarkup via {F<id>}.', {
         name: z.string().describe('Filename with extension (e.g. "screenshot.png")'),
         data_base64: z.string().describe('Base64-encoded file content'),
+        viewPolicy: z.string().optional().describe('File visibility policy (e.g., "public", "users", or a custom policy PHID)'),
+        canCDN: z.boolean().optional().describe('Whether the file can be served over CDN (for public assets)'),
     }, async (params) => {
-        const phid = await client.call('file.upload', {
+        const apiParams = {
             name: params.name,
             data_base64: params.data_base64,
-        });
+        };
+        if (params.viewPolicy !== undefined) {
+            apiParams.viewPolicy = params.viewPolicy;
+        }
+        if (params.canCDN !== undefined) {
+            apiParams.canCDN = params.canCDN;
+        }
+        const phid = await client.call('file.upload', apiParams);
         return { content: [{ type: 'text', text: phid }] };
     });
     // Search files

package/dist/tools/harbormaster.js

@@ -10,6 +10,7 @@ export function registerHarbormasterTools(server, client) {
             objectPHIDs: z.array(z.string()).optional().describe('Object PHIDs (revision or commit PHIDs)'),
             containerPHIDs: z.array(z.string()).optional().describe('Container PHIDs'),
             statuses: z.array(z.string()).optional().describe('Buildable statuses'),
+            manual: z.boolean().optional().describe('Filter to manual buildables only (true) or automated only (false)'),
         })).optional().describe('Search constraints'),
         order: z.string().optional().describe('Result order'),
         limit: z.coerce.number().max(100).optional().describe('Maximum results (max 100)'),
@@ -26,7 +27,7 @@ export function registerHarbormasterTools(server, client) {
             ids: z.array(z.coerce.number()).optional().describe('Build IDs'),
             phids: z.array(z.string()).optional().describe('Build PHIDs'),
             buildables: z.array(z.string()).optional().describe('Buildable PHIDs'),
-            plans: z.array(z.string()).optional().describe('Build plan PHIDs'),
+            plans: z.array(z.string()).optional().describe('Build plan PHIDs (use phabricator_build_plan_search to find these)'),
             statuses: z.array(z.string()).optional().describe('Build statuses: building, passed, failed, aborted, error, paused'),
             initiators: z.array(z.string()).optional().describe('PHIDs of users/objects that initiated the build'),
         })).optional().describe('Search constraints'),
@@ -46,10 +47,12 @@ export function registerHarbormasterTools(server, client) {
             phids: z.array(z.string()).optional().describe('Target PHIDs'),
             buildPHIDs: z.array(z.string()).optional().describe('Build PHIDs'),
             statuses: z.array(z.string()).optional().describe('Target statuses'),
-            dateCreatedStart: z.coerce.number().optional().describe('Created after (epoch timestamp)'),
-            dateCreatedEnd: z.coerce.number().optional().describe('Created before (epoch timestamp)'),
-            dateModifiedStart: z.coerce.number().optional().describe('Modified after (epoch timestamp)'),
-            dateModifiedEnd: z.coerce.number().optional().describe('Modified before (epoch timestamp)'),
+            createdStart: z.coerce.number().optional().describe('Created after (epoch timestamp)'),
+            createdEnd: z.coerce.number().optional().describe('Created before (epoch timestamp)'),
+            startedStart: z.coerce.number().optional().describe('Started executing after (epoch timestamp)'),
+            startedEnd: z.coerce.number().optional().describe('Started executing before (epoch timestamp)'),
+            completedStart: z.coerce.number().optional().describe('Completed after (epoch timestamp)'),
+            completedEnd: z.coerce.number().optional().describe('Completed before (epoch timestamp)'),
         })).optional().describe('Search constraints'),
         order: z.string().optional().describe('Result order'),
         limit: z.coerce.number().max(100).optional().describe('Maximum results (max 100)'),

package/dist/tools/maniphest.js

@@ -21,8 +21,8 @@ export function registerManiphestTools(server, client) {
             modifiedEnd: z.coerce.number().optional().describe('Modified before (epoch timestamp)'),
             parentIDs: z.array(z.coerce.number()).optional().describe('Parent task IDs'),
             subtaskIDs: z.array(z.coerce.number()).optional().describe('Subtask IDs'),
-            hasParents: z.boolean().optional().describe('Filter to tasks that have open parent tasks'),
-            hasSubtasks: z.boolean().optional().describe('Filter to tasks that have open subtasks'),
+            hasParents: z.boolean().optional().describe('true: only tasks with open parent tasks. false: only tasks without. Omit to show all.'),
+            hasSubtasks: z.boolean().optional().describe('true: only tasks with open subtasks. false: only tasks without. Omit to show all.'),
             spaces: z.array(z.string()).optional().describe('Filter by Space PHIDs (for multi-space installations)'),
             closedStart: z.coerce.number().optional().describe('Closed after (epoch timestamp)'),
             closedEnd: z.coerce.number().optional().describe('Closed before (epoch timestamp)'),

package/dist/tools/phame.js

@@ -24,6 +24,61 @@ export function registerPhameTools(server, client) {
         const result = await client.call('phame.blog.search', params);
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
+    // Edit a blog
+    server.tool('phabricator_blog_edit', 'Create or edit a Phame blog. Omit objectIdentifier to create a new blog (name is required for creation).', {
+        objectIdentifier: z.string().optional().describe('Blog PHID or ID. Omit to create a new blog.'),
+        name: z.string().optional().describe('Blog name'),
+        subtitle: z.string().optional().describe('Blog subtitle'),
+        description: z.string().optional().describe('Blog description (Remarkup)'),
+        fullDomain: z.string().optional().describe('Custom full domain for the blog'),
+        parentSite: z.string().optional().describe('Parent site name'),
+        parentDomain: z.string().optional().describe('Parent domain URL'),
+        status: z.string().optional().describe('Blog status'),
+        addSubscriberPHIDs: z.array(z.string()).optional().describe('Subscriber PHIDs to add'),
+        removeSubscriberPHIDs: z.array(z.string()).optional().describe('Subscriber PHIDs to remove'),
+        comment: z.string().optional().describe('Add a comment alongside the edit (supports Remarkup)'),
+    }, async (params) => {
+        const transactions = [];
+        if (params.name !== undefined) {
+            transactions.push({ type: 'name', value: params.name });
+        }
+        if (params.subtitle !== undefined) {
+            transactions.push({ type: 'subtitle', value: params.subtitle });
+        }
+        if (params.description !== undefined) {
+            transactions.push({ type: 'description', value: params.description });
+        }
+        if (params.fullDomain !== undefined) {
+            transactions.push({ type: 'fullDomain', value: params.fullDomain });
+        }
+        if (params.parentSite !== undefined) {
+            transactions.push({ type: 'parentSite', value: params.parentSite });
+        }
+        if (params.parentDomain !== undefined) {
+            transactions.push({ type: 'parentDomain', value: params.parentDomain });
+        }
+        if (params.status !== undefined) {
+            transactions.push({ type: 'status', value: params.status });
+        }
+        if (params.addSubscriberPHIDs !== undefined) {
+            transactions.push({ type: 'subscribers.add', value: params.addSubscriberPHIDs });
+        }
+        if (params.removeSubscriberPHIDs !== undefined) {
+            transactions.push({ type: 'subscribers.remove', value: params.removeSubscriberPHIDs });
+        }
+        if (params.comment !== undefined) {
+            transactions.push({ type: 'comment', value: params.comment });
+        }
+        if (transactions.length === 0) {
+            return { content: [{ type: 'text', text: 'No changes specified' }] };
+        }
+        const apiParams = { transactions };
+        if (params.objectIdentifier !== undefined) {
+            apiParams.objectIdentifier = params.objectIdentifier;
+        }
+        const result = await client.call('phame.blog.edit', apiParams);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
     // Search blog posts
     server.tool('phabricator_blog_post_search', 'Search Phame blog posts', {
         queryKey: z.string().optional().describe('Built-in query: "all", "live"'),
@@ -31,7 +86,7 @@ export function registerPhameTools(server, client) {
             ids: z.array(z.coerce.number()).optional().describe('Post IDs'),
             phids: z.array(z.string()).optional().describe('Post PHIDs'),
             blogPHIDs: z.array(z.string()).optional().describe('Filter by blog PHIDs'),
-            visibility: z.array(z.string()).optional().describe('Visibility: "published", "draft", "archived" (or numeric: "1", "0", "2")'),
+            visibility: z.array(z.coerce.number()).optional().describe('Visibility values: 0 (draft), 1 (published), 2 (archived)'),
             subscribers: z.array(z.string()).optional().describe('Subscriber user/project PHIDs'),
             projects: z.array(z.string()).optional().describe('Project PHIDs'),
             query: z.string().optional().describe('Full-text search query'),
@@ -54,7 +109,7 @@ export function registerPhameTools(server, client) {
         body: z.string().describe('Post body content (supports Remarkup)'),
         blogPHID: z.string().describe('PHID of the blog to post to'),
         subtitle: z.string().optional().describe('Post subtitle'),
-        visibility: z.string().optional().describe('Visibility: "published", "draft", "archived" (default: draft)'),
+        visibility: z.coerce.number().optional().describe('Visibility: 0 (draft, default), 1 (published), 2 (archived)'),
         addSubscriberPHIDs: z.array(z.string()).optional().describe('Subscriber PHIDs to add'),
     }, async (params) => {
         const transactions = [
@@ -80,7 +135,7 @@ export function registerPhameTools(server, client) {
         title: z.string().optional().describe('New post title'),
         subtitle: z.string().optional().describe('New post subtitle'),
         body: z.string().optional().describe('New post body content (supports Remarkup)'),
-        visibility: z.string().optional().describe('Visibility: "published", "draft", "archived"'),
+        visibility: z.coerce.number().optional().describe('Visibility: 0 (draft), 1 (published), 2 (archived)'),
         blogPHID: z.string().optional().describe('Move post to a different blog (PHID)'),
         addSubscriberPHIDs: z.array(z.string()).optional().describe('Subscriber PHIDs to add'),
         removeSubscriberPHIDs: z.array(z.string()).optional().describe('Subscriber PHIDs to remove'),

package/dist/tools/phid.js

@@ -8,7 +8,7 @@ export function registerPhidTools(server, client) {
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
     // Query PHID details
-    server.tool('phabricator_phid_query', 'Get detailed information about PHIDs', {
+    server.tool('phabricator_phid_query', 'Get handle information (name, URI, type, status) for PHIDs. For full object data, use application-specific search tools (e.g., phabricator_task_search, phabricator_revision_search).', {
         phids: z.array(z.string()).describe('PHIDs to query'),
     }, async (params) => {
         const result = await client.call('phid.query', { phids: params.phids });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freelancercom/phabricator-mcp",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "MCP server for Phabricator Conduit API - manage tasks, code reviews, repositories, and more",
   "type": "module",
   "main": "dist/index.js",