mcpDeterministic

Save knowledge draft

tools/call

Save the full merged knowledge object as an inactive draft. Read first, preserve existing entries, show proposed changes, and use current draft createdAt (null only when no draft exists).

Parameters

workspaceId

string

No description.

knowledgerequired

object

No description.

changeSummaryrequired

string

No description.

expectedDraftCreatedAtrequired

string | null

No description.

Example

MCP tools/calljson

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "save-knowledge-draft",
    "arguments": {
      "knowledge": {
        "offer": "example",
        "approvedFacts": [
          "example"
        ],
        "faqs": [
          {
            "question": "example",
            "answer": "example"
          }
        ],
        "objections": [
          {
            "objection": "example",
            "response": "example"
          }
        ],
        "proof": [
          "example"
        ],
        "assets": [
          {
            "name": "example",
            "description": "example",
            "url": "https://example.com"
          }
        ],
        "tone": [
          "example"
        ],
        "booking": [
          "example"
        ],
        "escalation": [
          "example"
        ]
      },
      "changeSummary": "example",
      "expectedDraftCreatedAt": "2026-01-01T00:00:00.000Z"
    }
  }
}

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "knowledge": {
      "type": "object",
      "properties": {
        "skillId": {
          "type": "string"
        },
        "overlayId": {
          "type": [
            "string",
            "null"
          ]
        },
        "draft": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "versionNumber": {
              "type": "number"
            },
            "status": {
              "type": "string",
              "enum": [
                "draft",
                "active",
                "archived"
              ]
            },
            "changeSummary": {
              "type": "string"
            },
            "createdAt": {
              "type": "string"
            },
            "activatedAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "knowledge": {
              "type": "object"
            }
          },
          "required": [
            "versionNumber",
            "status",
            "changeSummary",
            "createdAt",
            "activatedAt",
            "knowledge"
          ]
        },
        "published": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "versionNumber": {
              "type": "number"
            },
            "status": {
              "type": "string",
              "enum": [
                "draft",
                "active",
                "archived"
              ]
            },
            "changeSummary": {
              "type": "string"
            },
            "createdAt": {
              "type": "string"
            },
            "activatedAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "knowledge": {
              "type": "object"
            }
          },
          "required": [
            "versionNumber",
            "status",
            "changeSummary",
            "createdAt",
            "activatedAt",
            "knowledge"
          ]
        },
        "versions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "versionNumber": {
                "type": "number"
              },
              "status": {
                "type": "string",
                "enum": [
                  "draft",
                  "active",
                  "archived"
                ]
              },
              "changeSummary": {
                "type": "string"
              },
              "createdAt": {
                "type": "string"
              },
              "activatedAt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "knowledge": {
                "type": "object"
              }
            },
            "required": [
              "versionNumber",
              "status",
              "changeSummary",
              "createdAt",
              "activatedAt",
              "knowledge"
            ]
          }
        }
      },
      "required": [
        "skillId",
        "overlayId",
        "draft",
        "published",
        "versions"
      ]
    }
  },
  "required": [
    "knowledge"
  ]
}

JSON-RPC errors

-32602: Invalid parameters. Field-level details are returned in the JSON-RPC error data.
-32001: Authentication or hosted AI consent is required.
-32003: Workspace access is denied.
-32029: The request was rate limited.