@2kw/ai-mcp-server 6.3.0-dev.84 → 6.3.0-dev.89

package/dist/index.js

@@ -6,32 +6,7 @@ import { createServer } from "node:http";
 import { createRequire } from "node:module";
 import { createApiClient } from "./client.js";
 const pkg = createRequire(import.meta.url)("../package.json");
-import * as conversion from "./tools/conversion.js";
-import * as extraction from "./tools/extraction.js";
-import * as aiGateway from "./tools/ai-gateway.js";
-import * as transcription from "./tools/transcription.js";
-import * as schemas from "./tools/schemas.js";
-import * as schemaLabels from "./tools/schema-labels.js";
-import * as schemaVersions from "./tools/schema-versions.js";
-import * as schemaTesting from "./tools/schema-testing.js";
-import * as datasets from "./tools/datasets.js";
-import * as experiments from "./tools/experiments.js";
-import * as evaluators from "./tools/evaluators.js";
-import * as prompts from "./tools/prompts.js";
-import * as skills from "./tools/skills.js";
-import * as plugins from "./tools/plugins.js";
-import * as providers from "./tools/providers.js";
-import * as billing from "./tools/billing.js";
-import * as scores from "./tools/scores.js";
-import * as annotationQueues from "./tools/annotation-queues.js";
-import * as tracing from "./tools/tracing.js";
-import * as analytics from "./tools/analytics.js";
-import * as docs from "./tools/docs.js";
-import * as agents from "./tools/agents.js";
-import * as conversations from "./tools/conversations.js";
-import * as knowledge from "./tools/knowledge.js";
-import * as files from "./tools/files.js";
-import * as memory from "./tools/memory.js";
+import { registerAllTools } from "./tools/index.js";
 // Read the canonical KW_* env var; fall back to legacy BACKBONE_* for
 // backwards compatibility. Warn once on stderr when the legacy name supplied
 // the value.
@@ -62,7 +37,7 @@ function requireEnv(canonical, legacy) {
 }
 const DEFAULT_BASE_URL = process.env.AI_2KW_DEFAULT_BASE_URL ??
     process.env.BACKBONE_DEFAULT_BASE_URL ??
-    "https://backbone.manfred-kunze.dev/api";
+    "https://api.2kw.ai";
 async function main() {
     const apiKey = requireEnv("AI_2KW_API_KEY", "BACKBONE_API_KEY");
     const baseUrl = readEnv("AI_2KW_BASE_URL", "BACKBONE_BASE_URL") ?? DEFAULT_BASE_URL;
@@ -74,33 +49,7 @@ async function main() {
         name: "2kw",
         version: pkg.version,
     });
-    // Register all tool groups
-    conversion.register(server, client);
-    extraction.register(server, client);
-    aiGateway.register(server, client);
-    transcription.register(server, client);
-    schemas.register(server, client);
-    schemaLabels.register(server, client);
-    schemaVersions.register(server, client);
-    schemaTesting.register(server, client);
-    datasets.register(server, client);
-    experiments.register(server, client);
-    evaluators.register(server, client);
-    prompts.register(server, client);
-    skills.register(server, client);
-    plugins.register(server, client);
-    providers.register(server, client);
-    billing.register(server, client);
-    scores.register(server, client);
-    annotationQueues.register(server, client);
-    tracing.register(server, client);
-    analytics.register(server, client);
-    docs.register(server, client, baseUrl, apiKey);
-    agents.register(server, client);
-    conversations.register(server, client);
-    knowledge.register(server, client);
-    files.register(server, client);
-    memory.register(server, client);
+    registerAllTools(server, { client, baseUrl, apiKey });
     if (transport === "http") {
         const httpTransport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
         const httpServer = createServer(async (req, res) => {

package/dist/tools/index.d.ts

@@ -0,0 +1,21 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../client.js";
+export interface ToolDeps {
+    client: ApiClient;
+    baseUrl: string;
+    apiKey: string;
+}
+/**
+ * One tool module. `id` is its file name under src/tools; `title` and `summary` head its table on
+ * the public docs page, which `npm run docs:tools` generates from this list (#1148).
+ */
+export interface ToolGroup {
+    id: string;
+    title: string;
+    summary: string;
+    register(server: McpServer, deps: ToolDeps): void;
+}
+/** Every tool module, in the order the docs page lists them. A new module must be added here. */
+export declare const TOOL_GROUPS: readonly ToolGroup[];
+export declare function registerAllTools(server: McpServer, deps: ToolDeps): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.js

@@ -0,0 +1,190 @@
+import * as agents from "./agents.js";
+import * as aiGateway from "./ai-gateway.js";
+import * as analytics from "./analytics.js";
+import * as annotationQueues from "./annotation-queues.js";
+import * as billing from "./billing.js";
+import * as conversations from "./conversations.js";
+import * as conversion from "./conversion.js";
+import * as datasets from "./datasets.js";
+import * as docs from "./docs.js";
+import * as evaluators from "./evaluators.js";
+import * as experiments from "./experiments.js";
+import * as extraction from "./extraction.js";
+import * as files from "./files.js";
+import * as knowledge from "./knowledge.js";
+import * as memory from "./memory.js";
+import * as plugins from "./plugins.js";
+import * as prompts from "./prompts.js";
+import * as providers from "./providers.js";
+import * as schemaLabels from "./schema-labels.js";
+import * as schemaTesting from "./schema-testing.js";
+import * as schemaVersions from "./schema-versions.js";
+import * as schemas from "./schemas.js";
+import * as scores from "./scores.js";
+import * as skills from "./skills.js";
+import * as tracing from "./tracing.js";
+import * as transcription from "./transcription.js";
+/** Every tool module, in the order the docs page lists them. A new module must be added here. */
+export const TOOL_GROUPS = [
+    {
+        id: "ai-gateway",
+        title: "AI Gateway",
+        summary: "Call models through the gateway — chat completions, the Responses endpoint (including stored agents) and the model list.",
+        register: (s, d) => aiGateway.register(s, d.client),
+    },
+    {
+        id: "agents",
+        title: "Agents",
+        summary: "Manage agents, their versions, labels and tool catalogs, and decide paused approvals. See [Running agents](#running-agents).",
+        register: (s, d) => agents.register(s, d.client),
+    },
+    {
+        id: "conversations",
+        title: "Conversations",
+        summary: "Create, read, rename and delete conversations, list their items and cancel a running turn.",
+        register: (s, d) => conversations.register(s, d.client),
+    },
+    {
+        id: "memory",
+        title: "Memory",
+        summary: "Read and edit your own agent memory, and see or erase a member's memory as an admin.",
+        register: (s, d) => memory.register(s, d.client),
+    },
+    {
+        id: "knowledge",
+        title: "Knowledge Bases",
+        summary: "Manage knowledge bases and their documents, search them and resolve citations.",
+        register: (s, d) => knowledge.register(s, d.client),
+    },
+    {
+        id: "files",
+        title: "Files",
+        summary: "Upload, list, download and delete files.",
+        register: (s, d) => files.register(s, d.client),
+    },
+    {
+        id: "skills",
+        title: "Skills",
+        summary: "Import, read, resolve and delete skills, with their versions and labels.",
+        register: (s, d) => skills.register(s, d.client),
+    },
+    {
+        id: "plugins",
+        title: "Plugins",
+        summary: "Install, sync, update and remove plugins.",
+        register: (s, d) => plugins.register(s, d.client),
+    },
+    {
+        id: "prompts",
+        title: "Prompts",
+        summary: "Manage prompts, their versions and labels, and resolve, compile or test them.",
+        register: (s, d) => prompts.register(s, d.client),
+    },
+    {
+        id: "schemas",
+        title: "Schemas",
+        summary: "Define extraction schemas within your organization.",
+        register: (s, d) => schemas.register(s, d.client),
+    },
+    {
+        id: "schema-versions",
+        title: "Schema Versions",
+        summary: "Manage versioned snapshots of schema definitions.",
+        register: (s, d) => schemaVersions.register(s, d.client),
+    },
+    {
+        id: "schema-labels",
+        title: "Schema Labels",
+        summary: "Point named labels at schema versions.",
+        register: (s, d) => schemaLabels.register(s, d.client),
+    },
+    {
+        id: "schema-testing",
+        title: "Schema Testing",
+        summary: "Validate schemas and test extractions without persisting data.",
+        register: (s, d) => schemaTesting.register(s, d.client),
+    },
+    {
+        id: "extraction",
+        title: "Extractions",
+        summary: "Extract structured data from text using schemas and AI models.",
+        register: (s, d) => extraction.register(s, d.client),
+    },
+    {
+        id: "conversion",
+        title: "Document Conversion",
+        summary: "Convert documents (PDF, DOCX and more) to Markdown, text, HTML or JSON.",
+        register: (s, d) => conversion.register(s, d.client),
+    },
+    {
+        id: "transcription",
+        title: "Audio Transcription",
+        summary: "Transcribe audio files using AI models.",
+        register: (s, d) => transcription.register(s, d.client),
+    },
+    {
+        id: "datasets",
+        title: "Datasets",
+        summary: "Manage evaluation datasets, their versions and items.",
+        register: (s, d) => datasets.register(s, d.client),
+    },
+    {
+        id: "experiments",
+        title: "Experiments",
+        summary: "Run experiments over datasets, compare variants and track regressions against a baseline.",
+        register: (s, d) => experiments.register(s, d.client),
+    },
+    {
+        id: "evaluators",
+        title: "Evaluators",
+        summary: "List evaluator types and manage evaluator templates.",
+        register: (s, d) => evaluators.register(s, d.client),
+    },
+    {
+        id: "scores",
+        title: "Scores",
+        summary: "Record and list human scores.",
+        register: (s, d) => scores.register(s, d.client),
+    },
+    {
+        id: "annotation-queues",
+        title: "Annotation Queues",
+        summary: "Manage annotation queues and work through their items.",
+        register: (s, d) => annotationQueues.register(s, d.client),
+    },
+    {
+        id: "tracing",
+        title: "Tracing",
+        summary: "Read traces and trace sessions, and change the tracing settings.",
+        register: (s, d) => tracing.register(s, d.client),
+    },
+    {
+        id: "analytics",
+        title: "Analytics",
+        summary: "Usage, error and quality analytics for your organization.",
+        register: (s, d) => analytics.register(s, d.client),
+    },
+    {
+        id: "providers",
+        title: "Providers",
+        summary: "Manage AI providers and list their models.",
+        register: (s, d) => providers.register(s, d.client),
+    },
+    {
+        id: "billing",
+        title: "Billing",
+        summary: "Read your billing tier and limits, and check available budget.",
+        register: (s, d) => billing.register(s, d.client),
+    },
+    {
+        id: "docs",
+        title: "API Documentation",
+        summary: "Browse the backend's OpenAPI documentation by section.",
+        register: (s, d) => docs.register(s, d.client, d.baseUrl, d.apiKey),
+    },
+];
+export function registerAllTools(server, deps) {
+    for (const group of TOOL_GROUPS)
+        group.register(server, deps);
+}
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai-mcp-server",
-  "version": "6.3.0-dev.84",
+  "version": "6.3.0-dev.89",
   "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": [
@@ -41,6 +41,8 @@
     "check:generated": "tsx openapi/scripts/check-generated.ts",
     "fix:generated": "tsx openapi/scripts/check-generated.ts --write",
     "check:coverage": "tsx ../cli/openapi/scripts/check-coverage.ts",
+    "docs:tools": "tsx scripts/tool-docs.ts",
+    "check:tool-docs": "tsx scripts/tool-docs.ts --check",
     "test": "tsx --test tests/*.test.ts",
     "typecheck": "tsc --noEmit"
   },