@alacrity-ai/kbrelaymcp 0.1.0 → 0.2.0

package/README.md

@@ -4,7 +4,8 @@ An [MCP](https://modelcontextprotocol.io) server that gives an agent **kbRelay**
 powers — projects, cards, the timeline, and your @-mentions — over kbRelay's HTTP
 API. It's a thin, standalone stdio client: it carries no privileges of its own, so
 the API token's tenant and **project access (RBAC)** govern exactly what it can see
-and do.
+and do. Point it at a token minted for an **agent user** and everything the agent
+does is attributed to that agent (correct provenance).
 
 ## Install (Claude Code / Claude Desktop)
 
@@ -40,7 +41,7 @@ claude mcp add kbrelay --scope user \
 | Env var | Required | Purpose |
 |---|---|---|
 | `KBRELAY_BASE_URL` | yes | kbRelay origin, e.g. `https://kbrelay.lalalimited.com` or `http://localhost:8080`. |
-| `KBRELAY_API_KEY` | yes | A bearer token minted in the web **API keys** panel. Sent as `Authorization: Bearer …`. |
+| `KBRELAY_API_KEY` | yes | A bearer token. For correct provenance, use a key minted for an **agent user** (web → *Team & access → Agents*) so the agent's work is attributed to it, not to you. A personal key from the **API keys** panel also works. Sent as `Authorization: Bearer …`. |
 
 ## Tools
 
@@ -51,6 +52,7 @@ claude mcp add kbrelay --scope user \
 | `list_projects` | read | Projects you can access (admins: all). |
 | `get_project` | read | A project + its columns (resolve column ids by name). |
 | `create_project` | write | New project (`code` required, seeds columns). |
+| `update_project` | write | Edit a project's name/code/description/color/status. |
 | `list_cards` | read | Cards in a project (filter by column/assignee/q). |
 | `get_card` | read | One card (read the spec before working it). |
 | `create_card` | write | New card (markdown body; `@handle` to notify). |

package/dist/tools/index.js

@@ -29,19 +29,19 @@ export const allTools = [
     // ── Projects ──
     defineTool({
         name: 'list_projects',
-        description: 'List projects you can access (admins: all). Each has a code (e.g. OBL) that prefixes its ticket keys.',
+        description: 'List projects you can access (admins: all). Each has a code (e.g. OBL) that prefixes ticket keys, plus a description (the project\'s purpose/context) and color.',
         inputSchema: z.object({ status: z.enum(['active', 'archived']).optional() }),
         handler: (a, c) => c.request('GET', `/v1/projects${qs({ status: a.status })}`),
     }),
     defineTool({
         name: 'get_project',
-        description: 'Get one project and its columns. Column ids are per-project — always resolve them by name here, never hardcode.',
+        description: 'Get one project (name, code, description, color, status) and its columns. Read `description` to learn what the project is for. Column ids are per-project — resolve by name here, never hardcode.',
         inputSchema: z.object({ projectId: z.string() }),
         handler: (a, c) => c.request('GET', `/v1/projects/${enc(a.projectId)}`),
     }),
     defineTool({
         name: 'create_project',
-        description: 'Create a project. `code` (2–6 alnum, e.g. LSEO) is required and prefixes ticket keys; default columns are seeded.',
+        description: 'Create a project. `code` (2–6 alnum, e.g. LSEO) is required and prefixes ticket keys; default columns are seeded. `description` gives future readers (human or agent) the project\'s purpose.',
         inputSchema: z.object({
             name: z.string(),
             code: z.string(),
@@ -50,6 +50,22 @@ export const allTools = [
         }),
         handler: (a, c) => c.request('POST', '/v1/projects', a),
     }),
+    defineTool({
+        name: 'update_project',
+        description: 'Edit a project: name, code, description (its purpose/context), color (#rrggbb or null to reset), or status (active/archived). Only pass the fields you want to change.',
+        inputSchema: z.object({
+            projectId: z.string(),
+            name: z.string().optional(),
+            code: z.string().optional(),
+            description: z.string().nullish(),
+            color: z.string().nullish(),
+            status: z.enum(['active', 'archived']).optional(),
+        }),
+        handler: (a, c) => {
+            const { projectId, ...body } = a;
+            return c.request('PATCH', `/v1/projects/${enc(projectId)}`, body);
+        },
+    }),
     // ── Cards ──
     defineTool({
         name: 'list_cards',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alacrity-ai/kbrelaymcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for kbRelay — give an agent kanban powers (projects, cards, timeline, mentions) over the kbRelay API.",
   "type": "module",
   "license": "MIT",