@snokam/mcp-api 2.14.0 → 2.15.1

package/package.json

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

package/specs/production/employees.json

@@ -1042,6 +1042,10 @@
             "type": "boolean",
             "nullable": true
           },
+          "isSeekingProject": {
+            "type": "boolean",
+            "nullable": true
+          },
           "manager": {
             "$ref": "#/components/schemas/employeeReference"
           },
@@ -1065,6 +1069,9 @@
             "format": "double",
             "nullable": true
           },
+          "personalProjectRequirements": {
+            "type": "string"
+          },
           "position": {
             "type": "string"
           },
@@ -1201,6 +1208,9 @@
           "isBot": {
             "type": "boolean"
           },
+          "isSeekingProject": {
+            "type": "boolean"
+          },
           "manager": {
             "$ref": "#/components/schemas/sanityEmployeeManager"
           },
@@ -1223,6 +1233,9 @@
             "type": "number",
             "format": "double"
           },
+          "personalProjectRequirements": {
+            "type": "string"
+          },
           "position": {
             "type": "string"
           },

package/specs/production/sales.json

@@ -1515,6 +1515,141 @@
         ]
       }
     },
+    "/v1.0/salesforce/opportunities": {
+      "get": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "List Salesforce Opportunities (open by default).",
+        "operationId": "ListSalesforceOpportunities",
+        "parameters": [
+          {
+            "name": "includeClosed",
+            "in": "query",
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Include closed opportunities (default false)."
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "x-ms-summary": "Row cap, max 200 (default 100)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SalesforceOpportunity",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/salesforceOpportunity"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Salesforce Opportunity from a Snøkam tender and cache the link.",
+        "operationId": "PromoteTenderToSalesforce",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "Tender is already linked to a Salesforce Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Re-sync cached Salesforce Opportunity state (stage / closed / won) onto the tender.",
+        "operationId": "RefreshTenderSalesforceLink",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/stats": {
       "get": {
         "tags": [
@@ -2895,6 +3030,82 @@
         },
         "nullable": true
       },
+      "salesforceAttributes": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "nullable": true
+          },
+          "url": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
+      "salesforceOpportunity": {
+        "type": "object",
+        "properties": {
+          "attributes": {
+            "$ref": "#/components/schemas/salesforceAttributes"
+          },
+          "Id": {
+            "type": "string",
+            "nullable": true
+          },
+          "Name": {
+            "type": "string",
+            "nullable": true
+          },
+          "StageName": {
+            "type": "string",
+            "nullable": true
+          },
+          "CloseDate": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "IsClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "IsWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "Amount": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "Account": {
+            "$ref": "#/components/schemas/salesforceReference"
+          },
+          "Owner": {
+            "$ref": "#/components/schemas/salesforceReference"
+          },
+          "Snokam_Tender_Id__c": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "salesforceReference": {
+        "type": "object",
+        "properties": {
+          "Name": {
+            "type": "string",
+            "nullable": true
+          },
+          "Id": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
       "sourceFile": {
         "type": "object",
         "properties": {
@@ -3005,6 +3216,9 @@
           "blobContainer": {
             "type": "string",
             "nullable": true
+          },
+          "salesforce": {
+            "$ref": "#/components/schemas/tenderSalesforce"
           }
         }
       },
@@ -3263,6 +3477,37 @@
         },
         "nullable": true
       },
+      "tenderSalesforce": {
+        "type": "object",
+        "properties": {
+          "opportunityId": {
+            "type": "string",
+            "nullable": true
+          },
+          "stageName": {
+            "type": "string",
+            "nullable": true
+          },
+          "isClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "isWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "url": {
+            "type": "string",
+            "nullable": true
+          },
+          "lastSyncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
       "tenderSource": {
         "type": "object",
         "properties": {

package/specs/test/employees.json

@@ -1042,6 +1042,10 @@
             "type": "boolean",
             "nullable": true
           },
+          "isSeekingProject": {
+            "type": "boolean",
+            "nullable": true
+          },
           "manager": {
             "$ref": "#/components/schemas/employeeReference"
           },
@@ -1065,6 +1069,9 @@
             "format": "double",
             "nullable": true
           },
+          "personalProjectRequirements": {
+            "type": "string"
+          },
           "position": {
             "type": "string"
           },
@@ -1201,6 +1208,9 @@
           "isBot": {
             "type": "boolean"
           },
+          "isSeekingProject": {
+            "type": "boolean"
+          },
           "manager": {
             "$ref": "#/components/schemas/sanityEmployeeManager"
           },
@@ -1223,6 +1233,9 @@
             "type": "number",
             "format": "double"
           },
+          "personalProjectRequirements": {
+            "type": "string"
+          },
           "position": {
             "type": "string"
           },

package/specs/test/sales.json

@@ -1515,6 +1515,141 @@
         ]
       }
     },
+    "/v1.0/salesforce/opportunities": {
+      "get": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "List Salesforce Opportunities (open by default).",
+        "operationId": "ListSalesforceOpportunities",
+        "parameters": [
+          {
+            "name": "includeClosed",
+            "in": "query",
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Include closed opportunities (default false)."
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "x-ms-summary": "Row cap, max 200 (default 100)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of SalesforceOpportunity",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/salesforceOpportunity"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Salesforce Opportunity from a Snøkam tender and cache the link.",
+        "operationId": "PromoteTenderToSalesforce",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "Tender is already linked to a Salesforce Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Re-sync cached Salesforce Opportunity state (stage / closed / won) onto the tender.",
+        "operationId": "RefreshTenderSalesforceLink",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/stats": {
       "get": {
         "tags": [
@@ -2895,6 +3030,82 @@
         },
         "nullable": true
       },
+      "salesforceAttributes": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "nullable": true
+          },
+          "url": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
+      "salesforceOpportunity": {
+        "type": "object",
+        "properties": {
+          "attributes": {
+            "$ref": "#/components/schemas/salesforceAttributes"
+          },
+          "Id": {
+            "type": "string",
+            "nullable": true
+          },
+          "Name": {
+            "type": "string",
+            "nullable": true
+          },
+          "StageName": {
+            "type": "string",
+            "nullable": true
+          },
+          "CloseDate": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "IsClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "IsWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "Amount": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "Account": {
+            "$ref": "#/components/schemas/salesforceReference"
+          },
+          "Owner": {
+            "$ref": "#/components/schemas/salesforceReference"
+          },
+          "Snokam_Tender_Id__c": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "salesforceReference": {
+        "type": "object",
+        "properties": {
+          "Name": {
+            "type": "string",
+            "nullable": true
+          },
+          "Id": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
       "sourceFile": {
         "type": "object",
         "properties": {
@@ -3005,6 +3216,9 @@
           "blobContainer": {
             "type": "string",
             "nullable": true
+          },
+          "salesforce": {
+            "$ref": "#/components/schemas/tenderSalesforce"
           }
         }
       },
@@ -3263,6 +3477,37 @@
         },
         "nullable": true
       },
+      "tenderSalesforce": {
+        "type": "object",
+        "properties": {
+          "opportunityId": {
+            "type": "string",
+            "nullable": true
+          },
+          "stageName": {
+            "type": "string",
+            "nullable": true
+          },
+          "isClosed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "isWon": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "url": {
+            "type": "string",
+            "nullable": true
+          },
+          "lastSyncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        },
+        "nullable": true
+      },
       "tenderSource": {
         "type": "object",
         "properties": {