@snokam/mcp-api 2.16.0 → 2.17.0

package/package.json

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

@@ -447,6 +447,112 @@
         ]
       }
     },
+    "/v1.0/tenders/funnel": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Pipeline funnel analytics: stage counts, conversion rates, cycle times",
+        "operationId": "GetTenderFunnel",
+        "parameters": [
+          {
+            "name": "windowDays",
+            "in": "query",
+            "description": "Rolling window in days (default 30, max 365)",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of FunnelResponse",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/funnelResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/stats": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Aggregated tender KPIs for the admin dashboard (by status/stage/health + activity window)",
+        "operationId": "GetTenderStats",
+        "parameters": [
+          {
+            "name": "windowDays",
+            "in": "query",
+            "description": "Rolling window for activity-based metrics (defaults to 30, max 365)",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of TenderStatsResponse",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tenderStatsResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/consultants/stats": {
+      "get": {
+        "tags": [
+          "Consultants"
+        ],
+        "summary": "Aggregated consultant KPIs (total, availability split, avg fit score from latest matches)",
+        "operationId": "GetConsultantStats",
+        "responses": {
+          "200": {
+            "description": "Payload of ConsultantStatsResponse",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/consultantStatsResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/crawl/sources": {
       "get": {
         "tags": [
@@ -1436,45 +1542,6 @@
         ]
       }
     },
-    "/v1.0/tenders/funnel": {
-      "get": {
-        "tags": [
-          "Tenders"
-        ],
-        "summary": "Pipeline funnel analytics: stage counts, conversion rates, cycle times",
-        "operationId": "GetTenderFunnel",
-        "parameters": [
-          {
-            "name": "windowDays",
-            "in": "query",
-            "description": "Rolling window in days (default 30, max 365)",
-            "schema": {
-              "type": "integer",
-              "format": "int32"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Payload of FunnelResponse",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/funnelResponse"
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
-            ]
-          }
-        ]
-      }
-    },
     "/v1.0/realtime/negotiate": {
       "post": {
         "tags": [
@@ -1515,6 +1582,69 @@
         ]
       }
     },
+    "/v1.0/stream": {
+      "get": {
+        "tags": [
+          "Realtime"
+        ],
+        "summary": "Unified SSE stream: tender/job/crawl/consultant/audit events on one connection",
+        "operationId": "StreamAll",
+        "parameters": [
+          {
+            "name": "channels",
+            "in": "query",
+            "description": "Comma-separated namespaces to include (tender,job,crawl,consultant,audit). Default: all.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {},
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/stream-redirect": {
+      "get": {
+        "tags": [
+          "Realtime"
+        ],
+        "summary": "Deprecated: redirects to /v1.0/stream?channels=tender,job",
+        "operationId": "DeprecatedTenderStream",
+        "responses": {},
+        "deprecated": true,
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/crawl/stream-redirect": {
+      "get": {
+        "tags": [
+          "Realtime"
+        ],
+        "summary": "Deprecated: redirects to /v1.0/stream?channels=crawl,job",
+        "operationId": "DeprecatedCrawlStream",
+        "responses": {},
+        "deprecated": true,
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/salesforce/opportunities": {
       "get": {
         "tags": [
@@ -1723,136 +1853,6 @@
         ]
       }
     },
-    "/v1.0/tenders/stats": {
-      "get": {
-        "tags": [
-          "Tenders"
-        ],
-        "summary": "Aggregated tender KPIs for the admin dashboard (by status/stage/health + activity window)",
-        "operationId": "GetTenderStats",
-        "parameters": [
-          {
-            "name": "windowDays",
-            "in": "query",
-            "description": "Rolling window for activity-based metrics (defaults to 30, max 365)",
-            "schema": {
-              "type": "integer",
-              "format": "int32"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Payload of TenderStatsResponse",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/tenderStatsResponse"
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/consultants/stats": {
-      "get": {
-        "tags": [
-          "Consultants"
-        ],
-        "summary": "Aggregated consultant KPIs (total, availability split, avg fit score from latest matches)",
-        "operationId": "GetConsultantStats",
-        "responses": {
-          "200": {
-            "description": "Payload of ConsultantStatsResponse",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/consultantStatsResponse"
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/stream": {
-      "get": {
-        "tags": [
-          "Realtime"
-        ],
-        "summary": "Unified SSE stream: tender/job/crawl/consultant/audit events on one connection",
-        "operationId": "StreamAll",
-        "parameters": [
-          {
-            "name": "channels",
-            "in": "query",
-            "description": "Comma-separated namespaces to include (tender,job,crawl,consultant,audit). Default: all.",
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {},
-        "security": [
-          {
-            "Implicit": [
-              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/tenders/stream-redirect": {
-      "get": {
-        "tags": [
-          "Realtime"
-        ],
-        "summary": "Deprecated: redirects to /v1.0/stream?channels=tender,job",
-        "operationId": "DeprecatedTenderStream",
-        "responses": {},
-        "deprecated": true,
-        "security": [
-          {
-            "Implicit": [
-              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/crawl/stream-redirect": {
-      "get": {
-        "tags": [
-          "Realtime"
-        ],
-        "summary": "Deprecated: redirects to /v1.0/stream?channels=crawl,job",
-        "operationId": "DeprecatedCrawlStream",
-        "responses": {},
-        "deprecated": true,
-        "security": [
-          {
-            "Implicit": [
-              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
-            ]
-          }
-        ]
-      }
-    },
     "/v1.0/tenders": {
       "get": {
         "tags": [
@@ -2083,6 +2083,55 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/jobs/{jobId}/snapshot": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Return the tender as it looked right after a given agent job ran (time-travel view).",
+        "operationId": "GetTenderJobSnapshot",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "jobId",
+            "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/{id}/jobs": {
       "get": {
         "tags": [
@@ -2348,6 +2397,10 @@
               "$ref": "#/components/schemas/agentJobLogEntry"
             },
             "nullable": true
+          },
+          "afterSnapshot": {
+            "type": "string",
+            "nullable": true
           }
         }
       },

package/specs/test/sales.json

@@ -447,6 +447,112 @@
         ]
       }
     },
+    "/v1.0/tenders/funnel": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Pipeline funnel analytics: stage counts, conversion rates, cycle times",
+        "operationId": "GetTenderFunnel",
+        "parameters": [
+          {
+            "name": "windowDays",
+            "in": "query",
+            "description": "Rolling window in days (default 30, max 365)",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of FunnelResponse",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/funnelResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/stats": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Aggregated tender KPIs for the admin dashboard (by status/stage/health + activity window)",
+        "operationId": "GetTenderStats",
+        "parameters": [
+          {
+            "name": "windowDays",
+            "in": "query",
+            "description": "Rolling window for activity-based metrics (defaults to 30, max 365)",
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of TenderStatsResponse",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tenderStatsResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/consultants/stats": {
+      "get": {
+        "tags": [
+          "Consultants"
+        ],
+        "summary": "Aggregated consultant KPIs (total, availability split, avg fit score from latest matches)",
+        "operationId": "GetConsultantStats",
+        "responses": {
+          "200": {
+            "description": "Payload of ConsultantStatsResponse",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/consultantStatsResponse"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/crawl/sources": {
       "get": {
         "tags": [
@@ -1436,45 +1542,6 @@
         ]
       }
     },
-    "/v1.0/tenders/funnel": {
-      "get": {
-        "tags": [
-          "Tenders"
-        ],
-        "summary": "Pipeline funnel analytics: stage counts, conversion rates, cycle times",
-        "operationId": "GetTenderFunnel",
-        "parameters": [
-          {
-            "name": "windowDays",
-            "in": "query",
-            "description": "Rolling window in days (default 30, max 365)",
-            "schema": {
-              "type": "integer",
-              "format": "int32"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Payload of FunnelResponse",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/funnelResponse"
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
-            ]
-          }
-        ]
-      }
-    },
     "/v1.0/realtime/negotiate": {
       "post": {
         "tags": [
@@ -1515,6 +1582,69 @@
         ]
       }
     },
+    "/v1.0/stream": {
+      "get": {
+        "tags": [
+          "Realtime"
+        ],
+        "summary": "Unified SSE stream: tender/job/crawl/consultant/audit events on one connection",
+        "operationId": "StreamAll",
+        "parameters": [
+          {
+            "name": "channels",
+            "in": "query",
+            "description": "Comma-separated namespaces to include (tender,job,crawl,consultant,audit). Default: all.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {},
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/tenders/stream-redirect": {
+      "get": {
+        "tags": [
+          "Realtime"
+        ],
+        "summary": "Deprecated: redirects to /v1.0/stream?channels=tender,job",
+        "operationId": "DeprecatedTenderStream",
+        "responses": {},
+        "deprecated": true,
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/crawl/stream-redirect": {
+      "get": {
+        "tags": [
+          "Realtime"
+        ],
+        "summary": "Deprecated: redirects to /v1.0/stream?channels=crawl,job",
+        "operationId": "DeprecatedCrawlStream",
+        "responses": {},
+        "deprecated": true,
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/salesforce/opportunities": {
       "get": {
         "tags": [
@@ -1723,136 +1853,6 @@
         ]
       }
     },
-    "/v1.0/tenders/stats": {
-      "get": {
-        "tags": [
-          "Tenders"
-        ],
-        "summary": "Aggregated tender KPIs for the admin dashboard (by status/stage/health + activity window)",
-        "operationId": "GetTenderStats",
-        "parameters": [
-          {
-            "name": "windowDays",
-            "in": "query",
-            "description": "Rolling window for activity-based metrics (defaults to 30, max 365)",
-            "schema": {
-              "type": "integer",
-              "format": "int32"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Payload of TenderStatsResponse",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/tenderStatsResponse"
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/consultants/stats": {
-      "get": {
-        "tags": [
-          "Consultants"
-        ],
-        "summary": "Aggregated consultant KPIs (total, availability split, avg fit score from latest matches)",
-        "operationId": "GetConsultantStats",
-        "responses": {
-          "200": {
-            "description": "Payload of ConsultantStatsResponse",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/consultantStatsResponse"
-                }
-              }
-            }
-          }
-        },
-        "security": [
-          {
-            "Implicit": [
-              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/stream": {
-      "get": {
-        "tags": [
-          "Realtime"
-        ],
-        "summary": "Unified SSE stream: tender/job/crawl/consultant/audit events on one connection",
-        "operationId": "StreamAll",
-        "parameters": [
-          {
-            "name": "channels",
-            "in": "query",
-            "description": "Comma-separated namespaces to include (tender,job,crawl,consultant,audit). Default: all.",
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {},
-        "security": [
-          {
-            "Implicit": [
-              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/tenders/stream-redirect": {
-      "get": {
-        "tags": [
-          "Realtime"
-        ],
-        "summary": "Deprecated: redirects to /v1.0/stream?channels=tender,job",
-        "operationId": "DeprecatedTenderStream",
-        "responses": {},
-        "deprecated": true,
-        "security": [
-          {
-            "Implicit": [
-              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
-            ]
-          }
-        ]
-      }
-    },
-    "/v1.0/crawl/stream-redirect": {
-      "get": {
-        "tags": [
-          "Realtime"
-        ],
-        "summary": "Deprecated: redirects to /v1.0/stream?channels=crawl,job",
-        "operationId": "DeprecatedCrawlStream",
-        "responses": {},
-        "deprecated": true,
-        "security": [
-          {
-            "Implicit": [
-              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
-            ]
-          }
-        ]
-      }
-    },
     "/v1.0/tenders": {
       "get": {
         "tags": [
@@ -2083,6 +2083,55 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/jobs/{jobId}/snapshot": {
+      "get": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Return the tender as it looked right after a given agent job ran (time-travel view).",
+        "operationId": "GetTenderJobSnapshot",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "jobId",
+            "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/{id}/jobs": {
       "get": {
         "tags": [
@@ -2348,6 +2397,10 @@
               "$ref": "#/components/schemas/agentJobLogEntry"
             },
             "nullable": true
+          },
+          "afterSnapshot": {
+            "type": "string",
+            "nullable": true
           }
         }
       },