paperclip-mcp 1.0.0

package/dist/tools/routines.js

@@ -0,0 +1,305 @@
+import { z } from "zod";
+import { validate, NoInput, handleApiError } from "./validation.js";
+const RoutineIdInput = z.object({
+    routineId: z.string().min(1).describe("Routine UUID"),
+});
+const TriggerIdInput = z.object({
+    triggerId: z.string().min(1).describe("Routine trigger UUID"),
+});
+const CreateRoutineInput = z.object({
+    agentId: z.string().min(1).describe("Agent UUID to run the routine"),
+    name: z.string().min(1).describe("Routine name"),
+    description: z.string().optional().describe("Routine description"),
+    concurrencyPolicy: z
+        .string()
+        .optional()
+        .describe("Concurrency policy (e.g. allow, forbid, replace)"),
+    catchUpPolicy: z
+        .string()
+        .optional()
+        .describe("Catch-up policy for missed runs (e.g. skip, run_once)"),
+});
+const UpdateRoutineInput = z.object({
+    routineId: z.string().min(1).describe("Routine UUID"),
+    name: z.string().optional().describe("New name"),
+    description: z.string().optional().describe("New description"),
+    concurrencyPolicy: z.string().optional().describe("New concurrency policy"),
+    catchUpPolicy: z.string().optional().describe("New catch-up policy"),
+});
+const AddTriggerInput = z.object({
+    routineId: z.string().min(1).describe("Routine UUID"),
+    type: z.enum(["schedule", "webhook", "api"]).describe("Trigger type"),
+    config: z
+        .object({
+        cron: z.string().optional().describe("Cron expression for schedule triggers"),
+    })
+        .optional()
+        .describe("Trigger configuration"),
+});
+const UpdateTriggerInput = z.object({
+    triggerId: z.string().min(1).describe("Routine trigger UUID"),
+    type: z.enum(["schedule", "webhook", "api"]).optional().describe("New trigger type"),
+    config: z
+        .object({
+        cron: z.string().optional().describe("New cron expression for schedule triggers"),
+    })
+        .optional()
+        .describe("New trigger configuration"),
+});
+export const routineTools = [
+    {
+        name: "paperclip_list_routines",
+        description: "List all routines for the current company.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                validate(NoInput, args);
+                const data = await client.get(`/api/companies/${client.companyId}/routines`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_get_routine",
+        description: "Get a single routine by ID, including its triggers and recent runs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                routineId: { type: "string", description: "Routine UUID" },
+            },
+            required: ["routineId"],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { routineId } = validate(RoutineIdInput, args);
+                const data = await client.get(`/api/routines/${routineId}`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_create_routine",
+        description: "Create a new routine for an agent. Add triggers separately with paperclip_add_routine_trigger. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agentId: { type: "string", description: "Agent UUID to run the routine" },
+                name: { type: "string", description: "Routine name" },
+                description: { type: "string", description: "Routine description" },
+                concurrencyPolicy: {
+                    type: "string",
+                    description: "Concurrency policy (e.g. allow, forbid, replace)",
+                },
+                catchUpPolicy: {
+                    type: "string",
+                    description: "Catch-up policy for missed runs (e.g. skip, run_once)",
+                },
+            },
+            required: ["agentId", "name"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const input = validate(CreateRoutineInput, args);
+                const body = { agentId: input.agentId, name: input.name };
+                if (input.description !== undefined)
+                    body.description = input.description;
+                if (input.concurrencyPolicy !== undefined)
+                    body.concurrencyPolicy = input.concurrencyPolicy;
+                if (input.catchUpPolicy !== undefined)
+                    body.catchUpPolicy = input.catchUpPolicy;
+                const data = await client.post(`/api/companies/${client.companyId}/routines`, body);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_update_routine",
+        description: "Update a routine's name, description, or scheduling policies. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                routineId: { type: "string", description: "Routine UUID" },
+                name: { type: "string", description: "New name" },
+                description: { type: "string", description: "New description" },
+                concurrencyPolicy: { type: "string", description: "New concurrency policy" },
+                catchUpPolicy: { type: "string", description: "New catch-up policy" },
+            },
+            required: ["routineId"],
+        },
+        annotations: { destructiveHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { routineId, ...rest } = validate(UpdateRoutineInput, args);
+                const body = {};
+                for (const [k, v] of Object.entries(rest)) {
+                    if (v !== undefined)
+                        body[k] = v;
+                }
+                const data = await client.patch(`/api/routines/${routineId}`, body);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_add_routine_trigger",
+        description: "Add a trigger to a routine (schedule, webhook, or api). Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                routineId: { type: "string", description: "Routine UUID" },
+                type: {
+                    type: "string",
+                    enum: ["schedule", "webhook", "api"],
+                    description: "Trigger type",
+                },
+                config: {
+                    type: "object",
+                    description: "Trigger configuration",
+                    properties: {
+                        cron: { type: "string", description: "Cron expression for schedule triggers" },
+                    },
+                },
+            },
+            required: ["routineId", "type"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { routineId, type, config } = validate(AddTriggerInput, args);
+                const body = { type };
+                if (config !== undefined)
+                    body.config = config;
+                const data = await client.post(`/api/routines/${routineId}/triggers`, body);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_update_routine_trigger",
+        description: "Update an existing routine trigger's type or config. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                triggerId: { type: "string", description: "Routine trigger UUID" },
+                type: {
+                    type: "string",
+                    enum: ["schedule", "webhook", "api"],
+                    description: "New trigger type",
+                },
+                config: {
+                    type: "object",
+                    description: "New trigger configuration",
+                    properties: {
+                        cron: { type: "string", description: "New cron expression for schedule triggers" },
+                    },
+                },
+            },
+            required: ["triggerId"],
+        },
+        annotations: { destructiveHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { triggerId, ...rest } = validate(UpdateTriggerInput, args);
+                const body = {};
+                if (rest.type !== undefined)
+                    body.type = rest.type;
+                if (rest.config !== undefined)
+                    body.config = rest.config;
+                const data = await client.patch(`/api/routine-triggers/${triggerId}`, body);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_delete_routine_trigger",
+        description: "Delete a routine trigger. The routine itself is not deleted. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                triggerId: { type: "string", description: "Routine trigger UUID" },
+            },
+            required: ["triggerId"],
+        },
+        annotations: { destructiveHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { triggerId } = validate(TriggerIdInput, args);
+                const data = await client.delete(`/api/routine-triggers/${triggerId}`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_run_routine",
+        description: "Manually trigger a routine run immediately. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                routineId: { type: "string", description: "Routine UUID" },
+            },
+            required: ["routineId"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { routineId } = validate(RoutineIdInput, args);
+                const data = await client.post(`/api/routines/${routineId}/run`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_list_routine_runs",
+        description: "List historical runs for a routine.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                routineId: { type: "string", description: "Routine UUID" },
+            },
+            required: ["routineId"],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { routineId } = validate(RoutineIdInput, args);
+                const data = await client.get(`/api/routines/${routineId}/runs`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+];
+//# sourceMappingURL=routines.js.map

package/dist/tools/routines.js.map

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

package/dist/tools/validation.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import type { ToolResult } from "./index.js";
+export declare function validate<T>(schema: z.ZodType<T>, args: unknown): T;
+export declare function handleApiError(err: unknown): ToolResult;
+export declare const NoInput: z.ZodObject<{}, z.core.$strip>;
+export declare const IssueIdSchema: z.ZodObject<{
+    issueId: z.ZodString;
+}, z.core.$strip>;
+export declare const StatusSchema: z.ZodEnum<{
+    backlog: "backlog";
+    todo: "todo";
+    in_progress: "in_progress";
+    in_review: "in_review";
+    done: "done";
+    blocked: "blocked";
+    cancelled: "cancelled";
+}>;
+export declare const PrioritySchema: z.ZodEnum<{
+    critical: "critical";
+    high: "high";
+    medium: "medium";
+    low: "low";
+}>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/tools/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/tools/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAMlE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAMvD;AAGD,eAAO,MAAM,OAAO,gCAAe,CAAC;AAEpC,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;EAQvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;EAAgD,CAAC"}

package/dist/tools/validation.js

@@ -0,0 +1,33 @@
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { PaperclipApiError } from "../errors.js";
+export function validate(schema, args) {
+    const result = schema.safeParse(args);
+    if (!result.success) {
+        throw new McpError(ErrorCode.InvalidParams, result.error.message);
+    }
+    return result.data;
+}
+export function handleApiError(err) {
+    if (err instanceof PaperclipApiError) {
+        const text = `Paperclip API error ${err.status} ${err.statusText}: ${JSON.stringify(err.body)}`;
+        return { isError: true, content: [{ type: "text", text }] };
+    }
+    throw err;
+}
+// Common input schemas reused across tool modules
+export const NoInput = z.object({});
+export const IssueIdSchema = z.object({
+    issueId: z.string().min(1),
+});
+export const StatusSchema = z.enum([
+    "backlog",
+    "todo",
+    "in_progress",
+    "in_review",
+    "done",
+    "blocked",
+    "cancelled",
+]);
+export const PrioritySchema = z.enum(["critical", "high", "medium", "low"]);
+//# sourceMappingURL=validation.js.map

package/dist/tools/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/tools/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,UAAU,QAAQ,CAAI,MAAoB,EAAE,IAAa;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,GAAG,YAAY,iBAAiB,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,uBAAuB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAChG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC9D,CAAC;IACD,MAAM,GAAG,CAAC;AACZ,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEpC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;IACjC,SAAS;IACT,MAAM;IACN,aAAa;IACb,WAAW;IACX,MAAM;IACN,SAAS;IACT,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+export interface PaperclipAgent {
+    id: string;
+    companyId: string;
+    name: string;
+    role: string;
+    title: string | null;
+    status: string;
+    reportsTo: string | null;
+    capabilities: string;
+    urlKey: string;
+    budgetMonthlyCents: number;
+    spentMonthlyCents: number;
+    chainOfCommand: Array<{
+        id: string;
+        name: string;
+        role: string;
+        title: string | null;
+    }>;
+}
+export interface PaperclipIssueCompact {
+    id: string;
+    identifier: string;
+    title: string;
+    status: string;
+    priority: string;
+    projectId: string | null;
+    goalId: string | null;
+    parentId: string | null;
+    updatedAt: string;
+    activeRun?: {
+        id: string;
+        status: string;
+        agentId: string;
+    } | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,KAAK,CAAC;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;CACV"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Shared Paperclip API response types
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "paperclip-mcp",
+  "version": "1.0.0",
+  "description": "Paperclip MCP server for Claude Code agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "paperclip-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mcp",
+    "paperclip",
+    "claude",
+    "model-context-protocol"
+  ],
+  "mcpName": "paperclip",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/paperclip-ai/paperclip-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/paperclip-ai/paperclip-mcp/issues"
+  },
+  "homepage": "https://github.com/paperclip-ai/paperclip-mcp#readme",
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "prepare": "npm run build",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint src",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx/esm --test 'src/**/*.test.ts'",
+    "docs:check": "find docs -name '*.md' | xargs markdown-link-check -c .markdown-link-check.json"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "markdown-link-check": "^3.12.0",
+    "prettier": "^3.0.0",
+    "shx": "^0.3.4",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}