refactor issue creation UI

mattdholloway · Jun 16, 2026 · Jan 7, 2026 · Jan 7, 2026 · Jan 7, 2026 · Jan 15, 2026
commit c92739053d4254d5b04f751af23ddab8acb3a9e6
diff --git a/pkg/github/__toolsnaps__/issue_write.snap b/pkg/github/__toolsnaps__/issue_write.snap
@@ -1,8 +1,17 @@
 {
+  "_meta": {
+    "ui": {
+      "resourceUri": "ui://github-mcp-server/issue-write",
+      "visibility": [
+        "model",
+        "app"
+      ]
+    }
+  },
   "annotations": {
     "title": "Create or update issue."
   },
-  "description": "Create a new or update an existing issue in a GitHub repository.",
+  "description": "Create a new or update an existing issue in a GitHub repository.\n\nWhen show_ui is true, an interactive form is displayed for the user to fill in issue details. Use show_ui when:\n- Creating a new issue and you want user input on the details\n- The user hasn't specified all required fields (title, body, etc.)\n- Interactive feedback would be valuable\n\nWhen show_ui is false or omitted, the issue is created/updated directly with the provided parameters.",
   "inputSchema": {
     "properties": {
       "assignees": {
@@ -51,6 +60,10 @@
         "description": "Repository name",
         "type": "string"
       },
+      "show_ui": {
+        "description": "If true, show an interactive form for the user to fill in issue details. If false or omitted, create/update the issue directly with the provided parameters. Use show_ui when you want user input or when not all fields are specified.",
+        "type": "boolean"
+      },
       "state": {
         "description": "New state",
         "enum": [

@@ -1152,19 +1152,40 @@ func SearchIssues(t translations.TranslationHelperFunc) inventory.ServerTool {
 }
 
 // IssueWrite creates a tool to create a new or update an existing issue in a GitHub repository.
+// IssueWriteUIResourceURI is the URI for the issue_write tool's MCP App UI resource.
+const IssueWriteUIResourceURI = "ui://github-mcp-server/issue-write"
+
 func IssueWrite(t translations.TranslationHelperFunc) inventory.ServerTool {
 	return NewTool(
 		ToolsetMetadataIssues,
 		mcp.Tool{
-			Name:        "issue_write",
-			Description: t("TOOL_ISSUE_WRITE_DESCRIPTION", "Create a new or update an existing issue in a GitHub repository."),
+			Name: "issue_write",
+			Description: t("TOOL_ISSUE_WRITE_DESCRIPTION", `Create a new or update an existing issue in a GitHub repository.
+
+When show_ui is true, an interactive form is displayed for the user to fill in issue details. Use show_ui when:
+- Creating a new issue and you want user input on the details
+- The user hasn't specified all required fields (title, body, etc.)
+- Interactive feedback would be valuable
+
+When show_ui is false or omitted, the issue is created/updated directly with the provided parameters.`),
 			Annotations: &mcp.ToolAnnotations{
 				Title:        t("TOOL_ISSUE_WRITE_USER_TITLE", "Create or update issue."),
 				ReadOnlyHint: false,
 			},
+			// MCP Apps UI metadata - links this tool to its UI resource
+			Meta: mcp.Meta{
+				"ui": map[string]any{
+					"resourceUri": IssueWriteUIResourceURI,
+					"visibility":  []string{"model", "app"},
+				},
+			},
 			InputSchema: &jsonschema.Schema{
 				Type: "object",
 				Properties: map[string]*jsonschema.Schema{
+					"show_ui": {
+						Type:        "boolean",
+						Description: "If true, show an interactive form for the user to fill in issue details. If false or omitted, create/update the issue directly with the provided parameters. Use show_ui when you want user input or when not all fields are specified.",
+					},
 					"method": {
 						Type: "string",
 						Description: `Write operation to perform on a single issue.
@@ -1249,6 +1270,26 @@ Options are:
 			if err != nil {
 				return utils.NewToolResultError(err.Error()), nil, nil
 			}
+
+			// Check if UI mode is requested
+			showUI, err := OptionalParam[bool](args, "show_ui")
+			if err != nil {
+				return utils.NewToolResultError(err.Error()), nil, nil
+			}
+
+			// If show_ui is true, return a message indicating the UI should be shown
+			// The host will detect the UI metadata and display the form
+			if showUI {
+				if method == "update" {
+					issueNumber, numErr := RequiredInt(args, "issue_number")
+					if numErr != nil {
+						return utils.NewToolResultError("issue_number is required for update method"), nil, nil
+					}
+					return utils.NewToolResultText(fmt.Sprintf("Ready to update issue #%d in %s/%s. The interactive form will be displayed.", issueNumber, owner, repo)), nil, nil
+				}
+				return utils.NewToolResultText(fmt.Sprintf("Ready to create an issue in %s/%s. The interactive form will be displayed.", owner, repo)), nil, nil
+			}
+
 			title, err := OptionalParam[string](args, "title")
 			if err != nil {
 				return utils.NewToolResultError(err.Error()), nil, nil

diff --git a/pkg/github/issues_ui.go b/pkg/github/issues_ui.go
@@ -194,7 +194,6 @@ func AllTools(t translations.TranslationHelperFunc) []inventory.ServerTool {
 		ListAssignees(t),
 		ListMilestones(t),
 		IssueWrite(t),
-		CreateIssueUI(t),
 		AddIssueComment(t),
 		AssignCopilotToIssue(t),
 		SubIssueWrite(t),

@@ -48,11 +48,11 @@ func RegisterUIResources(s *mcp.Server) {
 		&mcp.Resource{
 			URI:         IssueWriteUIResourceURI,
 			Name:        "issue_write_ui",
-			Description: "MCP App UI for creating GitHub issues",
+			Description: "MCP App UI for creating and updating GitHub issues",
 			MIMEType:    "text/html",
 		},
 		func(_ context.Context, _ *mcp.ReadResourceRequest) (*mcp.ReadResourceResult, error) {
-			html := MustGetUIAsset("create-issue.html")
+			html := MustGetUIAsset("issue-write.html")
 			return &mcp.ReadResourceResult{
 				Contents: []*mcp.ResourceContents{
 					{

diff --git a/script/build-ui b/script/build-ui
@@ -17,7 +17,7 @@ npm run build
 echo "Organizing output..."
 mkdir -p dist
 mv dist/src/apps/get-me/index.html dist/get-me.html 2>/dev/null || true
-mv dist/src/apps/create-issue/index.html dist/create-issue.html 2>/dev/null || true
+mv dist/src/apps/issue-write/index.html dist/issue-write.html 2>/dev/null || true
 rm -rf dist/src 2>/dev/null || true
 
 # Copy to Go embed location

diff --git a/ui/package.json b/ui/package.json
@@ -5,9 +5,9 @@
   "type": "module",
   "description": "MCP App UIs for github-mcp-server using Primer React",
   "scripts": {
-    "build": "npm run build:get-me && npm run build:create-issue",
+    "build": "npm run build:get-me && npm run build:issue-write",
     "build:get-me": "APP=get-me vite build",
-    "build:create-issue": "APP=create-issue vite build",
+    "build:issue-write": "APP=issue-write vite build",
     "dev": "npm run build",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"