@2kw/ai-mcp-server 6.2.0-dev.42 → 6.2.0-dev.49

package/dist/tools/agents.js

@@ -69,6 +69,36 @@ export function register(server, client) {
             };
         }
     });
+    // ── list_agent_catalog ──────────────────────────────────────────────────
+    server.tool("2kw_list_agent_catalog", "List published agents as id, name and description. This is the read a chat-only USER "
+        + "key may perform; 2kw_list_agents carries the operator configuration and needs VIEWER or above.", {
+        search: z.string().optional().describe("Filter agents by name"),
+        page: z.number().optional().default(0).describe("Page number (0-based)"),
+        size: z.number().optional().default(20).describe("Page size"),
+    }, async ({ search, page, size }) => {
+        try {
+            // No sort parameter: the catalog is always name-ascending (#814).
+            const { data } = await client.GET("/v1/agents/catalog", {
+                params: { query: { search, pageable: { page, size } } },
+            });
+            const result = data;
+            const lines = (result.content ?? []).map((a) => `- ${a.name} (id: ${a.id})${a.description ? ` — ${a.description}` : ""}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Published agents (${result.totalElements} total, page ${(result.number ?? 0) + 1}/${result.totalPages}):\n${lines.join("\n") || "(none)"}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
     // ── get_agent ───────────────────────────────────────────────────────────
     server.tool("2kw_get_agent", "Get an agent by its ID.", { agentId: z.string().describe("The agent ID") }, async ({ agentId }) => {
         try {
@@ -291,6 +321,37 @@ export function register(server, client) {
             };
         }
     });
+    // ── get_agent_version_policy ────────────────────────────────────────────
+    server.tool("2kw_get_agent_version_policy", "What the policy gate would do to a call of each tool an agent version configures: the verdict (EXECUTE, RELAY, PAUSE_APPROVAL, JUDGE, BLOCK, FAIL), the composed action, the class and where it came from, and every policy statement behind it. Read-only — no run, no approval row, no judge call. Answers 'what happens if this agent calls that tool' without running the agent.", {
+        agentId: z.string().describe("The agent ID"),
+        versionId: z.string().describe("The agent version ID"),
+        tool: z
+            .string()
+            .optional()
+            .describe("Answer for this tool only; omit for every tool the version configures"),
+        installationId: z
+            .string()
+            .optional()
+            .describe("Resolve this installation's module tool catalog, the way a run of that installation would. Omit to answer for the agent's own tools only."),
+    }, async ({ agentId, versionId, tool, installationId }) => {
+        try {
+            const { data } = await client.GET("/v1/agents/{agentId}/versions/{versionId}/policy", {
+                params: {
+                    path: { agentId, versionId },
+                    query: { tool, installation: installationId },
+                },
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
     // ── deactivate_agent_version ────────────────────────────────────────────
     server.tool("2kw_deactivate_agent_version", "Soft-delete an agent version.", {
         agentId: z.string().describe("The agent ID"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai-mcp-server",
-  "version": "6.2.0-dev.42",
+  "version": "6.2.0-dev.49",
   "description": "MCP server for 2kw.ai — EU-hosted AI platform: OpenAI-compatible LLM gateway, schema-driven document extraction, transcription, agents with a knowledge base, and cost observability. 158 tools for Claude Code, Cursor, and Windsurf.",
   "mcpName": "ai.2kw/mcp-server",
   "keywords": [