@snokam/mcp-api 0.175.0 → 0.177.0

package/package.json

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

package/specs/production/employees.json

@@ -568,6 +568,58 @@
         ]
       }
     },
+    "/v1.0/cvs/users/{userId}/{cvId}": {
+      "get": {
+        "tags": [
+          "Proposals"
+        ],
+        "summary": "Get any CV (including tailored CVs) as raw Flowcase JSON by user_id + cv_id.",
+        "operationId": "GetRawCv",
+        "parameters": [
+          {
+            "name": "userId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "cvId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/cvs/users/{userId}/{cvId}/sections/{sectionType}/{sectionId}": {
       "put": {
         "tags": [

package/specs/production/sales.json

@@ -1603,6 +1603,118 @@
         ]
       }
     },
+    "/v1.0/cv-variants/me": {
+      "get": {
+        "tags": [
+          "CvVariants"
+        ],
+        "summary": "Get the authenticated consultant's persistent AI CV variant, if one exists.",
+        "operationId": "GetMyCvVariant",
+        "responses": {
+          "200": {
+            "description": "Payload of ConsultantCvVariantView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/consultantCvVariantView"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "CvVariants"
+        ],
+        "summary": "Get or create the authenticated consultant's persistent AI CV variant (Flowcase proposal + tailored CV copy of the main CV).",
+        "operationId": "EnsureMyCvVariant",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ensureCvVariantRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of ConsultantCvVariantView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/consultantCvVariantView"
+                }
+              }
+            }
+          },
+          "502": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/cv-variants/me/promote": {
+      "post": {
+        "tags": [
+          "CvVariants"
+        ],
+        "summary": "Merge the consultant's AI CV variant into the main CV.",
+        "operationId": "PromoteMyCvVariant",
+        "responses": {
+          "200": {
+            "description": "Payload of ConsultantCvVariantView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/consultantCvVariantView"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "501": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/consultants": {
       "get": {
         "tags": [
@@ -2311,6 +2423,60 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/matches/interest": {
+      "post": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Mark a consultant's interest in a matched tender. interested=true selects the match; false deselects and dismisses it (suppressing future match notifications).",
+        "operationId": "SetConsultantMatchInterest",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/setMatchInterestRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of TenderView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tenderView"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://bb21a8d0-366b-4a95-aa59-dbbf708322d1/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/{id}/slack-messages": {
       "post": {
         "tags": [
@@ -3434,6 +3600,45 @@
           }
         }
       },
+      "consultantCvVariantView": {
+        "type": "object",
+        "properties": {
+          "consultantEmail": {
+            "type": "string",
+            "nullable": true
+          },
+          "consultantName": {
+            "type": "string",
+            "nullable": true
+          },
+          "proposalId": {
+            "type": "string",
+            "nullable": true
+          },
+          "userId": {
+            "type": "string",
+            "nullable": true
+          },
+          "mainCvId": {
+            "type": "string",
+            "nullable": true
+          },
+          "variantCvId": {
+            "type": "string",
+            "nullable": true
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "promotedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        }
+      },
       "consultantMatch": {
         "type": "object",
         "properties": {
@@ -3480,6 +3685,15 @@
             "type": "boolean",
             "nullable": true
           },
+          "dismissed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "dismissedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
           "fitExplanation": {
             "type": "string",
             "nullable": true
@@ -3948,6 +4162,15 @@
           }
         }
       },
+      "ensureCvVariantRequest": {
+        "type": "object",
+        "properties": {
+          "consultantName": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
       "externalSourceRef": {
         "type": "object",
         "properties": {
@@ -4291,6 +4514,19 @@
           }
         }
       },
+      "setMatchInterestRequest": {
+        "type": "object",
+        "properties": {
+          "email": {
+            "type": "string",
+            "nullable": true
+          },
+          "interested": {
+            "type": "boolean",
+            "nullable": true
+          }
+        }
+      },
       "sourceFile": {
         "type": "object",
         "properties": {

package/specs/test/employees.json

@@ -568,6 +568,58 @@
         ]
       }
     },
+    "/v1.0/cvs/users/{userId}/{cvId}": {
+      "get": {
+        "tags": [
+          "Proposals"
+        ],
+        "summary": "Get any CV (including tailored CVs) as raw Flowcase JSON by user_id + cv_id.",
+        "operationId": "GetRawCv",
+        "parameters": [
+          {
+            "name": "userId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "cvId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/cvs/users/{userId}/{cvId}/sections/{sectionType}/{sectionId}": {
       "put": {
         "tags": [

package/specs/test/sales.json

@@ -1603,6 +1603,118 @@
         ]
       }
     },
+    "/v1.0/cv-variants/me": {
+      "get": {
+        "tags": [
+          "CvVariants"
+        ],
+        "summary": "Get the authenticated consultant's persistent AI CV variant, if one exists.",
+        "operationId": "GetMyCvVariant",
+        "responses": {
+          "200": {
+            "description": "Payload of ConsultantCvVariantView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/consultantCvVariantView"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "CvVariants"
+        ],
+        "summary": "Get or create the authenticated consultant's persistent AI CV variant (Flowcase proposal + tailored CV copy of the main CV).",
+        "operationId": "EnsureMyCvVariant",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ensureCvVariantRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of ConsultantCvVariantView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/consultantCvVariantView"
+                }
+              }
+            }
+          },
+          "502": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
+    "/v1.0/cv-variants/me/promote": {
+      "post": {
+        "tags": [
+          "CvVariants"
+        ],
+        "summary": "Merge the consultant's AI CV variant into the main CV.",
+        "operationId": "PromoteMyCvVariant",
+        "responses": {
+          "200": {
+            "description": "Payload of ConsultantCvVariantView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/consultantCvVariantView"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          },
+          "501": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/consultants": {
       "get": {
         "tags": [
@@ -2311,6 +2423,60 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/matches/interest": {
+      "post": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Mark a consultant's interest in a matched tender. interested=true selects the match; false deselects and dismisses it (suppressing future match notifications).",
+        "operationId": "SetConsultantMatchInterest",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/setMatchInterestRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of TenderView",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/tenderView"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://b2c47b20-df4a-49b5-a7ee-87f3647ab227/.default"
+            ]
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/{id}/slack-messages": {
       "post": {
         "tags": [
@@ -3434,6 +3600,45 @@
           }
         }
       },
+      "consultantCvVariantView": {
+        "type": "object",
+        "properties": {
+          "consultantEmail": {
+            "type": "string",
+            "nullable": true
+          },
+          "consultantName": {
+            "type": "string",
+            "nullable": true
+          },
+          "proposalId": {
+            "type": "string",
+            "nullable": true
+          },
+          "userId": {
+            "type": "string",
+            "nullable": true
+          },
+          "mainCvId": {
+            "type": "string",
+            "nullable": true
+          },
+          "variantCvId": {
+            "type": "string",
+            "nullable": true
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "promotedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        }
+      },
       "consultantMatch": {
         "type": "object",
         "properties": {
@@ -3480,6 +3685,15 @@
             "type": "boolean",
             "nullable": true
           },
+          "dismissed": {
+            "type": "boolean",
+            "nullable": true
+          },
+          "dismissedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
           "fitExplanation": {
             "type": "string",
             "nullable": true
@@ -3948,6 +4162,15 @@
           }
         }
       },
+      "ensureCvVariantRequest": {
+        "type": "object",
+        "properties": {
+          "consultantName": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
       "externalSourceRef": {
         "type": "object",
         "properties": {
@@ -4291,6 +4514,19 @@
           }
         }
       },
+      "setMatchInterestRequest": {
+        "type": "object",
+        "properties": {
+          "email": {
+            "type": "string",
+            "nullable": true
+          },
+          "interested": {
+            "type": "boolean",
+            "nullable": true
+          }
+        }
+      },
       "sourceFile": {
         "type": "object",
         "properties": {