@live-context/mcp 0.7.1 → 0.9.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.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)
 });
 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,105 @@ 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));
 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.9.0",
   "private": false,
   "description": "Live Context MCP — stdio proxy to live-context.com hosted API. Customer-side has no Supabase dependency.",
   "type": "module",