@2kw/ai-mcp-server 7.0.0 → 7.1.0-dev.2

package/README.md

@@ -1,6 +1,6 @@
 # 2kw.ai MCP Server
 
-An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for [2kw.ai](https://2kw.ai) — the EU-hosted AI integration platform. It gives AI coding assistants like Claude Code, Cursor, and Windsurf direct access to an [OpenAI-compatible LLM gateway](https://2kw.ai/gateway), [schema-driven document extraction](https://2kw.ai/extraction), audio transcription, custom agents with a knowledge base, and [cost observability](https://2kw.ai/observability) — 158 tools, straight from your editor.
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for [2kw.ai](https://2kw.ai) — the EU-hosted AI integration platform. It gives AI coding assistants like Claude Code, Cursor, and Windsurf direct access to an [OpenAI-compatible LLM gateway](https://2kw.ai/gateway), [schema-driven document extraction](https://2kw.ai/extraction), audio transcription, custom agents with a knowledge base, and [cost observability](https://2kw.ai/observability) — 199 tools, straight from your editor.
 
 Typical prompts once installed: *"extract the line items from this invoice PDF"*, *"create a schema for purchase orders and test it against these samples"*, *"transcribe this call recording"*, *"what did our extraction traffic cost this week?"*.
 

package/dist/client.js

@@ -31,6 +31,8 @@ const errorMiddleware = {
                 body.error?.message ??
                 `HTTP ${response.status}: ${response.statusText}`,
             timestamp: body.timestamp ?? new Date().toISOString(),
+            // A background run's 409 names its newest response, so the caller can poll it.
+            headResponseId: typeof body.error?.head_response_id === "string" ? body.error.head_response_id : undefined,
         });
     },
 };

package/dist/errors.d.ts

@@ -3,11 +3,14 @@ interface ApiErrorBody {
     message: string;
     status: number;
     timestamp: string;
+    /** The background run's newest response, named by a 409 the run's state answers. */
+    headResponseId?: string;
 }
 export declare class BackboneApiError extends Error {
     readonly status: number;
     readonly errorType: string;
     readonly timestamp: string;
+    readonly headResponseId?: string;
     constructor(apiError: ApiErrorBody);
 }
 export declare function formatErrorForMcp(error: unknown): string;

package/dist/errors.js

@@ -2,17 +2,20 @@ export class BackboneApiError extends Error {
     status;
     errorType;
     timestamp;
+    headResponseId;
     constructor(apiError) {
         super(apiError.message);
         this.name = "BackboneApiError";
         this.status = apiError.status;
         this.errorType = apiError.error;
         this.timestamp = apiError.timestamp;
+        this.headResponseId = apiError.headResponseId;
     }
 }
 export function formatErrorForMcp(error) {
     if (error instanceof BackboneApiError) {
-        return `API Error (${error.status}): ${error.message}`;
+        const head = error.headResponseId ? ` (newest response: ${error.headResponseId})` : "";
+        return `API Error (${error.status}): ${error.message}${head}`;
     }
     if (error instanceof Error) {
         return `Error: ${error.message}`;

package/dist/tools/ai-gateway.js

@@ -190,6 +190,39 @@ export function register(server, client) {
             };
         }
     });
+    // ── background responses ────────────────────────────────────────────────
+    server.tool("2kw_get_response", "Read a background response (one created with background: true) as it stands now. Its status is queued, in_progress, requires_action, completed, incomplete, failed or cancelled. Its output stays empty while it is queued or in_progress and is filled once the run completes or pauses. Poll it until it leaves queued and in_progress. Only background responses can be read by id; a synchronous one is refused, and an id the caller cannot see answers not found.", {
+        responseId: z.string().min(1).describe("The background response id (resp_...)"),
+    }, async ({ responseId }) => {
+        try {
+            const { data } = await client.GET("/v1/responses/{responseId}", {
+                params: { path: { responseId } },
+            });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("2kw_cancel_response", "Cancel the background run whose newest response this is. A queued or paused run is cancelled at once and answers status cancelled; a running one stops at its next step and answers in_progress until it does. Only the caller that started the run can cancel it. An older response of the run is refused with a conflict that names the newest response; a run that already ended is refused the same way.", {
+        responseId: z.string().min(1).describe("The run's newest background response id (resp_...)"),
+    }, async ({ responseId }) => {
+        try {
+            const { data } = await client.POST("/v1/responses/{responseId}/cancel", {
+                params: { path: { responseId } },
+            });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
     // ── list_models ─────────────────────────────────────────────────────────
     server.tool("2kw_list_models", "List available AI models and providers accessible through the Backbone AI gateway.", {}, async () => {
         try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@2kw/ai-mcp-server",
-  "version": "7.0.0",
-  "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.",
+  "version": "7.1.0-dev.2",
+  "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. 199 tools for Claude Code, Cursor, and Windsurf.",
   "mcpName": "ai.2kw/mcp-server",
   "keywords": [
     "mcp",