@snokam/mcp-api 2.15.1 → 2.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "2.15.1",
+  "version": "2.16.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

@@ -1565,6 +1565,79 @@
         ]
       }
     },
+    "/v1.0/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Batch-refresh the cached Salesforce state on every linked Snøkam tender.",
+        "operationId": "RefreshAllSalesforceLinks",
+        "responses": {
+          "200": {
+            "description": "Payload of SalesforceRefreshResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/salesforceRefreshResult"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/salesforce/opportunities/{sfId}/import": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Snøkam tender stub from an existing Salesforce Opportunity.",
+        "operationId": "ImportSalesforceOpportunity",
+        "parameters": [
+          {
+            "name": "sfId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Salesforce Opportunity Id."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "A tender is already linked to this Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/{id}/salesforce": {
       "post": {
         "tags": [
@@ -1969,6 +2042,97 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/reingest": {
+      "post": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Re-run the ingestion pipeline on an existing tender, re-parsing documents and refreshing AI match / summary / classification.",
+        "operationId": "ReingestTender",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/agentJob"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/jobs": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Recent agent jobs (ingestion, CV matching, …) for a tender — newest first.",
+        "operationId": "ListTenderJobs",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "x-ms-summary": "Max rows (default 10, capped at 100)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/agentJob"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/admin/tenders": {
       "delete": {
         "tags": [
@@ -3106,6 +3270,19 @@
         },
         "nullable": true
       },
+      "salesforceRefreshResult": {
+        "type": "object",
+        "properties": {
+          "checked": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "updated": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
       "sourceFile": {
         "type": "object",
         "properties": {

package/specs/test/sales.json

@@ -1565,6 +1565,79 @@
         ]
       }
     },
+    "/v1.0/salesforce/refresh": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Batch-refresh the cached Salesforce state on every linked Snøkam tender.",
+        "operationId": "RefreshAllSalesforceLinks",
+        "responses": {
+          "200": {
+            "description": "Payload of SalesforceRefreshResult",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/salesforceRefreshResult"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/salesforce/opportunities/{sfId}/import": {
+      "post": {
+        "tags": [
+          "Salesforce"
+        ],
+        "summary": "Create a Snøkam tender stub from an existing Salesforce Opportunity.",
+        "operationId": "ImportSalesforceOpportunity",
+        "parameters": [
+          {
+            "name": "sfId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "Salesforce Opportunity Id."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Tender",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tender"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "409": {
+            "description": "A tender is already linked to this Opportunity."
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/{id}/salesforce": {
       "post": {
         "tags": [
@@ -1969,6 +2042,97 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/reingest": {
+      "post": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Re-run the ingestion pipeline on an existing tender, re-parsing documents and refreshing AI match / summary / classification.",
+        "operationId": "ReingestTender",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/agentJob"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/{id}/jobs": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Recent agent jobs (ingestion, CV matching, …) for a tender — newest first.",
+        "operationId": "ListTenderJobs",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "x-ms-summary": "Max rows (default 10, capped at 100)."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Array of AgentJob",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/agentJob"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/admin/tenders": {
       "delete": {
         "tags": [
@@ -3106,6 +3270,19 @@
         },
         "nullable": true
       },
+      "salesforceRefreshResult": {
+        "type": "object",
+        "properties": {
+          "checked": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "updated": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
       "sourceFile": {
         "type": "object",
         "properties": {