@snokam/mcp-api 2.22.0 → 2.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "2.22.0",
+  "version": "2.24.0",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {

package/specs/production/sales.json

@@ -1695,6 +1695,37 @@
         ]
       }
     },
+    "/v1.0/salesforce/opportunity-stages": {
+      "get": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "List the SF org's Opportunity pipeline stages in configured order.",
+        "operationId": "ListSalesforceOpportunityStages",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SalesforceOpportunityStage",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/salesforceOpportunityStage"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/salesforce/refresh": {
       "post": {
         "tags": [
@@ -1723,6 +1754,61 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/salesforce/stage": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Move the linked SF Opportunity to a new stage and refresh the cache.",
+        "operationId": "UpdateTenderSalesforceStage",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "The SF stage masterLabel/apiName to switch to.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/updateSalesforceStageRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Tender has no Salesforce link, or stageName is missing."
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/salesforce/opportunities/{sfId}/import": {
       "post": {
         "tags": [
@@ -3586,6 +3672,36 @@
           }
         }
       },
+      "salesforceOpportunityStage": {
+        "type": "object",
+        "properties": {
+          "MasterLabel": {
+            "type": "string",
+            "nullable": true
+          },
+          "ApiName": {
+            "type": "string",
+            "nullable": true
+          },
+          "IsActive": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "IsClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "IsWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "SortOrder": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          }
+        }
+      },
       "salesforceReference": {
         "type": "object",
         "properties": {
@@ -4262,6 +4378,14 @@
           }
         }
       },
+      "updateSalesforceStageRequest": {
+        "type": "object",
+        "properties": {
+          "stageName": {
+            "type": "string"
+          }
+        }
+      },
       "zombieReapResult": {
         "type": "object",
         "properties": {

package/specs/test/sales.json

@@ -1695,6 +1695,37 @@
         ]
       }
     },
+    "/v1.0/salesforce/opportunity-stages": {
+      "get": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "List the SF org's Opportunity pipeline stages in configured order.",
+        "operationId": "ListSalesforceOpportunityStages",
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SalesforceOpportunityStage",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/salesforceOpportunityStage"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/salesforce/refresh": {
       "post": {
         "tags": [
@@ -1723,6 +1754,61 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/salesforce/stage": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Move the linked SF Opportunity to a new stage and refresh the cache.",
+        "operationId": "UpdateTenderSalesforceStage",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "The SF stage masterLabel/apiName to switch to.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/updateSalesforceStageRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Tender has no Salesforce link, or stageName is missing."
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/salesforce/opportunities/{sfId}/import": {
       "post": {
         "tags": [
@@ -3586,6 +3672,36 @@
           }
         }
       },
+      "salesforceOpportunityStage": {
+        "type": "object",
+        "properties": {
+          "MasterLabel": {
+            "type": "string",
+            "nullable": true
+          },
+          "ApiName": {
+            "type": "string",
+            "nullable": true
+          },
+          "IsActive": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "IsClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "IsWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "SortOrder": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          }
+        }
+      },
       "salesforceReference": {
         "type": "object",
         "properties": {
@@ -4262,6 +4378,14 @@
           }
         }
       },
+      "updateSalesforceStageRequest": {
+        "type": "object",
+        "properties": {
+          "stageName": {
+            "type": "string"
+          }
+        }
+      },
       "zombieReapResult": {
         "type": "object",
         "properties": {