@tickernelz/paperclip-pro-mcp-server 2026.925.0

package/dist/tools.test.js

@@ -0,0 +1,340 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { PaperclipApiClient } from "./client.js";
+import { createToolDefinitions } from "./tools.js";
+function makeClient() {
+    return new PaperclipApiClient({
+        apiUrl: "http://localhost:3100/api",
+        apiKey: "token-123",
+        companyId: "11111111-1111-1111-1111-111111111111",
+        agentId: "22222222-2222-2222-2222-222222222222",
+        runId: "33333333-3333-3333-3333-333333333333",
+    });
+}
+function getTool(name) {
+    const tool = createToolDefinitions(makeClient()).find((candidate) => candidate.name === name);
+    if (!tool)
+        throw new Error(`Missing tool ${name}`);
+    return tool;
+}
+function mockJsonResponse(body, status = 200) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { "Content-Type": "application/json" },
+    });
+}
+describe("paperclip MCP tools", () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("adds auth headers and run id to mutating requests", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ ok: true }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipUpdateIssue");
+        await tool.execute({
+            issueId: "PAP-1135",
+            status: "done",
+        });
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(String(url)).toBe("http://localhost:3100/api/issues/PAP-1135");
+        expect(init.method).toBe("PATCH");
+        expect(init.headers["Authorization"]).toBe("Bearer token-123");
+        expect(init.headers["X-Paperclip-Run-Id"]).toBe("33333333-3333-3333-3333-333333333333");
+    });
+    it("lists the company skill library with the default company id", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse([{ key: "paperclipai/bundled/product/wireframe", name: "wireframe" }]));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipListSkills");
+        const response = await tool.execute({});
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const [url] = fetchMock.mock.calls[0];
+        expect(String(url)).toBe("http://localhost:3100/api/companies/11111111-1111-1111-1111-111111111111/skills");
+        expect(response.content[0]?.text).toContain("wireframe");
+    });
+    it("uses default company id for company-scoped list tools", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse([{ id: "issue-1" }]));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipListIssues");
+        const response = await tool.execute({});
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const [url] = fetchMock.mock.calls[0];
+        expect(String(url)).toBe("http://localhost:3100/api/companies/11111111-1111-1111-1111-111111111111/issues");
+        expect(response.content[0]?.text).toContain("issue-1");
+    });
+    it("uses default agent id for checkout requests", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ id: "PAP-1135", status: "in_progress" }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipCheckoutIssue");
+        await tool.execute({
+            issueId: "PAP-1135",
+        });
+        const [, init] = fetchMock.mock.calls[0];
+        expect(JSON.parse(String(init.body))).toEqual({
+            agentId: "22222222-2222-2222-2222-222222222222",
+            expectedStatuses: ["todo", "backlog", "blocked"],
+        });
+    });
+    it("allows create issue requests to omit status so the API applies assignee defaults", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ id: "issue-1", status: "todo" }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipCreateIssue");
+        await tool.execute({
+            title: "Assigned follow-up",
+            assigneeAgentId: "22222222-2222-2222-2222-222222222222",
+        });
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(String(url)).toBe("http://localhost:3100/api/companies/11111111-1111-1111-1111-111111111111/issues");
+        expect(init.method).toBe("POST");
+        expect(JSON.parse(String(init.body))).toEqual({
+            title: "Assigned follow-up",
+            workMode: "standard",
+            priority: "medium",
+            assigneeAgentId: "22222222-2222-2222-2222-222222222222",
+            requestDepth: 0,
+        });
+    });
+    it("defaults issue document format to markdown", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ key: "plan", latestRevisionNumber: 2 }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipUpsertIssueDocument");
+        await tool.execute({
+            issueId: "PAP-1135",
+            key: "plan",
+            body: "# Updated",
+        });
+        const [, init] = fetchMock.mock.calls[0];
+        expect(JSON.parse(String(init.body))).toEqual({
+            format: "markdown",
+            body: "# Updated",
+        });
+    });
+    it("controls issue workspace services through the current execution workspace", async () => {
+        const fetchMock = vi.fn()
+            .mockResolvedValueOnce(mockJsonResponse({
+            currentExecutionWorkspace: {
+                id: "44444444-4444-4444-8444-444444444444",
+                runtimeServices: [],
+            },
+        }))
+            .mockResolvedValueOnce(mockJsonResponse({
+            operation: { id: "operation-1" },
+            workspace: {
+                id: "44444444-4444-4444-8444-444444444444",
+                runtimeServices: [
+                    {
+                        id: "55555555-5555-4555-8555-555555555555",
+                        serviceName: "web",
+                        status: "running",
+                        url: "http://127.0.0.1:5173",
+                    },
+                ],
+            },
+        }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipControlIssueWorkspaceServices");
+        await tool.execute({
+            issueId: "PAP-1135",
+            action: "restart",
+            workspaceCommandId: "web",
+        });
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+        const [lookupUrl, lookupInit] = fetchMock.mock.calls[0];
+        expect(String(lookupUrl)).toBe("http://localhost:3100/api/issues/PAP-1135/heartbeat-context");
+        expect(lookupInit.method).toBe("GET");
+        const [controlUrl, controlInit] = fetchMock.mock.calls[1];
+        expect(String(controlUrl)).toBe("http://localhost:3100/api/execution-workspaces/44444444-4444-4444-8444-444444444444/runtime-services/restart");
+        expect(controlInit.method).toBe("POST");
+        expect(JSON.parse(String(controlInit.body))).toEqual({
+            workspaceCommandId: "web",
+        });
+    });
+    it("waits for an issue workspace runtime service URL", async () => {
+        const fetchMock = vi.fn()
+            .mockResolvedValueOnce(mockJsonResponse({
+            currentExecutionWorkspace: {
+                id: "44444444-4444-4444-8444-444444444444",
+                runtimeServices: [
+                    {
+                        id: "55555555-5555-4555-8555-555555555555",
+                        serviceName: "web",
+                        status: "running",
+                        healthStatus: "healthy",
+                        url: "http://127.0.0.1:5173",
+                    },
+                ],
+            },
+        }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipWaitForIssueWorkspaceService");
+        const response = await tool.execute({
+            issueId: "PAP-1135",
+            serviceName: "web",
+            timeoutSeconds: 1,
+        });
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        expect(response.content[0]?.text).toContain("http://127.0.0.1:5173");
+    });
+    it("creates suggest_tasks interactions with the expected issue-scoped payload", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ id: "interaction-1", kind: "suggest_tasks" }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipSuggestTasks");
+        await tool.execute({
+            issueId: "PAP-1135",
+            idempotencyKey: "run-1:suggest",
+            payload: {
+                version: 1,
+                tasks: [{ clientKey: "task-1", title: "One" }],
+            },
+        });
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(String(url)).toBe("http://localhost:3100/api/issues/PAP-1135/interactions");
+        expect(init.method).toBe("POST");
+        expect(JSON.parse(String(init.body))).toEqual({
+            kind: "suggest_tasks",
+            continuationPolicy: "wake_assignee",
+            idempotencyKey: "run-1:suggest",
+            payload: {
+                version: 1,
+                tasks: [{ clientKey: "task-1", title: "One" }],
+            },
+        });
+    });
+    it("creates request_confirmation interactions with plan target payloads", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ id: "interaction-1", kind: "request_confirmation" }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipRequestConfirmation");
+        await tool.execute({
+            issueId: "PAP-1135",
+            idempotencyKey: "confirmation:PAP-1135:plan:33333333-3333-4333-8333-333333333333",
+            title: "Plan approval",
+            payload: {
+                version: 1,
+                prompt: "Accept this plan?",
+                acceptLabel: "Accept plan",
+                allowDeclineReason: true,
+                rejectLabel: "Request changes",
+                rejectRequiresReason: true,
+                supersedeOnUserComment: true,
+                target: {
+                    type: "issue_document",
+                    key: "plan",
+                    revisionId: "33333333-3333-4333-8333-333333333333",
+                    revisionNumber: 3,
+                },
+            },
+        });
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(String(url)).toBe("http://localhost:3100/api/issues/PAP-1135/interactions");
+        expect(init.method).toBe("POST");
+        expect(JSON.parse(String(init.body))).toEqual({
+            kind: "request_confirmation",
+            continuationPolicy: "none",
+            idempotencyKey: "confirmation:PAP-1135:plan:33333333-3333-4333-8333-333333333333",
+            title: "Plan approval",
+            payload: {
+                version: 1,
+                prompt: "Accept this plan?",
+                acceptLabel: "Accept plan",
+                allowDeclineReason: true,
+                rejectLabel: "Request changes",
+                rejectRequiresReason: true,
+                supersedeOnUserComment: true,
+                target: {
+                    type: "issue_document",
+                    key: "plan",
+                    revisionId: "33333333-3333-4333-8333-333333333333",
+                    revisionNumber: 3,
+                },
+            },
+        });
+    });
+    it("creates request_checkbox_confirmation interactions with checkbox payloads", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ id: "interaction-1", kind: "request_checkbox_confirmation" }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipRequestCheckboxConfirmation");
+        await tool.execute({
+            issueId: "PAP-1135",
+            idempotencyKey: "confirmation:PAP-1135:files",
+            title: "Choose files",
+            payload: {
+                version: 1,
+                prompt: "Which files should be included?",
+                detailsMarkdown: "Pick the files to attach.",
+                options: [
+                    { id: "file-a", label: "File A", description: "Primary draft" },
+                    { id: "file-b", label: "File B" },
+                ],
+                defaultSelectedOptionIds: ["file-a"],
+                minSelected: 1,
+                maxSelected: 2,
+                acceptLabel: "Use selected files",
+                rejectLabel: "Do not attach files",
+                rejectRequiresReason: true,
+                allowDeclineReason: false,
+            },
+        });
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(String(url)).toBe("http://localhost:3100/api/issues/PAP-1135/interactions");
+        expect(init.method).toBe("POST");
+        expect(JSON.parse(String(init.body))).toEqual({
+            kind: "request_checkbox_confirmation",
+            continuationPolicy: "wake_assignee",
+            idempotencyKey: "confirmation:PAP-1135:files",
+            title: "Choose files",
+            payload: {
+                version: 1,
+                prompt: "Which files should be included?",
+                detailsMarkdown: "Pick the files to attach.",
+                options: [
+                    { id: "file-a", label: "File A", description: "Primary draft" },
+                    { id: "file-b", label: "File B" },
+                ],
+                defaultSelectedOptionIds: ["file-a"],
+                minSelected: 1,
+                maxSelected: 2,
+                acceptLabel: "Use selected files",
+                rejectLabel: "Do not attach files",
+                rejectRequiresReason: true,
+                allowDeclineReason: false,
+            },
+        });
+    });
+    it("creates approvals with the expected company-scoped payload", async () => {
+        const fetchMock = vi.fn().mockResolvedValue(mockJsonResponse({ id: "approval-1" }));
+        vi.stubGlobal("fetch", fetchMock);
+        const tool = getTool("paperclipCreateApproval");
+        await tool.execute({
+            type: "hire_agent",
+            payload: { branch: "pap-1167" },
+            issueIds: ["44444444-4444-4444-4444-444444444444"],
+        });
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(String(url)).toBe("http://localhost:3100/api/companies/11111111-1111-1111-1111-111111111111/approvals");
+        expect(init.method).toBe("POST");
+        expect(JSON.parse(String(init.body))).toEqual({
+            type: "hire_agent",
+            payload: { branch: "pap-1167" },
+            issueIds: ["44444444-4444-4444-4444-444444444444"],
+        });
+    });
+    it("rejects invalid generic request paths", async () => {
+        vi.stubGlobal("fetch", vi.fn());
+        const tool = getTool("paperclipApiRequest");
+        const response = await tool.execute({
+            method: "GET",
+            path: "issues",
+        });
+        expect(response.content[0]?.text).toContain("path must start with /");
+    });
+    it("rejects generic request paths that escape /api", async () => {
+        vi.stubGlobal("fetch", vi.fn());
+        const tool = getTool("paperclipApiRequest");
+        const response = await tool.execute({
+            method: "GET",
+            path: "/../../secret",
+        });
+        expect(response.content[0]?.text).toContain("must not contain '..'");
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.test.js","sourceRoot":"","sources":["../src/tools.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@tickernelz/paperclip-pro-mcp-server",
+  "version": "2026.925.0",
+  "license": "MIT",
+  "homepage": "https://github.com/tickernelz/paperclip-pro",
+  "bugs": {
+    "url": "https://github.com/tickernelz/paperclip-pro/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tickernelz/paperclip-pro",
+    "directory": "packages/mcp-server"
+  },
+  "type": "module",
+  "bin": {
+    "paperclip-mcp-server": "./dist/stdio.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@tickernelz/paperclip-pro-shared": "2026.925.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=24.11.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}