@live-context/mcp 0.9.0 → 0.10.1

package/dist/index.js

@@ -91,7 +91,7 @@ async function callMcpApi(tool, args, method = 'POST') {
 // ---------------------------------------------------------------------------
 const server = new McpServer({
     name: 'live-context-mcp',
-    version: '0.9.0', // 0.9.0 adds Projects MLP ticket tools (list_my_tasks, get_ticket, create_ticket, update_ticket_status, comment_on_ticket, list_my_reviews, claim_review, assign_ticket, link_ticket)
+    version: '0.10.1', // 0.10.1 adds assign_ticket clear_executor/clear_reviewer + read-modify-write merge. 0.10.0 adds Projects MLP v2 tools: reads (list_projects/workstreams/tickets/milestones/agents, search_*, get_*), ticket management (update_ticket, set_ticket_milestone, dependencies, move/unlink/reorder, update_ticket_comment), scaffold (create/update workstream, create/complete milestone, create/update agent, create_project)
 });
 server.registerTool('get_context', {
     description: 'Retrieve relevant context entries. Returns L0 summaries (title, type, snippet) by default. Pass drawer_id to get full page body.',
@@ -383,7 +383,7 @@ server.registerTool('claim_review', {
     },
 }, (args) => callMcpApi('claim-review', args));
 server.registerTool('assign_ticket', {
-    description: 'Set or change a ticket\'s executor and/or reviewer. Each side is an actor (kind + id) — kind is "member" (a user id) or "agent" (an agent id). Pass only the side(s) you want to change. The executor and reviewer must differ; assigning the same actor to both is rejected with executor_equals_reviewer.',
+    description: 'Set or change a ticket\'s executor and/or reviewer. Each side is an actor (kind + id) — kind is "member" (a user id) or "agent" (an agent id). Pass only the side(s) you want to change; the other side is preserved. To unassign a side, set clear_executor / clear_reviewer. The executor and reviewer must differ; assigning the same actor to both is rejected with executor_equals_reviewer.',
     inputSchema: {
         ticket_id: z.string().describe('Ticket to (re)assign.'),
         executor_kind: z
@@ -396,6 +396,14 @@ server.registerTool('assign_ticket', {
             .optional()
             .describe('Reviewer actor kind. Provide together with reviewer_id.'),
         reviewer_id: z.string().optional().describe('Reviewer actor id (user id or agent id).'),
+        clear_executor: z
+            .boolean()
+            .optional()
+            .describe('Unassign the executor. Do not combine with executor_kind/_id.'),
+        clear_reviewer: z
+            .boolean()
+            .optional()
+            .describe('Unassign the reviewer. Do not combine with reviewer_kind/_id.'),
     },
 }, (args) => callMcpApi('assign-ticket', args));
 server.registerTool('link_ticket', {
@@ -410,6 +418,210 @@ server.registerTool('link_ticket', {
             .describe("Relationship label. Defaults to 'relates_to'."),
     },
 }, (args) => callMcpApi('link-ticket', args));
+// ===================================================================
+// Projects MLP v2 — reads + management + scaffold (0.10.0)
+// ===================================================================
+server.registerTool('list_projects', {
+    description: "List all projects in your org (notebooks with kind=project). Returns id, name, goal, due_at, status. Use to discover the project to work in.",
+    inputSchema: {},
+}, (args) => callMcpApi('list-projects', args));
+server.registerTool('list_workstreams', {
+    description: "List the workstreams in a project. Returns each workstream id, name, status, owner, and ticket rollups. Use to get a workstream_id before creating or listing tickets.",
+    inputSchema: {
+        project_id: z.string().describe('Project id (notebook with kind=project).'),
+    },
+}, (args) => callMcpApi('list-workstreams', args));
+server.registerTool('list_workstream_tickets', {
+    description: "List all tickets in a workstream (the board). Returns id, key, title, status, priority, assignment, milestone, sort_order.",
+    inputSchema: {
+        workstream_id: z.string().describe('Workstream id.'),
+    },
+}, (args) => callMcpApi('list-workstream-tickets', args));
+server.registerTool('get_workstream', {
+    description: "Fetch a single workstream by id with its detail and ticket rollups.",
+    inputSchema: {
+        workstream_id: z.string().describe('Workstream id.'),
+    },
+}, (args) => callMcpApi('get-workstream', args));
+server.registerTool('list_milestones', {
+    description: "List the milestones for a project (pass the project id). Returns id, title, due_at, completed_at, and ticket rollups.",
+    inputSchema: {
+        project_id: z.string().describe('Project id (the milestones live on the project notebook).'),
+    },
+}, (args) => callMcpApi('list-milestones', args));
+server.registerTool('get_milestone', {
+    description: "Fetch a single milestone by id, including its ticket rollups.",
+    inputSchema: {
+        milestone_id: z.string().describe('Milestone id.'),
+    },
+}, (args) => callMcpApi('get-milestone', args));
+server.registerTool('list_ticket_comments', {
+    description: "List the full comment thread for a ticket, with author attribution (member or agent).",
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket id.'),
+    },
+}, (args) => callMcpApi('list-ticket-comments', args));
+server.registerTool('list_ticket_dependencies', {
+    description: "List a ticket dependencies: which tickets block it and which it blocks, with blocked-open state.",
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket id.'),
+    },
+}, (args) => callMcpApi('list-ticket-dependencies', args));
+server.registerTool('list_ticket_events', {
+    description: "List the activity timeline for a ticket (status changes, assignments, links, and more).",
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket id.'),
+    },
+}, (args) => callMcpApi('list-ticket-events', args));
+server.registerTool('list_team_agents', {
+    description: "List the agents registered for your team. Returns id, name, role, is_active. Use to find an agent id to assign as executor or reviewer.",
+    inputSchema: {},
+}, (args) => callMcpApi('list-team-agents', args));
+server.registerTool('search_tickets', {
+    description: "Search tickets across the org by text and filters (status, priority, project, executor, milestone). Returns matching tickets.",
+    inputSchema: {
+        query: z.string().optional().describe('Free-text search over title and body.'),
+        status: z.enum(['backlog', 'ready', 'in_progress', 'in_review', 'done']).optional().describe('Filter by status.'),
+        priority: z.string().optional().describe('Filter by priority.'),
+        project_id: z.string().optional().describe('Restrict to one project.'),
+        executor_kind: z.enum(['member', 'agent']).optional().describe('Filter by executor actor kind.'),
+        executor_id: z.string().optional().describe('Filter by executor actor id.'),
+        milestone_id: z.string().optional().describe('Filter by milestone.'),
+        limit: z.number().int().positive().max(200).optional().describe('Max results (default 100).'),
+    },
+}, (args) => callMcpApi('search-tickets', args));
+server.registerTool('search_linkable', {
+    description: "Search for drawers, pages, and tickets you can link to a ticket. Returns id, kind, title for use with link_ticket.",
+    inputSchema: {
+        query: z.string().optional().describe('Free-text search.'),
+        limit: z.number().int().positive().max(50).optional().describe('Max results (default 20).'),
+    },
+}, (args) => callMcpApi('search-linkable', args));
+server.registerTool('update_ticket', {
+    description: "Update ticket fields: title, body, priority, due_at. Pass clear_due=true to remove the due date. Member-only.",
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket to update.'),
+        title: z.string().optional().describe('New title.'),
+        body: z.string().optional().describe('New body / acceptance criteria.'),
+        priority: z.string().optional().describe('New priority.'),
+        due_at: z.string().optional().describe('ISO 8601 due date.'),
+        clear_due: z.boolean().optional().describe('Set true to clear the due date.'),
+    },
+}, (args) => callMcpApi('update-ticket', args));
+server.registerTool('set_ticket_milestone', {
+    description: "Set or clear a ticket milestone. Pass milestone_id to set it; omit milestone_id to clear it. The milestone must belong to the same project. Member-only.",
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket id.'),
+        milestone_id: z.string().optional().describe('Milestone id to set. Omit to clear the milestone.'),
+    },
+}, (args) => callMcpApi('set-ticket-milestone', args));
+server.registerTool('add_ticket_dependency', {
+    description: "Add a dependency: blocked_id is blocked by blocker_id. Both tickets must be in the same project. Rejects self-dependency and cycles. Member-only.",
+    inputSchema: {
+        blocked_id: z.string().describe('The ticket that is blocked.'),
+        blocker_id: z.string().describe('The ticket that blocks it.'),
+    },
+}, (args) => callMcpApi('add-ticket-dependency', args));
+server.registerTool('remove_ticket_dependency', {
+    description: "Remove a ticket dependency by its dependency id (from list_ticket_dependencies). Member-only.",
+    inputSchema: {
+        dependency_id: z.string().describe('Dependency id to remove.'),
+    },
+}, (args) => callMcpApi('remove-ticket-dependency', args));
+server.registerTool('move_ticket_to_workstream', {
+    description: "Move a ticket to a different workstream in the same project. Member-only.",
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket to move.'),
+        workstream_id: z.string().describe('Destination workstream id.'),
+    },
+}, (args) => callMcpApi('move-ticket-to-workstream', args));
+server.registerTool('unlink_ticket', {
+    description: "Remove a link from a ticket. kind is drawer or page; id is the linked drawer or page id. Member-only.",
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket to unlink from.'),
+        kind: z.enum(['drawer', 'page']).describe('Linked target kind.'),
+        id: z.string().describe('Linked drawer or page id.'),
+    },
+}, (args) => callMcpApi('unlink-ticket', args));
+server.registerTool('reorder_tickets', {
+    description: "Reorder tickets within a workstream. ordered_ids is the full list of ticket ids in the new order. Member-only.",
+    inputSchema: {
+        workstream_id: z.string().describe('Workstream id.'),
+        ordered_ids: z.array(z.string()).describe('All ticket ids in the new order.'),
+    },
+}, (args) => callMcpApi('reorder-tickets', args));
+server.registerTool('create_workstream', {
+    description: "Create a workstream in a project. Optionally set an owner member. Returns the new workstream id. Member-only.",
+    inputSchema: {
+        project_id: z.string().describe('Project id (notebook with kind=project).'),
+        name: z.string().describe('Workstream name.'),
+        owner_user_id: z.string().optional().describe('Optional owner member user id.'),
+    },
+}, (args) => callMcpApi('create-workstream', args));
+server.registerTool('update_workstream', {
+    description: "Update a workstream name, status, description, or owner. Pass clear_owner=true to unset the owner. Member-only.",
+    inputSchema: {
+        workstream_id: z.string().describe('Workstream to update.'),
+        name: z.string().optional().describe('New name.'),
+        status: z.string().optional().describe('New status.'),
+        owner_user_id: z.string().optional().describe('New owner member user id.'),
+        description: z.string().optional().describe('New description.'),
+        clear_owner: z.boolean().optional().describe('Set true to unset the owner.'),
+    },
+}, (args) => callMcpApi('update-workstream', args));
+server.registerTool('reorder_workstreams', {
+    description: "Reorder workstreams within a project. ordered_ids is the full list of workstream ids in the new order. Member-only.",
+    inputSchema: {
+        project_id: z.string().describe('Project id.'),
+        ordered_ids: z.array(z.string()).describe('All workstream ids in the new order.'),
+    },
+}, (args) => callMcpApi('reorder-workstreams', args));
+server.registerTool('create_milestone', {
+    description: "Create a milestone in a project (pass the project id and a title, optional due_at). Returns the new milestone id. Member-only.",
+    inputSchema: {
+        project_id: z.string().describe('Project id the milestone belongs to.'),
+        title: z.string().describe('Milestone title.'),
+        due_at: z.string().optional().describe('ISO 8601 due date (optional).'),
+    },
+}, (args) => callMcpApi('create-milestone', args));
+server.registerTool('complete_milestone', {
+    description: "Mark a milestone complete or incomplete. completed defaults to true. Member-only.",
+    inputSchema: {
+        milestone_id: z.string().describe('Milestone id.'),
+        completed: z.boolean().optional().describe('True to complete (default), false to reopen.'),
+    },
+}, (args) => callMcpApi('complete-milestone', args));
+server.registerTool('create_agent', {
+    description: "Register an agent actor for your team (name, optional role). Returns the new agent id. To let the agent act, mint an agent-bound token in the dashboard. Member-only.",
+    inputSchema: {
+        name: z.string().describe('Agent display name.'),
+        role: z.string().optional().describe('Optional role label.'),
+    },
+}, (args) => callMcpApi('create-agent', args));
+server.registerTool('update_agent', {
+    description: "Update an agent name, role, or is_active flag. Setting is_active=false deactivates the agent (kill-switch). Member-only.",
+    inputSchema: {
+        agent_id: z.string().describe('Agent to update.'),
+        name: z.string().optional().describe('New name.'),
+        role: z.string().optional().describe('New role.'),
+        is_active: z.boolean().optional().describe('Set false to deactivate (kill-switch), true to reactivate.'),
+    },
+}, (args) => callMcpApi('update-agent', args));
+server.registerTool('create_project', {
+    description: "Create a new project (a notebook with kind=project) in your org, with a name and optional goal and due_at. Returns the new project id. Member-only.",
+    inputSchema: {
+        name: z.string().describe('Project name.'),
+        goal: z.string().optional().describe('Project objective or outcome.'),
+        due_at: z.string().optional().describe('ISO 8601 due date (optional).'),
+    },
+}, (args) => callMcpApi('create-project', args));
+server.registerTool('update_ticket_comment', {
+    description: "Edit one of your own ticket comments. Only the original author (you, member or agent) may edit it.",
+    inputSchema: {
+        comment_id: z.string().describe('Comment id to edit.'),
+        body: z.string().describe('New comment text.'),
+    },
+}, (args) => callMcpApi('update-ticket-comment', args));
 server.registerTool('health_check', {
     description: 'Returns server health status and resolved team identity',
 }, () => callMcpApi('health-check', undefined, 'GET'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@live-context/mcp",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "private": false,
   "description": "Live Context MCP — stdio proxy to live-context.com hosted API. Customer-side has no Supabase dependency.",
   "type": "module",