@live-context/mcp 0.7.1 → 0.10.0

package/README.md

@@ -30,6 +30,38 @@ For Claude Desktop, Cursor, or any other MCP client, add this to your `mcpServer
 }
 ```
 
+## Remote (HTTP) transport
+
+Live Context also exposes a [Streamable HTTP MCP transport](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http) at `https://live-context.com/api/mcp/mcp`. Use this when you'd rather not install Node — Claude Code, Cursor, Codex CLI, and ChatGPT Developer Mode all support paste-in URLs with custom headers.
+
+**Claude Code remote:**
+
+```bash
+claude mcp add --transport http live-context https://live-context.com/api/mcp/mcp \
+  --header "Authorization: Bearer <your-team-key>" \
+  --header "X-LC-User-Token: <your-user-token>"
+```
+
+**Cursor / Claude Desktop / any "URL + headers" client:**
+
+```json
+{
+  "mcpServers": {
+    "live-context": {
+      "url": "https://live-context.com/api/mcp/mcp",
+      "headers": {
+        "Authorization": "Bearer <your-team-key>",
+        "X-LC-User-Token": "<your-user-token>"
+      }
+    }
+  }
+}
+```
+
+The HTTP endpoint is authenticated with the same team key + (optional) user token as the stdio proxy. Both transports talk to the same backend and expose the same tools.
+
+A dashboard-driven one-click install flow (OAuth-based — no token pasting) is on the way; until then, the snippets above are the canonical Remote setup.
+
 ## Environment variables
 
 | Variable | Required | Purpose |

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.7.1', // 0.7.0 added body_tiptap; 0.7.1 adds width_mode (fixed | wide)
+    version: '0.10.0', // 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.',
@@ -311,6 +311,309 @@ server.registerTool('get_page', {
         page_id: z.string().describe('Page id (from list_pages or write_page result).'),
     },
 }, (args) => callMcpApi('get-page', args));
+server.registerTool('ask', {
+    description: 'Ask the live-context brain a question. Returns hybrid-search retrieval (drawers + pages) with ratification metadata and — for contested cases — raw evidence (recency delta, citation counts, author agent, evidence-for counts). The server does NOT synthesize a prose answer; the calling agent reasons over the structured result. Requires X-LC-User-Token.',
+    inputSchema: {
+        question: z.string().min(1).describe('The question to ask the team brain.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe('Max candidates returned (default 8, max 50)'),
+    },
+}, (args) => callMcpApi('ask', args));
+// ---------------------------------------------------------------------------
+// Projects MLP — ticket tools (mig 056/057/058). All require a user token
+// (LC_USER_TOKEN). Actor resolution (agent vs member) happens server-side from
+// the token's agent binding; the proxy just forwards args.
+// ---------------------------------------------------------------------------
+server.registerTool('list_my_tasks', {
+    description: 'List the tickets assigned to you as the executor (the actor to do the work). The actor is the agent when called with an agent-bound token, otherwise the human member. Optionally filter by status. Use get_ticket for the full body, links, and comments.',
+    inputSchema: {
+        status: z
+            .enum(['backlog', 'ready', 'in_progress', 'in_review', 'done'])
+            .optional()
+            .describe('Filter to tickets in this status. Omit to return all of your tasks.'),
+    },
+}, (args) => callMcpApi('list-my-tasks', args));
+server.registerTool('get_ticket', {
+    description: 'Fetch a single ticket by id. Returns title, body, status, workstream + project, executor/reviewer assignment, links to drawers/pages, timestamps, and the full comment thread. Call this before updating status or commenting so you act on current state.',
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket id (from list_my_tasks, list_my_reviews, or create_ticket).'),
+    },
+}, (args) => callMcpApi('get-ticket', args));
+server.registerTool('create_ticket', {
+    description: 'Create a new ticket inside a workstream. Returns the new ticket id. Defaults to backlog status. Use list_context / project tooling to find the target workstream_id first.',
+    inputSchema: {
+        workstream_id: z.string().describe('Workstream the ticket belongs to.'),
+        title: z.string().describe('Short, action-oriented ticket title.'),
+        body: z.string().optional().describe('Optional detailed description / acceptance criteria.'),
+        status: z
+            .enum(['backlog', 'ready', 'in_progress', 'in_review', 'done'])
+            .optional()
+            .describe("Initial status. Defaults to 'backlog'."),
+    },
+}, (args) => callMcpApi('create-ticket', args));
+server.registerTool('update_ticket_status', {
+    description: "Move a ticket to a new status. If you request 'done' on a ticket that has a reviewer, the server rewrites it to 'in_review' and submits it for review instead of closing it — the result includes rewritten=true and a message explaining this. Always inspect the returned status vs requested_status.",
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket to transition.'),
+        status: z
+            .enum(['backlog', 'ready', 'in_progress', 'in_review', 'done'])
+            .describe('Desired status. May be rewritten to in_review when a reviewer is assigned.'),
+    },
+}, (args) => callMcpApi('update-ticket-status', args));
+server.registerTool('comment_on_ticket', {
+    description: 'Add a comment to a ticket. The comment is attributed to you (agent or member). Returns the new comment id. Use this to record progress, hand-off notes, or review feedback.',
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket to comment on.'),
+        body: z.string().describe('Comment text.'),
+    },
+}, (args) => callMcpApi('comment-on-ticket', args));
+server.registerTool('list_my_reviews', {
+    description: 'List tickets awaiting your review (where you are the assigned reviewer, or which are open for review claiming). The actor is the agent or human member. Use claim_review to take an unclaimed review and get_ticket for details.',
+    inputSchema: {},
+}, (args) => callMcpApi('list-my-reviews', args));
+server.registerTool('claim_review', {
+    description: 'Claim the reviewer slot on a ticket that is open for review, assigning yourself (agent or member) as its reviewer. Returns the updated ticket. Use list_my_reviews to find claimable tickets.',
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket to claim review on.'),
+    },
+}, (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.',
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket to (re)assign.'),
+        executor_kind: z
+            .enum(['member', 'agent'])
+            .optional()
+            .describe('Executor actor kind. Provide together with executor_id.'),
+        executor_id: z.string().optional().describe('Executor actor id (user id or agent id).'),
+        reviewer_kind: z
+            .enum(['member', 'agent'])
+            .optional()
+            .describe('Reviewer actor kind. Provide together with reviewer_id.'),
+        reviewer_id: z.string().optional().describe('Reviewer actor id (user id or agent id).'),
+    },
+}, (args) => callMcpApi('assign-ticket', args));
+server.registerTool('link_ticket', {
+    description: "Link a ticket to a drawer or a page as supporting context. Provide exactly one of drawer_id or page_id. relation_kind labels the relationship and defaults to 'relates_to'.",
+    inputSchema: {
+        ticket_id: z.string().describe('Ticket to link from.'),
+        drawer_id: z.string().optional().describe('Drawer (context entry) id to link to.'),
+        page_id: z.string().optional().describe('Page id to link to.'),
+        relation_kind: z
+            .string()
+            .optional()
+            .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.7.1",
+  "version": "0.10.0",
   "private": false,
   "description": "Live Context MCP — stdio proxy to live-context.com hosted API. Customer-side has no Supabase dependency.",
   "type": "module",