fmea-api-mcp-server 1.1.46 → 1.1.47

package/endpoints/v2/worksheets/management.json

@@ -6,13 +6,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets/failuremode/{failureModeId}",
       "method": "GET",
-      "summary": "Get worksheet by failure mode",
-      "description": "Fetches the complete worksheet data associated with a specific failure mode within a project. Use this endpoint to retrieve, load, or view detailed failure mode analysis worksheets including RPN calculations, risk assessments, and mitigation strategies. This is essential for reviewing existing failure mode documentation, conducting quality audits, or preparing data for editing operations. The endpoint returns structured worksheet content that can be used for analysis, reporting, or further modification through the update endpoint.",
-      "tags": [],
+      "summary": "Get worksheet by failure mode ID",
+      "description": "Returns the worksheet associated with the specified failure mode within the given project. Returns the worksheet DTO including S/O/D data and all worksheet rows. Requires NORMAL user level.",
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID the failure mode belongs to",
           "required": true,
           "schema": {
             "type": "string"
@@ -21,6 +24,7 @@
         {
           "name": "failureModeId",
           "in": "path",
+          "description": "Failure mode ID to retrieve the associated worksheet for",
           "required": true,
           "schema": {
             "type": "string"
@@ -58,13 +62,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets/failuremode/{failureModeId}",
       "method": "POST",
-      "summary": "Create worksheet by failure mode",
-      "description": "Generates a new worksheet for a specific failure mode within a project. Use this endpoint to initialize, set up, or create failure mode analysis worksheets. This operation establishes a structured worksheet template linked to the identified failure mode, optionally associating it with a block diagram via the blockDiagramId query parameter. Essential for starting new failure mode analyses, initiating risk assessment workflows, or expanding project documentation coverage. The created worksheet provides a framework for capturing RPN calculations, failure effects, causes, and recommended actions.",
-      "tags": [],
+      "summary": "Create worksheet row for a failure mode",
+      "description": "Creates a new worksheet row linked to the specified failure mode within the project. Optionally associates the row with a block diagram node via blockDiagramId. Returns HTTP 201 Created with the created worksheet row DTO. Requires NORMAL user level and project MEMBER role.",
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID the failure mode belongs to",
           "required": true,
           "schema": {
             "type": "string"
@@ -73,6 +80,7 @@
         {
           "name": "failureModeId",
           "in": "path",
+          "description": "Failure mode ID to create a worksheet row for",
           "required": true,
           "schema": {
             "type": "string"
@@ -81,6 +89,7 @@
         {
           "name": "blockDiagramId",
           "in": "query",
+          "description": "Optional block diagram node ID to associate with the new worksheet row",
           "schema": {
             "type": "string"
           }
@@ -127,11 +136,14 @@
       "method": "GET",
       "summary": "Get worksheet headers",
       "description": "Returns worksheet headers copied for the worksheet. When search is provided, keyword matching is applied.",
-      "tags": [],
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID the worksheet belongs to",
           "required": true,
           "schema": {
             "type": "string"
@@ -140,6 +152,7 @@
         {
           "name": "reportNo",
           "in": "path",
+          "description": "Worksheet report number (primary, e.g. '3')",
           "required": true,
           "schema": {
             "type": "string"
@@ -237,13 +250,16 @@
     {
       "path": "/api/v2/projects/{projectId}/worksheets/{reportNo}/{failureModeId}",
       "method": "PUT",
-      "summary": "Save worksheet by failure mode",
-      "description": "Updates and persists worksheet data for a specific failure mode within a designated report. Use this endpoint to save, modify, edit, or update failure mode analysis content including severity ratings, occurrence probabilities, detection rankings, RPN calculations, recommended actions, and status tracking. This operation overwrites existing data with the provided FailureModeWorksheetSaveDTO payload, ensuring data persistence and version control. Essential for recording analysis progress, updating risk assessments after reviews, documenting corrective actions, or maintaining live risk evaluation data. Requires project member role authentication and supports iterative refinement of failure mode analyses throughout the project lifecycle.",
-      "tags": [],
+      "summary": "Save worksheet data for a specific failure mode",
+      "description": "Saves worksheet content for the worksheet row associated with the given failure mode. The report number identifies the worksheet; the failure mode ID identifies the row. Requires NORMAL user level and project MEMBER role.",
+      "tags": [
+        "Worksheet"
+      ],
       "parameters": [
         {
           "name": "projectId",
           "in": "path",
+          "description": "Project ID the worksheet belongs to",
           "required": true,
           "schema": {
             "type": "string"
@@ -252,6 +268,7 @@
         {
           "name": "reportNo",
           "in": "path",
+          "description": "Worksheet report number (primary, e.g. '3')",
           "required": true,
           "schema": {
             "type": "string"
@@ -260,6 +277,7 @@
         {
           "name": "failureModeId",
           "in": "path",
+          "description": "Failure mode ID whose worksheet row will be updated",
           "required": true,
           "schema": {
             "type": "string"

package/endpoints/v2/worksheets/templates.json

@@ -8,11 +8,14 @@
       "method": "GET",
       "summary": "Get worksheet template headers",
       "description": "Returns worksheet template headers. When search is provided, keyword matching is applied.",
-      "tags": [],
+      "tags": [
+        "Worksheet Templates"
+      ],
       "parameters": [
         {
           "name": "id",
           "in": "path",
+          "description": "Worksheet template ID",
           "required": true,
           "schema": {
             "type": "integer",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fmea-api-mcp-server",
-  "version": "1.1.46",
+  "version": "1.1.47",
   "description": "MCP server for serving API documentation from endpoints directory",
   "type": "module",
   "main": "dist/index.js",