fix: add TOON response format support and documentation

- Added RESPONSE_FORMAT environment variable to configure default response format (json/toon)
- Documented TOON format as AI-optimized responses with natural language descriptions
- Added format priority documentation: params.format > arguments.format > default
- Updated manifest.json with response_format configuration option
- Added X-Response-Format header support in HTTP bridge
- Bumped version to 1.1.9

Author: pitw

README.en.md

@@ -125,7 +125,8 @@ For other MCP clients (Cursor, Windsurf, Gemini CLI, etc.) or if you want to man
         "PROFFIX_PASSWORD": "your-password",
         "PROFFIX_URL": "https://your-proffix.com",
         "PROFFIX_PORT": "11011",
-        "PROFFIX_DATABASE": "your-db"
+        "PROFFIX_DATABASE": "your-db",
+        "RESPONSE_FORMAT": "json"
       }
     }
   }
@@ -198,6 +199,45 @@ The pfx MCP Server implements the standardized Model Context Protocol via JSON-R
 - `proffix_describe_endpoint` - Endpoint documentation
 - All specific Proffix API endpoints (Addresses, Articles, Orders, etc.)
 
+### Response Formats
+
+The server supports two response formats:
+
+- **JSON** (default) - Structured JSON responses directly from the Proffix API
+- **TOON** (AI-optimized) - Enhanced responses with natural language descriptions, optimized for AI processing
+
+**Format Activation:**
+
+1. **Global** (recommended) - Applies to all calls:
+```json
+{
+  "name": "proffix_call_endpoint",
+  "arguments": {
+    "endpointId": 9,
+    "format": "toon",
+    "params": {
+      "limit": 10
+    }
+  }
+}
+```
+
+2. **Per-Call** - Overrides global setting:
+```json
+{
+  "name": "proffix_call_endpoint",
+  "arguments": {
+    "endpointId": 9,
+    "params": {
+      "limit": 10,
+      "format": "toon"
+    }
+  }
+}
+```
+
+**Priority:** `params.format` > `arguments.format` > `"json"` (default)
+
 **Server URL:** `https://mcp.pfx.ch/api/server`
 
 [🔧 Test Examples & Debugging](https://mcp.pfx.ch/debug.html)

README.md

@@ -125,7 +125,8 @@ Für andere MCP-Clients (Cursor, Windsurf, Gemini CLI, etc.) oder wenn du die Ko
         "PROFFIX_PASSWORD": "dein-passwort",
         "PROFFIX_URL": "https://dein-proffix.com",
         "PROFFIX_PORT": "11011",
-        "PROFFIX_DATABASE": "deine-db"
+        "PROFFIX_DATABASE": "deine-db",
+        "RESPONSE_FORMAT": "json"
       }
     }
   }
@@ -198,6 +199,45 @@ Der pfx MCP Server implementiert das standardisierte Model Context Protocol übe
 - `proffix_describe_endpoint` - Endpoint-Dokumentation
 - Alle spezifischen Proffix API Endpoints (Adressen, Artikel, Aufträge, etc.)
 
+### Response Formate
+
+Der Server unterstützt zwei Antwortformate:
+
+- **JSON** (Standard) - Strukturierte JSON-Antworten direkt von der Proffix API
+- **TOON** (AI-optimiert) - Angereicherte Antworten mit natürlichsprachigen Beschreibungen, optimiert für AI-Verarbeitung
+
+**Format-Aktivierung:**
+
+1. **Global** (empfohlen) - Gilt für alle Aufrufe:
+```json
+{
+  "name": "proffix_call_endpoint",
+  "arguments": {
+    "endpointId": 9,
+    "format": "toon",
+    "params": {
+      "limit": 10
+    }
+  }
+}
+```
+
+2. **Per-Call** - Überschreibt globale Einstellung:
+```json
+{
+  "name": "proffix_call_endpoint",
+  "arguments": {
+    "endpointId": 9,
+    "params": {
+      "limit": 10,
+      "format": "toon"
+    }
+  }
+}
+```
+
+**Priorität:** `params.format` > `arguments.format` > `"json"` (Standard)
+
 **Server URL:** `https://mcp.pfx.ch/api/server`
 
 [🔧 Test-Beispiele & Debugging](https://mcp.pfx.ch/debug.html)

bundle/manifest.json

@@ -3,8 +3,8 @@
   "name": "pfx-mcp-server",
   "display_name": "Proffix Px5 MCP Server",
   "description": "Connect AI assistants to your Forterro Proffix Px5 ERP system via MCP protocol",
-  "long_description": "The Proffix Px5 MCP Server enables AI assistants like Claude to communicate directly with your Proffix ERP system. Access addresses, articles, orders and other Proffix functions without leaving the ERP system. All data is securely transmitted via your own Proffix REST API.",
-  "version": "1.1.8",
+  "long_description": "The Proffix Px5 MCP Server enables AI assistants like Claude to communicate directly with your Proffix ERP system. Access addresses, articles, orders and other Proffix functions without leaving the ERP system. All data is securely transmitted via your own Proffix REST API. Supports both JSON and TOON (AI-optimized) response formats.",
+  "version": "1.1.9",
   "icon": "icon.png",
   "author": {
     "name": "pfx.ch",
@@ -86,6 +86,14 @@
       "title": "Proffix Database",
       "description": "Your Proffix database name",
       "required": true
+    },
+    "response_format": {
+      "type": "string",
+      "title": "Response Format",
+      "description": "Default response format: 'json' (standard) or 'toon' (AI-optimized with natural language descriptions). Can be overridden per call.",
+      "required": false,
+      "default": "json",
+      "enum": ["json", "toon"]
     }
   },
   "localization": {

mcp-http-bridge.js

@@ -16,6 +16,14 @@
  *   PROFFIX_URL         - Proffix server URL
  *   PROFFIX_PORT        - Proffix server port
  *   PROFFIX_DATABASE    - Proffix database name
+ *   RESPONSE_FORMAT     - Default response format: 'json' or 'toon' (optional)
+ * 
+ * Response Formats:
+ *   json - Standard JSON response (default)
+ *   toon - AI-optimized format with natural language descriptions
+ * 
+ * Format can be set globally via RESPONSE_FORMAT env var or per-call via
+ * the 'format' parameter in tool arguments or params.
  */
 
 const https = require('https');
@@ -38,6 +46,9 @@ const PROFFIX_DATABASE = process.env.PROFFIX_DATABASE || '';
 // API Key from environment (Authorization header)
 const HTTP_AUTHORIZATION = process.env.HTTP_AUTHORIZATION || '';
 
+// Response format from environment (optional)
+const RESPONSE_FORMAT = process.env.RESPONSE_FORMAT || '';
+
 // Setup file logging
 const LOG_FILE = path.join(os.tmpdir(), 'pfx-mcp-bridge.log');
 const logStream = fs.createWriteStream(LOG_FILE, { flags: 'a' });
@@ -91,6 +102,11 @@ function makeRequest(jsonRpcRequest, callback) {
     headers['Authorization'] = HTTP_AUTHORIZATION;
   }
 
+  // Add Response Format header if provided
+  if (RESPONSE_FORMAT) {
+    headers['X-Response-Format'] = RESPONSE_FORMAT;
+  }
+
   const options = {
     hostname: serverUrl.hostname,
     port: serverUrl.port || (isHttps ? 443 : 80),

package.json

@@ -1,6 +1,6 @@
 {
   "name": "pfx-mcp-server",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "description": "MCP Server for Forterro Proffix Px5 ERP",
   "main": "mcp-http-bridge.js",
   "bin": {

server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/pitwch/pfx-mcp-server",
     "source": "github"
   },
-  "version": "1.1.8",
+  "version": "1.1.9",
   "remotes": [
     {
       "type": "streamable-http",