@2kw/ai-mcp-server 5.1.0 → 5.2.0

package/README.md

@@ -1,43 +1,15 @@
-# Backbone MCP Server
+# 2kw.ai MCP Server
 
-An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that gives AI coding assistants direct access to the [Backbone AI](https://backbone.manfred-kunze.dev) platform — manage schemas, run extractions, convert documents, and more from your IDE.
+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, and [cost observability](https://2kw.ai/observability) — 86 tools, straight from your editor.
 
-## Installation
-
-```bash
-npm install -g @manfred-kunze-dev/backbone-mcp-server
-```
-
-Or run directly with `npx` (no install needed):
-
-```bash
-npx @manfred-kunze-dev/backbone-mcp-server
-```
-
-## Quick Start
+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?"*.
 
-1. Create an API key in the Backbone dashboard under **API Keys**
-2. Add the server to your IDE's MCP configuration (see below)
-3. Start asking your AI assistant to manage your Backbone resources
-
-## IDE Configuration
+## Installation
 
 ### Claude Code
 
-Add to `.claude/settings.local.json` in your project root:
-
-```json
-{
-  "mcpServers": {
-    "backbone": {
-      "command": "npx",
-      "args": ["@manfred-kunze-dev/backbone-mcp-server"],
-      "env": {
-        "BACKBONE_API_KEY": "sk_your_api_key"
-      }
-    }
-  }
-}
+```bash
+claude mcp add 2kw --env AI_2KW_API_KEY=sk_your_api_key -- npx -y @2kw/ai-mcp-server
 ```
 
 ### Cursor
@@ -47,11 +19,11 @@ Add to `.cursor/mcp.json` in your project root:
 ```json
 {
   "mcpServers": {
-    "backbone": {
+    "2kw": {
       "command": "npx",
-      "args": ["@manfred-kunze-dev/backbone-mcp-server"],
+      "args": ["-y", "@2kw/ai-mcp-server"],
       "env": {
-        "BACKBONE_API_KEY": "sk_your_api_key"
+        "AI_2KW_API_KEY": "sk_your_api_key"
       }
     }
   }
@@ -60,63 +32,44 @@ Add to `.cursor/mcp.json` in your project root:
 
 ### Windsurf
 
-Add to `.windsurf/mcp.json` in your project root:
+Add the same block to `.windsurf/mcp.json`. Any MCP-compatible client works with this configuration pattern — the server speaks stdio by default and streamable HTTP when `MCP_TRANSPORT=http`.
 
-```json
-{
-  "mcpServers": {
-    "backbone": {
-      "command": "npx",
-      "args": ["@manfred-kunze-dev/backbone-mcp-server"],
-      "env": {
-        "BACKBONE_API_KEY": "sk_your_api_key"
-      }
-    }
-  }
-}
-```
-
-### OpenAI Codex CLI
-
-Add to `~/.codex/config.json`:
-
-```json
-{
-  "mcpServers": {
-    "backbone": {
-      "command": "npx",
-      "args": ["@manfred-kunze-dev/backbone-mcp-server"],
-      "env": {
-        "BACKBONE_API_KEY": "sk_your_api_key"
-      }
-    }
-  }
-}
-```
-
-Works with any MCP-compatible client using the same configuration pattern.
+Get an API key from your [2kw.ai dashboard](https://2kw.ai) — paid plans start with a 7-day free trial.
 
 ## Environment Variables
 
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
-| `BACKBONE_API_KEY` | Yes | — | API key for authenticating with the Backbone backend |
-| `BACKBONE_BASE_URL` | No | `https://backbone.manfred-kunze.dev/api` | Base URL of your Backbone instance |
+| `AI_2KW_API_KEY` | Yes | — | API key for the 2kw.ai platform (legacy alias: `BACKBONE_API_KEY`) |
+| `AI_2KW_BASE_URL` | No | 2kw.ai cloud API | Point at a self-hosted deployment (legacy alias: `BACKBONE_BASE_URL`) |
 | `MCP_TRANSPORT` | No | `stdio` | Transport mode: `stdio` or `http` |
 | `MCP_HTTP_PORT` | No | `3100` | Port for HTTP transport |
 
 ## Available Tools
 
-| Category | Tools |
-|----------|-------|
-| **Schemas** | CRUD operations, version management, validation, testing |
-| **Extractions** | Create extractions (sync/async), estimate tokens, re-run |
-| **Document Conversion** | Convert PDFs, DOCX, images to Markdown/text/HTML/JSON |
-| **Transcription** | Transcribe audio files (flac, mp3, mp4, ogg, wav, webm) |
-| **AI Gateway** | Chat completions, list available models |
-| **API Docs** | Browse API documentation by section |
-
-For full tool documentation, see the [Backbone docs](https://backbone.manfred-kunze.dev).
+| Category | What your assistant can do |
+|----------|---------------------------|
+| **Document conversion** | Convert PDF, DOCX, XLSX, images, and 20+ formats to Markdown/text/HTML/JSON |
+| **Data extraction** | Run schema-driven extractions (sync/async), estimate tokens, re-run, inspect results |
+| **AI Gateway** | Chat completions through the OpenAI-compatible gateway, list available models |
+| **Transcription** | Transcribe audio (FLAC, MP3, MP4, OGG, WAV, WebM) to text, JSON, SRT, VTT |
+| **Schemas** | CRUD, versioning, labels, validation, and testing against sample documents |
+| **Prompts** | Versioned prompt management, labels, compilation, testing |
+| **Datasets & experiments** | Build datasets, run experiments, manage evaluators, record scores |
+| **Observability** | Analytics (spend, quality, providers, errors), traces, billing limits |
+| **API docs** | Browse the platform API documentation by section |
+
+## Why 2kw.ai
+
+- **EU data residency** — built-in models run GDPR-compliant and EU-hosted, operated by Manfred Kunze Development GmbH (Germany)
+- **One platform** — gateway, extraction, transcription, and observability share one API, one dashboard, one bill
+- **Grounding scores** — every extracted value links back to where it came from in the source document
+
+## Related
+
+- [2kw.ai](https://2kw.ai) — platform overview and pricing
+- [Documentation](https://docs.2kw.ai) — full API reference and guides
+- [`@2kw/ai`](https://www.npmjs.com/package/@2kw/ai) — the 2kw.ai CLI (`2kw`, `backbone`, `bb`) for terminals and agentic workflows
 
 ## License
 

package/dist/index.js

@@ -3,7 +3,9 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 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";
@@ -60,8 +62,8 @@ async function main() {
     const httpPort = parseInt(process.env.MCP_HTTP_PORT ?? "3100", 10);
     const client = createApiClient(baseUrl, apiKey);
     const server = new McpServer({
-        name: "backbone",
-        version: "1.0.0",
+        name: "2kw",
+        version: pkg.version,
     });
     // Register all tool groups
     conversion.register(server, client);

package/package.json

@@ -1,7 +1,28 @@
 {
   "name": "@2kw/ai-mcp-server",
-  "version": "5.1.0",
-  "description": "MCP server for the 2kw.ai platform (engineering name: Backbone)",
+  "version": "5.2.0",
+  "description": "MCP server for 2kw.ai — EU-hosted AI platform: OpenAI-compatible LLM gateway, schema-driven document extraction, transcription, and cost observability. 86 tools for Claude Code, Cursor, and Windsurf.",
+  "mcpName": "ai.2kw/mcp-server",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "llm-gateway",
+    "ai-gateway",
+    "document-extraction",
+    "structured-data-extraction",
+    "pdf-extraction",
+    "openai-compatible",
+    "transcription",
+    "llm-observability",
+    "prompt-management",
+    "claude-code",
+    "cursor",
+    "windsurf",
+    "gdpr",
+    "eu-data-residency",
+    "2kw"
+  ],
   "type": "module",
   "main": "dist/index.js",
   "bin": {