@oomol-lab/open-connector 1.9.0 → 1.9.2

package/assets/open-connector/catalog/apps/linear_mcp.json

@@ -1,7 +1,7 @@
 {
   "service": "linear_mcp",
   "displayName": "Linear MCP",
-  "description": "Read Linear issues and comments through Linear's official remote MCP server.",
+  "description": "Read Linear issues, comments, teams, projects, workflow states and labels, and create or update issues and comments, through Linear's official remote MCP server.",
   "categories": [
     "Productivity",
     "Developer Tools"
@@ -17,6 +17,9 @@
       "scopes": [
         "read"
       ],
+      "optionalScopes": [
+        "write"
+      ],
       "tokenEndpointAuthMethod": "none",
       "pkce": {
         "method": "S256"
@@ -28,14 +31,315 @@
         "docsUrl": "https://linear.app/docs/mcp",
         "steps": [
           "Copy the Callback URL shown below.",
-          "POST {\"client_name\":\"Open Connector\",\"redirect_uris\":[\"<Callback URL>\"],\"grant_types\":[\"authorization_code\",\"refresh_token\"],\"response_types\":[\"code\"],\"token_endpoint_auth_method\":\"none\",\"scope\":\"read\"} as JSON to https://mcp.linear.app/register.",
-          "Copy the returned client_id into the Client ID field below and leave Client Secret empty."
+          "POST {\"client_name\":\"Open Connector\",\"redirect_uris\":[\"<Callback URL>\"],\"grant_types\":[\"authorization_code\",\"refresh_token\"],\"response_types\":[\"code\"],\"token_endpoint_auth_method\":\"none\",\"scope\":\"read write\"} as JSON to https://mcp.linear.app/register.",
+          "Copy the returned client_id into the Client ID field below and leave Client Secret empty.",
+          "Connect with OAuth. The default grant is read-only; request the write scope as well (requestedScopes) to create or update issues and comments."
         ]
       }
     }
   ],
   "homepageUrl": "https://linear.app/docs/mcp",
   "actions": [
+    {
+      "id": "linear_mcp.create_comment",
+      "service": "linear_mcp",
+      "name": "create_comment",
+      "description": "Comment on a Linear issue through Linear's MCP save_comment tool, optionally as a reply to another comment. Needs the write scope on the grant.",
+      "operationType": "write",
+      "requiredScopes": [
+        "write"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "issueId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Issue ID or human identifier such as ENG-123."
+          },
+          "body": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Comment body in Markdown."
+          },
+          "parentId": {
+            "type": "string",
+            "description": "Comment ID to reply to, for a threaded reply."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "issueId",
+          "body"
+        ],
+        "description": "Fields forwarded to Linear's MCP save_comment tool without an id, which creates the comment."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "comment": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Comment ID."
+                  },
+                  "body": {
+                    "type": "string",
+                    "description": "Comment body in Markdown."
+                  },
+                  "user": {
+                    "type": "string",
+                    "description": "Author name, when returned."
+                  },
+                  "userId": {
+                    "type": "string",
+                    "description": "Author user ID, when the record carries one."
+                  },
+                  "createdAt": {
+                    "type": "string",
+                    "description": "Creation time as returned by Linear."
+                  },
+                  "updatedAt": {
+                    "type": "string",
+                    "description": "Last edit time, when returned."
+                  },
+                  "url": {
+                    "type": "string",
+                    "description": "Link to the comment in Linear."
+                  }
+                },
+                "additionalProperties": true,
+                "required": [
+                  "id"
+                ],
+                "description": "A Linear issue comment."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "A Linear issue comment."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Linear's MCP tool returned. Read it when a typed field is missing: Linear can change its MCP output shape without notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "comment",
+          "raw"
+        ],
+        "description": "The created comment."
+      },
+      "followUpActions": [
+        "linear_mcp.list_comments"
+      ]
+    },
+    {
+      "id": "linear_mcp.create_issue",
+      "service": "linear_mcp",
+      "name": "create_issue",
+      "description": "Create a Linear issue through Linear's MCP save_issue tool. Needs the write scope on the grant; an id in the input is dropped so this never updates an existing issue.",
+      "operationType": "write",
+      "requiredScopes": [
+        "write"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Issue title."
+          },
+          "description": {
+            "type": "string",
+            "description": "Issue description in Markdown."
+          },
+          "team": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Team key, name or ID the issue belongs to."
+          },
+          "assignee": {
+            "type": "string",
+            "description": "Assignee as a user ID, name or email, or me for the signed-in user."
+          },
+          "state": {
+            "type": "string",
+            "description": "Workflow state name or ID."
+          },
+          "priority": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 4,
+            "description": "Priority as Linear numbers it: 0 none, 1 urgent, 2 high, 3 medium, 4 low."
+          },
+          "labels": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "description": "Label names or IDs."
+          },
+          "project": {
+            "type": "string",
+            "description": "Project name or ID."
+          },
+          "dueDate": {
+            "type": "string",
+            "description": "Due date as YYYY-MM-DD."
+          },
+          "parentId": {
+            "type": "string",
+            "description": "Parent issue ID or identifier, for a sub-issue."
+          },
+          "estimate": {
+            "type": "integer",
+            "description": "Estimate on the team's scale."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "title",
+          "team"
+        ],
+        "description": "Fields forwarded to Linear's MCP save_issue tool without an id, which creates the issue. Keys this schema does not name pass through as given and Linear's server validates them."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "issue": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Issue ID as Linear MCP returned it. This may be the human identifier such as ENG-123 rather than the UUID; see identifier and uuid."
+                  },
+                  "identifier": {
+                    "type": "string",
+                    "description": "Human identifier such as ENG-123, when known."
+                  },
+                  "uuid": {
+                    "type": "string",
+                    "description": "Issue UUID, when known."
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "Issue title."
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "Issue description in Markdown. Linear MCP may clip it in lists; see descriptionTruncated."
+                  },
+                  "descriptionTruncated": {
+                    "type": "boolean",
+                    "description": "Whether the description carries Linear's truncation marker. Call get_issue for the full text."
+                  },
+                  "url": {
+                    "type": "string",
+                    "description": "Link to the issue in Linear."
+                  },
+                  "state": {
+                    "type": "string",
+                    "description": "Workflow state name."
+                  },
+                  "priority": {
+                    "description": "Priority as returned: a number or a label."
+                  },
+                  "assignee": {
+                    "type": "string",
+                    "description": "Assignee name, when assigned."
+                  },
+                  "assigneeId": {
+                    "type": "string",
+                    "description": "Assignee user ID, when the record carries one."
+                  },
+                  "creator": {
+                    "type": "string",
+                    "description": "Creator name, when returned."
+                  },
+                  "creatorId": {
+                    "type": "string",
+                    "description": "Creator user ID, when the record carries one."
+                  },
+                  "team": {
+                    "type": "string",
+                    "description": "Team name or key."
+                  },
+                  "project": {
+                    "type": "string",
+                    "description": "Project name, when the issue belongs to one."
+                  },
+                  "labels": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "description": "Label names."
+                  },
+                  "createdAt": {
+                    "type": "string",
+                    "description": "Creation time as returned by Linear."
+                  },
+                  "updatedAt": {
+                    "type": "string",
+                    "description": "Last update time as returned by Linear."
+                  },
+                  "archivedAt": {
+                    "type": "string",
+                    "description": "Archive time, when archived."
+                  },
+                  "completedAt": {
+                    "type": "string",
+                    "description": "Completion time, when completed."
+                  },
+                  "dueDate": {
+                    "type": "string",
+                    "description": "Due date, when set."
+                  }
+                },
+                "additionalProperties": true,
+                "required": [
+                  "id"
+                ],
+                "description": "A Linear issue. Typed fields are lifted from the MCP record when present; fields not listed here are only in the action's raw text."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "A Linear issue. Typed fields are lifted from the MCP record when present; fields not listed here are only in the action's raw text."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Linear's MCP tool returned. Read it when a typed field is missing: Linear can change its MCP output shape without notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "issue",
+          "raw"
+        ],
+        "description": "The created issue."
+      },
+      "followUpActions": [
+        "linear_mcp.get_issue",
+        "linear_mcp.create_comment"
+      ]
+    },
     {
       "id": "linear_mcp.get_issue",
       "service": "linear_mcp",
@@ -334,10 +638,10 @@
       }
     },
     {
-      "id": "linear_mcp.list_issues",
+      "id": "linear_mcp.list_issue_labels",
       "service": "linear_mcp",
-      "name": "list_issues",
-      "description": "List Linear issues through Linear's MCP list_issues tool with optional updated-since, ordering, limit, and cursor pagination. Descriptions may be clipped; call get_issue for the full text.",
+      "name": "list_issue_labels",
+      "description": "List issue labels through Linear's MCP list_issue_labels tool, for the workspace or one team.",
       "operationType": "read",
       "requiredScopes": [
         "read"
@@ -346,24 +650,189 @@
       "inputSchema": {
         "type": "object",
         "properties": {
-          "updatedAt": {
-            "type": "string",
-            "description": "Only issues updated at or after this time, as the tool accepts it (an ISO 8601 timestamp or a relative duration such as -P1D)."
-          },
-          "orderBy": {
-            "type": "string",
-            "description": "Sort field, such as updatedAt or createdAt."
-          },
-          "limit": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 250,
-            "description": "Maximum number of issues to return on this page."
-          },
-          "cursor": {
+          "team": {
             "type": "string",
             "minLength": 1,
-            "description": "Cursor returned by the previous page of the same query."
+            "description": "Team key, name or ID; omitted, the workspace's labels."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Optional team filter."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "labels": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Record ID as Linear MCP returned it."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Display name."
+                },
+                "key": {
+                  "type": "string",
+                  "description": "Team key such as ENG, when the record is a team."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "Workflow state type such as started or completed, when the record is a state."
+                },
+                "color": {
+                  "type": "string",
+                  "description": "Color, when the record is a label."
+                },
+                "url": {
+                  "type": "string",
+                  "description": "Link to the record in Linear, when returned."
+                },
+                "state": {
+                  "type": "string",
+                  "description": "Project state, when the record is a project."
+                }
+              },
+              "additionalProperties": true,
+              "required": [
+                "id"
+              ],
+              "description": "A team, project, workflow state or label as Linear MCP lists it. Typed fields are lifted when present; the rest is only in the action's raw text."
+            },
+            "description": "Labels as returned."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Linear's MCP tool returned. Read it when a typed field is missing: Linear can change its MCP output shape without notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "labels",
+          "raw"
+        ],
+        "description": "The labels."
+      }
+    },
+    {
+      "id": "linear_mcp.list_issue_statuses",
+      "service": "linear_mcp",
+      "name": "list_issue_statuses",
+      "description": "List one team's workflow states through Linear's MCP list_issue_statuses tool: the names the issue tools take as state.",
+      "operationType": "read",
+      "requiredScopes": [
+        "read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "team": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Team key, name or ID."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "team"
+        ],
+        "description": "The team whose workflow states to list."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "statuses": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Record ID as Linear MCP returned it."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Display name."
+                },
+                "key": {
+                  "type": "string",
+                  "description": "Team key such as ENG, when the record is a team."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "Workflow state type such as started or completed, when the record is a state."
+                },
+                "color": {
+                  "type": "string",
+                  "description": "Color, when the record is a label."
+                },
+                "url": {
+                  "type": "string",
+                  "description": "Link to the record in Linear, when returned."
+                },
+                "state": {
+                  "type": "string",
+                  "description": "Project state, when the record is a project."
+                }
+              },
+              "additionalProperties": true,
+              "required": [
+                "id"
+              ],
+              "description": "A team, project, workflow state or label as Linear MCP lists it. Typed fields are lifted when present; the rest is only in the action's raw text."
+            },
+            "description": "States as returned."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Linear's MCP tool returned. Read it when a typed field is missing: Linear can change its MCP output shape without notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "statuses",
+          "raw"
+        ],
+        "description": "The workflow states."
+      }
+    },
+    {
+      "id": "linear_mcp.list_issues",
+      "service": "linear_mcp",
+      "name": "list_issues",
+      "description": "List Linear issues through Linear's MCP list_issues tool with optional updated-since, ordering, limit, and cursor pagination. Descriptions may be clipped; call get_issue for the full text.",
+      "operationType": "read",
+      "requiredScopes": [
+        "read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "updatedAt": {
+            "type": "string",
+            "description": "Only issues updated at or after this time, as the tool accepts it (an ISO 8601 timestamp or a relative duration such as -P1D)."
+          },
+          "orderBy": {
+            "type": "string",
+            "description": "Sort field, such as updatedAt or createdAt."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 250,
+            "description": "Maximum number of issues to return on this page."
+          },
+          "cursor": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Cursor returned by the previous page of the same query."
           }
         },
         "additionalProperties": false,
@@ -508,6 +977,397 @@
         "linear_mcp.get_issue",
         "linear_mcp.list_comments"
       ]
+    },
+    {
+      "id": "linear_mcp.list_projects",
+      "service": "linear_mcp",
+      "name": "list_projects",
+      "description": "List Linear projects through Linear's MCP list_projects tool, optionally for one team, with cursor pagination.",
+      "operationType": "read",
+      "requiredScopes": [
+        "read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "team": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Team key, name or ID whose projects to list."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 250,
+            "description": "Maximum number of projects to return on this page."
+          },
+          "cursor": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Cursor returned by the previous page of the same query."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Filters forwarded to Linear's MCP list_projects tool. Keys this schema does not name pass through as given."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "projects": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Record ID as Linear MCP returned it."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Display name."
+                },
+                "key": {
+                  "type": "string",
+                  "description": "Team key such as ENG, when the record is a team."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "Workflow state type such as started or completed, when the record is a state."
+                },
+                "color": {
+                  "type": "string",
+                  "description": "Color, when the record is a label."
+                },
+                "url": {
+                  "type": "string",
+                  "description": "Link to the record in Linear, when returned."
+                },
+                "state": {
+                  "type": "string",
+                  "description": "Project state, when the record is a project."
+                }
+              },
+              "additionalProperties": true,
+              "required": [
+                "id"
+              ],
+              "description": "A team, project, workflow state or label as Linear MCP lists it. Typed fields are lifted when present; the rest is only in the action's raw text."
+            },
+            "description": "Projects on this page."
+          },
+          "hasNextPage": {
+            "type": "boolean",
+            "description": "Whether another page follows."
+          },
+          "cursor": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "Cursor for the next page, when one is available."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Cursor for the next page, when one is available."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Linear's MCP tool returned. Read it when a typed field is missing: Linear can change its MCP output shape without notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "projects",
+          "hasNextPage",
+          "cursor",
+          "raw"
+        ],
+        "description": "One page of projects."
+      }
+    },
+    {
+      "id": "linear_mcp.list_teams",
+      "service": "linear_mcp",
+      "name": "list_teams",
+      "description": "List the teams of the connected Linear workspace through Linear's MCP list_teams tool: the keys and IDs the issue tools take as team.",
+      "operationType": "read",
+      "requiredScopes": [
+        "read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "teams": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Record ID as Linear MCP returned it."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Display name."
+                },
+                "key": {
+                  "type": "string",
+                  "description": "Team key such as ENG, when the record is a team."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "Workflow state type such as started or completed, when the record is a state."
+                },
+                "color": {
+                  "type": "string",
+                  "description": "Color, when the record is a label."
+                },
+                "url": {
+                  "type": "string",
+                  "description": "Link to the record in Linear, when returned."
+                },
+                "state": {
+                  "type": "string",
+                  "description": "Project state, when the record is a project."
+                }
+              },
+              "additionalProperties": true,
+              "required": [
+                "id"
+              ],
+              "description": "A team, project, workflow state or label as Linear MCP lists it. Typed fields are lifted when present; the rest is only in the action's raw text."
+            },
+            "description": "Teams as returned."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Linear's MCP tool returned. Read it when a typed field is missing: Linear can change its MCP output shape without notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "teams",
+          "raw"
+        ],
+        "description": "The teams."
+      },
+      "followUpActions": [
+        "linear_mcp.list_issue_statuses",
+        "linear_mcp.list_issue_labels",
+        "linear_mcp.create_issue"
+      ]
+    },
+    {
+      "id": "linear_mcp.update_issue",
+      "service": "linear_mcp",
+      "name": "update_issue",
+      "description": "Update a Linear issue through Linear's MCP save_issue tool with its id: the title, description, team, assignee, state, priority, labels, project, due date, parent or estimate. Needs the write scope on the grant.",
+      "operationType": "write",
+      "requiredScopes": [
+        "write"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Issue ID or human identifier such as ENG-123, as returned by list_issues."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Issue title."
+          },
+          "description": {
+            "type": "string",
+            "description": "Issue description in Markdown."
+          },
+          "team": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Team key, name or ID the issue belongs to."
+          },
+          "assignee": {
+            "type": "string",
+            "description": "Assignee as a user ID, name or email, or me for the signed-in user."
+          },
+          "state": {
+            "type": "string",
+            "description": "Workflow state name or ID."
+          },
+          "priority": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 4,
+            "description": "Priority as Linear numbers it: 0 none, 1 urgent, 2 high, 3 medium, 4 low."
+          },
+          "labels": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "description": "Label names or IDs."
+          },
+          "project": {
+            "type": "string",
+            "description": "Project name or ID."
+          },
+          "dueDate": {
+            "type": "string",
+            "description": "Due date as YYYY-MM-DD."
+          },
+          "parentId": {
+            "type": "string",
+            "description": "Parent issue ID or identifier, for a sub-issue."
+          },
+          "estimate": {
+            "type": "integer",
+            "description": "Estimate on the team's scale."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "id"
+        ],
+        "description": "Fields forwarded to Linear's MCP save_issue tool with an id, which updates the issue. Only the fields given change; keys this schema does not name pass through as given."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "issue": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Issue ID as Linear MCP returned it. This may be the human identifier such as ENG-123 rather than the UUID; see identifier and uuid."
+                  },
+                  "identifier": {
+                    "type": "string",
+                    "description": "Human identifier such as ENG-123, when known."
+                  },
+                  "uuid": {
+                    "type": "string",
+                    "description": "Issue UUID, when known."
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "Issue title."
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "Issue description in Markdown. Linear MCP may clip it in lists; see descriptionTruncated."
+                  },
+                  "descriptionTruncated": {
+                    "type": "boolean",
+                    "description": "Whether the description carries Linear's truncation marker. Call get_issue for the full text."
+                  },
+                  "url": {
+                    "type": "string",
+                    "description": "Link to the issue in Linear."
+                  },
+                  "state": {
+                    "type": "string",
+                    "description": "Workflow state name."
+                  },
+                  "priority": {
+                    "description": "Priority as returned: a number or a label."
+                  },
+                  "assignee": {
+                    "type": "string",
+                    "description": "Assignee name, when assigned."
+                  },
+                  "assigneeId": {
+                    "type": "string",
+                    "description": "Assignee user ID, when the record carries one."
+                  },
+                  "creator": {
+                    "type": "string",
+                    "description": "Creator name, when returned."
+                  },
+                  "creatorId": {
+                    "type": "string",
+                    "description": "Creator user ID, when the record carries one."
+                  },
+                  "team": {
+                    "type": "string",
+                    "description": "Team name or key."
+                  },
+                  "project": {
+                    "type": "string",
+                    "description": "Project name, when the issue belongs to one."
+                  },
+                  "labels": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "description": "Label names."
+                  },
+                  "createdAt": {
+                    "type": "string",
+                    "description": "Creation time as returned by Linear."
+                  },
+                  "updatedAt": {
+                    "type": "string",
+                    "description": "Last update time as returned by Linear."
+                  },
+                  "archivedAt": {
+                    "type": "string",
+                    "description": "Archive time, when archived."
+                  },
+                  "completedAt": {
+                    "type": "string",
+                    "description": "Completion time, when completed."
+                  },
+                  "dueDate": {
+                    "type": "string",
+                    "description": "Due date, when set."
+                  }
+                },
+                "additionalProperties": true,
+                "required": [
+                  "id"
+                ],
+                "description": "A Linear issue. Typed fields are lifted from the MCP record when present; fields not listed here are only in the action's raw text."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "A Linear issue. Typed fields are lifted from the MCP record when present; fields not listed here are only in the action's raw text."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Linear's MCP tool returned. Read it when a typed field is missing: Linear can change its MCP output shape without notice."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "issue",
+          "raw"
+        ],
+        "description": "The updated issue."
+      },
+      "followUpActions": [
+        "linear_mcp.get_issue"
+      ]
     }
   ]
 }