contextforge-mcp 0.1.74 → 0.1.76

package/dist/index.js

@@ -3,7 +3,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { ApiClient, ApiClientError, readProjectLinkConfig, } from "./api-client.js";
-import { ConfigSchema, IngestInputSchema, QueryInputSchema, CreateProjectInputSchema, CreateSpaceInputSchema, RelateInputSchema, ListRelationshipsInputSchema, DeleteInputSchema, GitConnectInputSchema, GitActivateInputSchema, GitDisconnectInputSchema, GitSyncInputSchema, GitHistoryInputSchema, SnapshotCreateInputSchema, SnapshotRestoreInputSchema, SnapshotDeleteInputSchema, ExportInputSchema, ImportInputSchema, IngestBatchInputSchema, DeleteBatchInputSchema, LinkProjectInputSchema, parseArrayInput, } from "./types.js";
+import { ConfigSchema, IngestInputSchema, QueryInputSchema, CreateProjectInputSchema, CreateSpaceInputSchema, RelateInputSchema, ListRelationshipsInputSchema, DeleteInputSchema, GitConnectInputSchema, GitActivateInputSchema, GitDisconnectInputSchema, GitSyncInputSchema, GitHistoryInputSchema, SnapshotCreateInputSchema, SnapshotRestoreInputSchema, SnapshotDeleteInputSchema, ExportInputSchema, ImportInputSchema, IngestBatchInputSchema, DeleteBatchInputSchema, LinkProjectInputSchema, SkillsListInputSchema, SkillsGetInputSchema, SkillsCreateInputSchema, SkillsUpdateInputSchema, SkillsDeleteInputSchema, SkillsRunInputSchema, RoutinesListInputSchema, RoutinesGetInputSchema, RoutinesCreateInputSchema, RoutinesUpdateInputSchema, RoutinesToggleInputSchema, RoutinesRunNowInputSchema, RoutinesDeleteInputSchema, parseArrayInput, } from "./types.js";
 import { resolveTaskIdentifier } from "./task-params.js";
 import { appendFileSync } from "fs";
 import { createRequire } from "module";
@@ -89,6 +89,19 @@ function logTool(toolName, details) {
         tasks_add_comment: "💬",
         collaborators_list: "👥",
         project_share: "🔗",
+        skills_list: "🧰",
+        skills_get: "🔧",
+        skills_create: "➕",
+        skills_update: "✏️",
+        skills_delete: "🗑️",
+        skills_run: "▶️",
+        routines_list: "📅",
+        routines_get: "🔍",
+        routines_create: "➕",
+        routines_update: "✏️",
+        routines_toggle: "⏯",
+        routines_run_now: "▶",
+        routines_delete: "🗑️",
     };
     const icon = icons[toolName] || "🔧";
     log(icon, `${colors.bright}${toolName}${colors.reset}${details ? ` ${colors.dim}${details}${colors.reset}` : ""}`, colors.cyan);
@@ -1276,6 +1289,214 @@ const TOOLS = [
             required: ["email"],
         },
     },
+    {
+        name: "skills_list",
+        description: "List all Skills in a project. Returns skills with their name, description, model, and prompt body.",
+        annotations: { title: "List Skills", readOnlyHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "Project UUID" },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "skills_get",
+        description: "Get a single Skill by ID with full body.",
+        annotations: { title: "Get Skill", readOnlyHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Skill UUID" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "skills_create",
+        description: "Create a new Skill in a project. The 'body' is a markdown prompt template that may use {{variable}} placeholders for input_params at run time.",
+        annotations: { title: "Create Skill", destructiveHint: false },
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                name: { type: "string" },
+                description: { type: "string" },
+                body: {
+                    type: "string",
+                    description: "Markdown prompt template with optional {{var}} placeholders",
+                },
+                input_schema: {
+                    type: "object",
+                    description: "Optional JSON Schema for input_params",
+                },
+                llm_provider: {
+                    type: "string",
+                    enum: ["anthropic", "openai"],
+                    description: "Default 'anthropic'",
+                },
+                model: { type: "string", description: "e.g., claude-sonnet-4-6" },
+                save_to_space_id: {
+                    type: "string",
+                    description: "Optional: save outputs as knowledge_items in this space",
+                },
+            },
+            required: ["project_id", "name", "body", "model"],
+        },
+    },
+    {
+        name: "skills_update",
+        description: "Update an existing Skill.",
+        annotations: { title: "Update Skill", destructiveHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                name: { type: "string" },
+                description: { type: "string" },
+                body: { type: "string" },
+                input_schema: { type: "object" },
+                llm_provider: { type: "string", enum: ["anthropic", "openai"] },
+                model: { type: "string" },
+                save_to_space_id: { type: "string" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "skills_delete",
+        description: "Delete a Skill.",
+        annotations: { title: "Delete Skill", destructiveHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "skills_run",
+        description: "Execute a Skill on the configured LLM, optionally storing the output as a knowledge_item, and returns the result. Available to all project members.",
+        annotations: { title: "Run Skill", destructiveHint: false },
+        inputSchema: {
+            type: "object",
+            properties: {
+                skill_id: { type: "string" },
+                input_params: {
+                    type: "object",
+                    description: "Variables substituted into the skill body",
+                },
+            },
+            required: ["skill_id"],
+        },
+    },
+    {
+        name: "routines_list",
+        description: "List all Routines in a project. Returns routines with their schedule, last/next run, and enabled flag.",
+        annotations: { title: "List Routines", readOnlyHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "Project UUID" },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "routines_get",
+        description: "Get a single Routine by ID, including its cron expression, input_params, and last/next run.",
+        annotations: { title: "Get Routine", readOnlyHint: true },
+        inputSchema: {
+            type: "object",
+            properties: { id: { type: "string", description: "Routine UUID" } },
+            required: ["id"],
+        },
+    },
+    {
+        name: "routines_create",
+        description: "Create a new Routine. Schedules a Skill to run on a cron expression. Pass either schedule_preset (hourly/daily/weekly/monthly) OR a custom cron_expression. timezone defaults to UTC.",
+        annotations: { title: "Create Routine", destructiveHint: false },
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string" },
+                skill_id: { type: "string" },
+                name: { type: "string" },
+                schedule_preset: {
+                    type: "string",
+                    enum: ["hourly", "daily", "weekly", "monthly", "custom"],
+                },
+                cron_expression: {
+                    type: "string",
+                    description: "Required if schedule_preset=custom. Standard 5-field cron.",
+                },
+                timezone: {
+                    type: "string",
+                    description: "IANA TZ name, e.g. America/New_York. Default UTC.",
+                },
+                input_params: {
+                    type: "object",
+                    description: "Variables substituted into the Skill body at each run",
+                },
+            },
+            required: ["project_id", "skill_id", "name"],
+        },
+    },
+    {
+        name: "routines_update",
+        description: "Update an existing Routine (name, schedule, timezone, input_params).",
+        annotations: { title: "Update Routine", destructiveHint: false },
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                name: { type: "string" },
+                schedule_preset: {
+                    type: "string",
+                    enum: ["hourly", "daily", "weekly", "monthly", "custom"],
+                },
+                cron_expression: { type: "string" },
+                timezone: { type: "string" },
+                input_params: { type: "object" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "routines_toggle",
+        description: "Enable or disable a Routine without deleting it. Pass enabled=false to pause.",
+        annotations: { title: "Toggle Routine", destructiveHint: false },
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                enabled: { type: "boolean" },
+            },
+            required: ["id", "enabled"],
+        },
+    },
+    {
+        name: "routines_run_now",
+        description: "Fire a Routine immediately, ahead of its schedule. Creates a skill_executions row with trigger_type=scheduled and routine_id set, just like the cron tick would.",
+        annotations: { title: "Run Routine Now", destructiveHint: false },
+        inputSchema: {
+            type: "object",
+            properties: { id: { type: "string" } },
+            required: ["id"],
+        },
+    },
+    {
+        name: "routines_delete",
+        description: "Permanently delete a Routine. Execution history rows are retained.",
+        annotations: { title: "Delete Routine", destructiveHint: true },
+        inputSchema: {
+            type: "object",
+            properties: { id: { type: "string" } },
+            required: ["id"],
+        },
+    },
 ];
 // ============ Main Server ============
 async function main() {
@@ -3013,6 +3234,184 @@ https://github.com/contextforge/contextforge-mcp
                         ],
                     };
                 }
+                case "skills_list": {
+                    const input = SkillsListInputSchema.parse(args);
+                    logTool(name, input.project_id);
+                    const skills = await apiClient.listSkills(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(skills, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case "skills_get": {
+                    const input = SkillsGetInputSchema.parse(args);
+                    logTool(name, input.id);
+                    const skill = await apiClient.getSkill(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(skill, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case "skills_create": {
+                    const input = SkillsCreateInputSchema.parse(args);
+                    logTool(name, `"${input.name}"`);
+                    const skill = await apiClient.createSkill(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Created skill ${skill.name} (id: ${skill.id})`,
+                            },
+                        ],
+                    };
+                }
+                case "skills_update": {
+                    const input = SkillsUpdateInputSchema.parse(args);
+                    logTool(name, input.id);
+                    const skill = await apiClient.updateSkill(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Updated skill ${skill.name}`,
+                            },
+                        ],
+                    };
+                }
+                case "skills_delete": {
+                    const input = SkillsDeleteInputSchema.parse(args);
+                    logTool(name, input.id);
+                    await apiClient.deleteSkill(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `🗑️ Skill ${input.id} deleted`,
+                            },
+                        ],
+                    };
+                }
+                case "skills_run": {
+                    const input = SkillsRunInputSchema.parse(args);
+                    logTool(name, input.skill_id);
+                    const result = await apiClient.runSkill(input);
+                    const cost = typeof result?.cost_usd === "number"
+                        ? result.cost_usd.toFixed(4)
+                        : "0";
+                    const summary = `**Output:**\n\n${result?.output ?? ""}\n\n---\n*Tokens: ${result?.tokens_input ?? 0}/${result?.tokens_output ?? 0} • Cost: $${cost}*`;
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: summary,
+                            },
+                        ],
+                    };
+                }
+                case "routines_list": {
+                    const input = RoutinesListInputSchema.parse(args);
+                    logTool(name, input.project_id);
+                    const routines = await apiClient.listRoutines(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(routines, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case "routines_get": {
+                    const input = RoutinesGetInputSchema.parse(args);
+                    logTool(name, input.id);
+                    const routine = await apiClient.getRoutine(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(routine, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case "routines_create": {
+                    const input = RoutinesCreateInputSchema.parse(args);
+                    logTool(name, input.name);
+                    const routine = await apiClient.createRoutine(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Created routine ${routine?.name ?? input.name} (id: ${routine?.id ?? "?"})`,
+                            },
+                        ],
+                    };
+                }
+                case "routines_update": {
+                    const input = RoutinesUpdateInputSchema.parse(args);
+                    logTool(name, input.id);
+                    const routine = await apiClient.updateRoutine(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Updated routine ${routine?.name ?? input.id}`,
+                            },
+                        ],
+                    };
+                }
+                case "routines_toggle": {
+                    const input = RoutinesToggleInputSchema.parse(args);
+                    logTool(name, `${input.id} → ${input.enabled ? "enabled" : "paused"}`);
+                    const routine = await apiClient.toggleRoutine(input);
+                    const verb = input.enabled ? "enabled" : "paused";
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Routine ${verb}: ${routine?.name ?? input.id}`,
+                            },
+                        ],
+                    };
+                }
+                case "routines_run_now": {
+                    const input = RoutinesRunNowInputSchema.parse(args);
+                    logTool(name, input.id);
+                    const result = await apiClient.runRoutineNow(input);
+                    const cost = typeof result?.cost_usd === "number"
+                        ? result.cost_usd.toFixed(4)
+                        : "0";
+                    const summary = `**Routine fired**\n\n${result?.output ?? ""}\n\n---\n*Tokens: ${result?.tokens_input ?? 0}/${result?.tokens_output ?? 0} • Cost: $${cost}*`;
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: summary,
+                            },
+                        ],
+                    };
+                }
+                case "routines_delete": {
+                    const input = RoutinesDeleteInputSchema.parse(args);
+                    logTool(name, input.id);
+                    await apiClient.deleteRoutine(input);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `🗑 Routine deleted: ${input.id}`,
+                            },
+                        ],
+                    };
+                }
                 default:
                     logError(`Unknown tool: ${name}`);
                     return {