From 97bcd8b1ba78919aabecb44e4df00f04ade1286c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 25 Jan 2026 14:55:29 +0000
Subject: [PATCH 1/3] Initial plan


From 0120045f7fe3b1bf0e378a81688af63a46d853c1 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 25 Jan 2026 15:08:51 +0000
Subject: [PATCH 2/3] Enhance MCP schema properties with improved descriptions
 and examples

- Add examples to registry property in stdio and http MCP tool definitions
- Improve allowed property description and add comprehensive examples (*, tool lists)
- Update entrypoint description to reference docker run --entrypoint
- Add more entrypoint examples (/custom/entrypoint.sh, python)
- Update examples in both tools section and $defs section for consistency

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 pkg/parser/schemas/main_workflow_schema.json | 29 ++++++++++++--------
 1 file changed, 17 insertions(+), 12 deletions(-)

diff --git a/pkg/parser/schemas/main_workflow_schema.json b/pkg/parser/schemas/main_workflow_schema.json
index a5bf1ca027..80c3d03744 100644
--- a/pkg/parser/schemas/main_workflow_schema.json
+++ b/pkg/parser/schemas/main_workflow_schema.json
@@ -3477,14 +3477,15 @@
                 },
                 "description": "List of allowed tool names (restricts which tools from the MCP server can be used)",
                 "examples": [
-                  ["create-issue", "add-comment"],
-                  ["read-file", "write-file"]
+                  ["*"],
+                  ["store_memory", "retrieve_memory"],
+                  ["create-issue", "add-comment"]
                 ]
               },
               "entrypoint": {
                 "type": "string",
-                "description": "Container entrypoint override (used with container field)",
-                "examples": ["/bin/sh", "node"]
+                "description": "Optional entrypoint override for container (equivalent to docker run --entrypoint)",
+                "examples": ["/bin/sh", "/custom/entrypoint.sh", "python"]
               },
               "mounts": {
                 "type": "array",
@@ -6342,7 +6343,8 @@
         },
         "registry": {
           "type": "string",
-          "description": "URI to the installation location when MCP is installed from a registry"
+          "description": "URI to the installation location when MCP is installed from a registry",
+          "examples": ["https://api.mcp.github.com/v0/servers/microsoft/markitdown"]
         },
         "command": {
           "type": "string",
@@ -6370,8 +6372,8 @@
         },
         "entrypoint": {
           "type": "string",
-          "description": "Container entrypoint override (used with container field)",
-          "examples": ["/bin/sh", "node"]
+          "description": "Optional entrypoint override for container (equivalent to docker run --entrypoint)",
+          "examples": ["/bin/sh", "/custom/entrypoint.sh", "python"]
         },
         "entrypointArgs": {
           "type": "array",
@@ -6428,10 +6430,11 @@
         },
         "allowed": {
           "type": "array",
-          "description": "List of allowed tool functions",
+          "description": "List of allowed tool names for this MCP server",
           "items": {
             "type": "string"
-          }
+          },
+          "examples": [["*"], ["store_memory", "retrieve_memory"], ["brave_web_search"]]
         }
       },
       "additionalProperties": false,
@@ -6490,7 +6493,8 @@
         },
         "registry": {
           "type": "string",
-          "description": "URI to the installation location when MCP is installed from a registry"
+          "description": "URI to the installation location when MCP is installed from a registry",
+          "examples": ["https://api.mcp.github.com/v0/servers/microsoft/markitdown"]
         },
         "url": {
           "type": "string",
@@ -6509,10 +6513,11 @@
         },
         "allowed": {
           "type": "array",
-          "description": "List of allowed tool functions",
+          "description": "List of allowed tool names for this MCP server",
           "items": {
             "type": "string"
-          }
+          },
+          "examples": [["*"], ["store_memory", "retrieve_memory"], ["brave_web_search"]]
         }
       },
       "required": ["url"],

From 32452c318d79b986642c6de11d868174ee619c59 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 25 Jan 2026 15:14:25 +0000
Subject: [PATCH 3/3] Task complete: Enhanced MCP schema properties

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 pkg/parser/schemas/main_workflow_schema.json | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/pkg/parser/schemas/main_workflow_schema.json b/pkg/parser/schemas/main_workflow_schema.json
index 80c3d03744..837a47ad90 100644
--- a/pkg/parser/schemas/main_workflow_schema.json
+++ b/pkg/parser/schemas/main_workflow_schema.json
@@ -3476,11 +3476,7 @@
                   "type": "string"
                 },
                 "description": "List of allowed tool names (restricts which tools from the MCP server can be used)",
-                "examples": [
-                  ["*"],
-                  ["store_memory", "retrieve_memory"],
-                  ["create-issue", "add-comment"]
-                ]
+                "examples": [["*"], ["store_memory", "retrieve_memory"], ["create-issue", "add-comment"]]
               },
               "entrypoint": {
                 "type": "string",