From 3f19a66f5cb5a131b881cb7baa93280ae09374f2 Mon Sep 17 00:00:00 2001
From: MathisRouget <rougetmathis@gmail.com>
Date: Fri, 31 Oct 2025 11:31:04 +0100
Subject: [PATCH 1/2] docs: fix inadequate tool server connections json

---
 docs/getting-started/env-configuration.mdx | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/docs/getting-started/env-configuration.mdx b/docs/getting-started/env-configuration.mdx
index bebb89ed..c9336d1c 100644
--- a/docs/getting-started/env-configuration.mdx
+++ b/docs/getting-started/env-configuration.mdx
@@ -737,7 +737,26 @@ The format for the JSON response is strictly:
 - Type: `str` (JSON array)
 - Default: `[]`
 - Description: Specifies a JSON array of tool server connection configurations. Each connection should define the necessary parameters to connect to external tool servers that implement the OpenAPI/MCPO protocol. The JSON must be properly formatted or it will fallback to an empty array.
-- Example: `'[{"name": "example-server", "url": "https://api.example.com", "api_key": "your-key"}]'`
+- Example: 
+```json
+[
+  {
+    "type": "openapi",
+    "url": "example-url",
+    "spec_type": "url",
+    "spec": "",
+    "path": "openapi.json",
+    "auth_type": "none",
+    "key": "",
+    "config": { "enable": true },
+    "info": {
+      "id": "",
+      "name": "example-server",
+      "description": "MCP server description."
+    }
+  }
+]
+```
 - Persistence: This environment variable is a `PersistentConfig` variable.
 
 ### Autocomplete

From bf46b617980d4804f7e14af4deb18e98b1b94c35 Mon Sep 17 00:00:00 2001
From: MathisRouget <rougetmathis@gmail.com>
Date: Sun, 2 Nov 2025 11:47:35 +0100
Subject: [PATCH 2/2] docs: add warning about tool connections data structure
 possible evolution overtime

---
 docs/getting-started/env-configuration.mdx | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/getting-started/env-configuration.mdx b/docs/getting-started/env-configuration.mdx
index c9336d1c..d68c33f1 100644
--- a/docs/getting-started/env-configuration.mdx
+++ b/docs/getting-started/env-configuration.mdx
@@ -759,6 +759,12 @@ The format for the JSON response is strictly:
 ```
 - Persistence: This environment variable is a `PersistentConfig` variable.
 
+:::warning
+
+The JSON data structure of `TOOL_SERVER_CONNECTIONS` might evolve over time as new features are added.
+
+:::
+
 ### Autocomplete
 
 #### `ENABLE_AUTOCOMPLETE_GENERATION`