@vibescope/mcp-server 0.3.7 → 0.3.9

package/dist/handlers/cloud-agents.d.ts

@@ -15,6 +15,10 @@ export declare const cleanupStaleCloudAgents: Handler;
  * List cloud agents for a project with optional status filter.
  */
 export declare const listCloudAgents: Handler;
+/**
+ * Update agent status message (for dashboard display).
+ */
+export declare const updateAgentStatus: Handler;
 /**
  * Cloud agents handlers registry
  */

package/dist/handlers/cloud-agents.js

@@ -82,10 +82,32 @@ export const listCloudAgents = async (args, ctx) => {
         count: response.data.agents.length
     });
 };
+/**
+ * Update agent status message (for dashboard display).
+ */
+export const updateAgentStatus = async (args, ctx) => {
+    const statusMessage = args.status_message;
+    const projectId = (args.project_id || ctx.session.currentProjectId);
+    const agentName = args.agent_name;
+    if (!statusMessage) {
+        return error('status_message is required');
+    }
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('update_agent_status', {
+        project_id: projectId,
+        agent_name: agentName,
+        status_message: statusMessage,
+    });
+    if (!response.ok) {
+        return error(response.error || 'Failed to update status');
+    }
+    return success({ updated: true, status_message: statusMessage });
+};
 /**
  * Cloud agents handlers registry
  */
 export const cloudAgentHandlers = {
     cleanup_stale_cloud_agents: cleanupStaleCloudAgents,
     list_cloud_agents: listCloudAgents,
+    update_agent_status: updateAgentStatus,
 };

package/dist/handlers/discovery.js

@@ -323,6 +323,20 @@ export const TOOL_CATEGORIES = {
             { name: 'list_cloud_agents', brief: 'List cloud agents for project' },
         ],
     },
+    chat: {
+        description: 'Project-wide chat channel for agent and user communication',
+        tools: [
+            { name: 'send_project_message', brief: 'Send a message to the project chat' },
+            { name: 'get_project_messages', brief: 'Read recent project chat messages' },
+        ],
+    },
+    version: {
+        description: 'MCP server version management and updates',
+        tools: [
+            { name: 'check_mcp_version', brief: 'Check for MCP server updates' },
+            { name: 'update_mcp_server', brief: 'Self-update the MCP server' },
+        ],
+    },
 };
 export const discoverTools = async (args) => {
     const { category } = parseArgs(args, discoverToolsSchema);

package/dist/tools/chat.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Project chat tools:
+ * - send_project_message
+ * - get_project_messages
+ */
+import type { Tool } from './types.js';
+export declare const chatTools: Tool[];

package/dist/tools/chat.js

@@ -0,0 +1,43 @@
+/**
+ * Project chat tools:
+ * - send_project_message
+ * - get_project_messages
+ */
+export const chatTools = [
+    {
+        name: 'send_project_message',
+        description: 'Send a message to the project chat channel. All agents and the project owner can see messages here. Use this to communicate status updates, ask questions, report blockers, or coordinate with other agents.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                message: {
+                    type: 'string',
+                    description: 'Message content (supports markdown)',
+                },
+            },
+            required: ['project_id', 'message'],
+        },
+    },
+    {
+        name: 'get_project_messages',
+        description: 'Read recent messages from the project chat channel. Use this to check if the user or other agents have posted anything.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Number of recent messages to fetch (default: 20, max: 100)',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+];

package/dist/tools/cloud-agents.js

@@ -63,5 +63,36 @@ Use this to check the state of cloud agents before/after cleanup.`,
             },
             required: ['project_id']
         }
+    },
+    {
+        name: 'update_agent_status',
+        description: `Report what you're currently doing. This updates the status message shown on the dashboard.
+
+Call this at key milestones during boot and work:
+- "Installing dependencies..."
+- "Running start_work_session..."
+- "Working on: <task title>"
+- "Running tests..."
+- "Committing changes..."
+
+Keep messages short (under 80 chars). The dashboard shows this in real-time.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status_message: {
+                    type: 'string',
+                    description: 'Short status message to display on dashboard (max 80 chars)'
+                },
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID (optional if session has project context)'
+                },
+                agent_name: {
+                    type: 'string',
+                    description: 'Agent name (used to find the spawned_agents record)'
+                }
+            },
+            required: ['status_message']
+        }
     }
 ];

package/dist/tools/index.js

@@ -30,6 +30,7 @@ import { gitIssueTools } from './git-issues.js';
 import { connectorTools } from './connectors.js';
 import { cloudAgentTools } from './cloud-agents.js';
 import { versionTools } from './version.js';
+import { chatTools } from './chat.js';
 /**
  * All MCP tool definitions combined
  */
@@ -59,6 +60,7 @@ export const tools = [
     ...connectorTools,
     ...cloudAgentTools,
     ...versionTools,
+    ...chatTools,
 ];
 /**
  * Build the complete tool list from all domain modules

package/docs/TOOLS.md

@@ -2,9 +2,9 @@
 
 > Auto-generated from tool definitions. Do not edit manually.
 >
-> Generated: 2026-02-12
+> Generated: 2026-02-13
 >
-> Total tools: 156
+> Total tools: 158
 
 ## Table of Contents
 
@@ -34,6 +34,8 @@
 - [file_locks](#file-locks) - File checkout/locking for multi-agent (6 tools)
 - [connectors](#connectors) - External integration connectors (7 tools)
 - [cloud_agents](#cloud-agents) - Cloud agent management and cleanup (2 tools)
+- [chat](#chat) - Project-wide chat channel for agent and user communication (2 tools)
+- [version](#version) - MCP server version management and updates (2 tools)
 
 ## session
 
@@ -207,7 +209,7 @@ Create a new project to track in Vibescope.
 |-----------|------|----------|-------------|
 | `name` | `string` | Yes | Project display name |
 | `description` | `string` | No | Brief project description |
-| `goal` | `string` | No | What does "done" look like for this project? |
+| `goal` | `string` | No | High-level project goal or purpose (e.g. "A multiplayer card game platform") |
 | `git_url` | `string` | No | Git repository URL (if available) |
 | `tech_stack` | `string[]` | No | Technologies used (e.g., ["TypeScript", "React", "PostgreSQL"]) |
 
@@ -2458,9 +2460,39 @@ Use this to check the state of cloud agents before/after cleanup.
 
 ---
 
-## Uncategorized
+## chat
 
-*Tools not yet assigned to a category*
+*Project-wide chat channel for agent and user communication*
+
+### send_project_message
+
+Send a message to the project chat channel. All agents and the project owner can see messages here. Use this to communicate status updates, ask questions, report blockers, or coordinate with other agents.
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | `string` | Yes | Project UUID |
+| `message` | `string` | Yes | Message content (supports markdown) |
+
+---
+
+### get_project_messages
+
+Read recent messages from the project chat channel. Use this to check if the user or other agents have posted anything.
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | `string` | Yes | Project UUID |
+| `limit` | `number` | No | Number of recent messages to fetch (default: 20, max: 100) |
+
+---
+
+## version
+
+*MCP server version management and updates*
 
 ### check_mcp_version
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibescope/mcp-server",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "MCP server for Vibescope - AI project tracking tools",
   "type": "module",
   "main": "dist/index.js",

package/src/handlers/cloud-agents.ts

@@ -129,10 +129,38 @@ export const listCloudAgents: Handler = async (args, ctx) => {
 	});
 };
 
+/**
+ * Update agent status message (for dashboard display).
+ */
+export const updateAgentStatus: Handler = async (args, ctx) => {
+	const statusMessage = args.status_message as string;
+	const projectId = (args.project_id || ctx.session.currentProjectId) as string;
+	const agentName = args.agent_name as string | undefined;
+
+	if (!statusMessage) {
+		return error('status_message is required');
+	}
+
+	const apiClient = getApiClient();
+	
+	const response = await apiClient.proxy<{ success: boolean }>('update_agent_status', {
+		project_id: projectId,
+		agent_name: agentName,
+		status_message: statusMessage,
+	});
+
+	if (!response.ok) {
+		return error(response.error || 'Failed to update status');
+	}
+
+	return success({ updated: true, status_message: statusMessage });
+};
+
 /**
  * Cloud agents handlers registry
  */
 export const cloudAgentHandlers: HandlerRegistry = {
 	cleanup_stale_cloud_agents: cleanupStaleCloudAgents,
 	list_cloud_agents: listCloudAgents,
+	update_agent_status: updateAgentStatus,
 };

package/src/handlers/discovery.ts

@@ -331,6 +331,20 @@ export const TOOL_CATEGORIES: Record<string, { description: string; tools: Array
 			{ name: 'list_cloud_agents', brief: 'List cloud agents for project' },
 		],
 	},
+	chat: {
+		description: 'Project-wide chat channel for agent and user communication',
+		tools: [
+			{ name: 'send_project_message', brief: 'Send a message to the project chat' },
+			{ name: 'get_project_messages', brief: 'Read recent project chat messages' },
+		],
+	},
+	version: {
+		description: 'MCP server version management and updates',
+		tools: [
+			{ name: 'check_mcp_version', brief: 'Check for MCP server updates' },
+			{ name: 'update_mcp_server', brief: 'Self-update the MCP server' },
+		],
+	},
 };
 
 export const discoverTools: Handler = async (args) => {

package/src/tools/chat.ts

@@ -0,0 +1,46 @@
+/**
+ * Project chat tools:
+ * - send_project_message
+ * - get_project_messages
+ */
+
+import type { Tool } from './types.js';
+
+export const chatTools: Tool[] = [
+	{
+		name: 'send_project_message',
+		description: 'Send a message to the project chat channel. All agents and the project owner can see messages here. Use this to communicate status updates, ask questions, report blockers, or coordinate with other agents.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				message: {
+					type: 'string',
+					description: 'Message content (supports markdown)',
+				},
+			},
+			required: ['project_id', 'message'],
+		},
+	},
+	{
+		name: 'get_project_messages',
+		description: 'Read recent messages from the project chat channel. Use this to check if the user or other agents have posted anything.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				limit: {
+					type: 'number',
+					description: 'Number of recent messages to fetch (default: 20, max: 100)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+];

package/src/tools/cloud-agents.ts

@@ -66,5 +66,36 @@ Use this to check the state of cloud agents before/after cleanup.`,
 			},
 			required: ['project_id']
 		}
+	},
+	{
+		name: 'update_agent_status',
+		description: `Report what you're currently doing. This updates the status message shown on the dashboard.
+
+Call this at key milestones during boot and work:
+- "Installing dependencies..."
+- "Running start_work_session..."
+- "Working on: <task title>"
+- "Running tests..."
+- "Committing changes..."
+
+Keep messages short (under 80 chars). The dashboard shows this in real-time.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				status_message: {
+					type: 'string',
+					description: 'Short status message to display on dashboard (max 80 chars)'
+				},
+				project_id: {
+					type: 'string',
+					description: 'Project UUID (optional if session has project context)'
+				},
+				agent_name: {
+					type: 'string',
+					description: 'Agent name (used to find the spawned_agents record)'
+				}
+			},
+			required: ['status_message']
+		}
 	}
 ];

package/src/tools/index.ts

@@ -34,6 +34,7 @@ import { gitIssueTools } from './git-issues.js';
 import { connectorTools } from './connectors.js';
 import { cloudAgentTools } from './cloud-agents.js';
 import { versionTools } from './version.js';
+import { chatTools } from './chat.js';
 
 /**
  * All MCP tool definitions combined
@@ -64,6 +65,7 @@ export const tools: Tool[] = [
 	...connectorTools,
 	...cloudAgentTools,
 	...versionTools,
+	...chatTools,
 ];
 
 /**