@ateam-ai/mcp 0.2.7 → 0.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ateam-ai/mcp",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "mcpName": "io.github.ariekogan/ateam-mcp",
   "description": "A-Team MCP Server — build, validate, and deploy multi-agent solutions from any AI environment",
   "type": "module",

package/src/tools.js

@@ -63,7 +63,7 @@ export const tools = [
     name: "ateam_get_spec",
     core: true,
     description:
-      "Get the A-Team specification — schemas, validation rules, system tools, agent guides, and templates. Start here after bootstrap to understand how to build skills and solutions.",
+      "Get the A-Team specification — schemas, validation rules, system tools, agent guides, and templates. Start here after bootstrap to understand how to build skills and solutions. Use 'section' to get just one part of the skill spec (much smaller than the full spec). Use 'search' to find specific fields or concepts across the spec.",
     inputSchema: {
       type: "object",
       properties: {
@@ -71,7 +71,18 @@ export const tools = [
           type: "string",
           enum: ["overview", "skill", "solution", "enums", "connector-multi-user"],
           description:
-            "What to fetch: 'overview' = API overview + endpoints, 'skill' = full skill spec, 'solution' = full solution spec, 'enums' = all enum values, 'connector-multi-user' = multi-user connector guide (actor isolation, zod gotcha, complete examples)",
+            "What to fetch: 'overview' = API overview + endpoints, 'skill' = full skill spec, 'solution' = full solution spec, 'enums' = all enum values, 'connector-multi-user' = multi-user connector guide",
+        },
+        section: {
+          type: "string",
+          enum: ["engine", "tools", "intents", "policy", "triggers", "connectors", "role", "template", "guide"],
+          description:
+            "Optional: get just one section of the skill spec (only works with topic='skill'). Sections: 'engine' = model/reasoning/planner optimization/bootstrap tools, 'tools' = tool definitions/meta tools, 'intents' = intents/problem/scenarios, 'policy' = access control/grants/workflows, 'triggers' = automation triggers, 'connectors' = connector linking/channels, 'role' = persona/goals, 'template' = minimal quick start, 'guide' = build steps/common mistakes",
+        },
+        search: {
+          type: "string",
+          description:
+            "Optional: filter the spec to only sections containing this search term. Works with any topic. Example: search='bootstrap' returns only fields/sections mentioning 'bootstrap'.",
         },
       },
       required: ["topic"],
@@ -237,7 +248,22 @@ export const tools = [
     name: "ateam_patch",
     core: true,
     description:
-      "Update a deployed skill or solution, redeploy, and optionally re-test — all in one step. Use this instead of calling update + redeploy separately. Requires authentication.",
+      "Surgically update ANY field in a skill or solution definition, redeploy, and optionally re-test — all in one step.\n\n" +
+      "SUPPORTED OPERATIONS:\n" +
+      "1. Scalar (dot notation): { \"problem.statement\": \"new value\", \"role.persona\": \"You are...\" }\n" +
+      "2. Deep nested: { \"intents.thresholds.accept\": 0.9, \"policy.escalation.enabled\": true }\n" +
+      "3. Array push: { \"tools_push\": [{ name: \"new_tool\", description: \"...\" }] }\n" +
+      "4. Array delete: { \"tools_delete\": [\"tool_name\"] }\n" +
+      "5. Array update: { \"tools_update\": [{ name: \"existing_tool\", description: \"updated\" }] }\n" +
+      "6. Replace whole section: { \"role\": { persona: \"...\", goals: [...] } }\n\n" +
+      "EXAMPLES:\n" +
+      "- Change persona: updates: { \"role.persona\": \"You are a friendly assistant\" }\n" +
+      "- Add a guardrail: updates: { \"policy.guardrails.never_push\": [\"Never share passwords\"] }\n" +
+      "- Update problem: updates: { \"problem.statement\": \"...\", \"problem.goals\": [\"goal1\"] }\n" +
+      "- Add a tool: updates: { \"tools_push\": [{ name: \"conn.tool\", description: \"...\", inputs: [...], output: {...} }] }\n" +
+      "- Change intent: updates: { \"intents.supported_update\": [{ id: \"i1\", description: \"new desc\" }] }\n" +
+      "- Force redeploy: updates: { \"_force_redeploy\": true }\n\n" +
+      "Use target='skill' + skill_id for skill fields. Use target='solution' for solution-level fields (linked_skills, platform_connectors, ui_plugins).",
     inputSchema: {
       type: "object",
       properties: {
@@ -248,16 +274,18 @@ export const tools = [
         target: {
           type: "string",
           enum: ["solution", "skill"],
-          description: "What to update: 'solution' or 'skill'",
+          description: "What to update: 'solution' for solution definition, 'skill' for skill definition fields (problem, role, intents, tools, policy, engine, scenarios, etc.)",
         },
         skill_id: {
           type: "string",
-          description: "Required when target is 'skill'",
+          description: "Required when target is 'skill'. The skill ID to patch.",
         },
         updates: {
           type: "object",
           description:
-            "The update payload — use dot notation for scalars (e.g. 'problem.statement'), and tools_push/tools_delete/tools_update for array operations",
+            "The update payload. Use dot notation for nested scalars (e.g. 'problem.statement': 'new value'). " +
+            "For arrays, use _push/_delete/_update suffixes (e.g. 'tools_push', 'tools_delete'). " +
+            "You can update ANY field in the skill definition: problem, role, intents, tools, policy, engine, scenarios, glossary, etc.",
         },
         test_message: {
           type: "string",
@@ -1093,7 +1121,15 @@ const handlers = {
     }
   },
 
-  ateam_get_spec: async ({ topic }, sid) => get(SPEC_PATHS[topic], sid),
+  ateam_get_spec: async ({ topic, section, search }, sid) => {
+    let path = SPEC_PATHS[topic];
+    const params = new URLSearchParams();
+    if (section) params.set('section', section);
+    if (search) params.set('search', search);
+    const qs = params.toString();
+    if (qs) path += `?${qs}`;
+    return get(path, sid);
+  },
 
   ateam_get_workflows: async (_args, sid) => get("/spec/workflows", sid),