# MCP: kb

Source: <https://telegafirst.com/docs/mcp-kb>
Locale: ru
releaseGitSha: c9a428d902de0b479a981e43774f38b9ec077ed7
sourceContentDigest: b4f07723c8c862386d3627a6ee2eba9e2ab94ca2fd72cb21820ab6e9a297208f
Version: 1

# MCP: kb

Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required\_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load\_domain/describe\_tool и существующий meta-dispatch описаны в [MCP-руководстве](https://telegafirst.com/docs/mcp-guide). [Scopes и права](https://telegafirst.com/docs/scopes-and-permissions) применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.

## create\_knowledge

Add a knowledge-base entry to a board (`kb_type`: manager or coach) with a title + content (≤20000 chars) and optional tags. ASYNC: the entry is stored and QUEUED for graph indexing — it returns immediately with status `indexing` (poll get\_knowledge until `indexed`). Returns the created entry with its assigned `seqNum`.

```json
{
  "description": "Add a knowledge-base entry to a board (`kb_type`: manager or coach) with a title + content (≤20000 chars) and optional tags. ASYNC: the entry is stored and QUEUED for graph indexing — it returns immediately with status `indexing` (poll get_knowledge until `indexed`). Returns the created entry with its assigned `seqNum`.",
  "domain": "kb",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "content": {
        "description": "Value for content.",
        "maxLength": 20000,
        "minLength": 1,
        "type": "string"
      },
      "kb_type": {
        "description": "Value for kb type.",
        "enum": [
          "manager",
          "coach"
        ],
        "type": "string"
      },
      "prepared_step_seq_nums": {
        "description": "Value for prepared step seq nums.",
        "items": {
          "description": "Value for prepared step seq nums item.",
          "exclusiveMinimum": 0,
          "maximum": 2147483647,
          "type": "integer"
        },
        "maxItems": 50,
        "type": "array"
      },
      "tags": {
        "description": "Value for tags.",
        "items": {
          "description": "Value for tags item.",
          "maxLength": 64,
          "minLength": 1,
          "type": "string"
        },
        "maxItems": 50,
        "type": "array"
      },
      "title": {
        "description": "Value for title.",
        "maxLength": 200,
        "minLength": 1,
        "type": "string"
      }
    },
    "required": [
      "kb_type",
      "title",
      "content"
    ],
    "type": "object"
  },
  "name": "create_knowledge",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "kb:write"
  ],
  "risk": "write",
  "scope": "kb:write",
  "title": "Create Knowledge"
}
```

## delete\_knowledge

Soft-delete an operator-authored knowledge-base entry by board (`kb_type`) and tenant-scoped `seq_num`. Idempotent.

```json
{
  "description": "Soft-delete an operator-authored knowledge-base entry by board (`kb_type`) and tenant-scoped `seq_num`. Idempotent.",
  "domain": "kb",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "kb_type": {
        "description": "Value for kb type.",
        "enum": [
          "manager",
          "coach"
        ],
        "type": "string"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      }
    },
    "required": [
      "kb_type",
      "seq_num"
    ],
    "type": "object"
  },
  "name": "delete_knowledge",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "kb:write"
  ],
  "risk": "destructive",
  "scope": "kb:write",
  "title": "Delete Knowledge"
}
```

## get\_knowledge

Read one knowledge-base entry by its board (`kb_type`) + `seq_num`. Use this to poll the async index `status` after creating an entry. Errors NOT\_FOUND if the entry does not exist for your tenant.

```json
{
  "description": "Read one knowledge-base entry by its board (`kb_type`) + `seq_num`. Use this to poll the async index `status` after creating an entry. Errors NOT_FOUND if the entry does not exist for your tenant.",
  "domain": "kb",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "kb_type": {
        "description": "Value for kb type.",
        "enum": [
          "manager",
          "coach"
        ],
        "type": "string"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      }
    },
    "required": [
      "kb_type",
      "seq_num"
    ],
    "type": "object"
  },
  "name": "get_knowledge",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "kb:read"
  ],
  "risk": "read",
  "scope": "kb:read",
  "title": "Get Knowledge"
}
```

## list\_knowledge

List the tenant knowledge-base entries across both boards (manager = the AI sales/support agent; coach = the AI coach). Returns each entry with its `kbType`, `seqNum` (the id you pass to get), title, index `status` (pending/indexing/indexed/failed) and indexing summary. 0-cost read.

```json
{
  "description": "List the tenant knowledge-base entries across both boards (manager = the AI sales/support agent; coach = the AI coach). Returns each entry with its `kbType`, `seqNum` (the id you pass to get), title, index `status` (pending/indexing/indexed/failed) and indexing summary. 0-cost read.",
  "domain": "kb",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {},
    "type": "object"
  },
  "name": "list_knowledge",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "kb:read"
  ],
  "risk": "read",
  "scope": "kb:read",
  "title": "List Knowledge"
}
```

## update\_knowledge

Update an operator-authored knowledge-base entry by board (`kb_type`) and tenant-scoped `seq_num`. Send only fields you intend to change.

```json
{
  "description": "Update an operator-authored knowledge-base entry by board (`kb_type`) and tenant-scoped `seq_num`. Send only fields you intend to change.",
  "domain": "kb",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "kb_type": {
        "description": "Value for kb type.",
        "enum": [
          "manager",
          "coach"
        ],
        "type": "string"
      },
      "patch": {
        "additionalProperties": false,
        "description": "Value for patch.",
        "properties": {
          "content": {
            "description": "Value for content.",
            "maxLength": 20000,
            "minLength": 1,
            "type": "string"
          },
          "prepared_step_seq_nums": {
            "description": "Value for prepared step seq nums.",
            "items": {
              "description": "Value for prepared step seq nums item.",
              "exclusiveMinimum": 0,
              "maximum": 2147483647,
              "type": "integer"
            },
            "maxItems": 50,
            "type": "array"
          },
          "tags": {
            "description": "Value for tags.",
            "items": {
              "description": "Value for tags item.",
              "maxLength": 64,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 50,
            "type": "array"
          },
          "title": {
            "description": "Value for title.",
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          }
        },
        "type": "object"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      }
    },
    "required": [
      "kb_type",
      "seq_num",
      "patch"
    ],
    "type": "object"
  },
  "name": "update_knowledge",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "kb:write"
  ],
  "risk": "write",
  "scope": "kb:write",
  "title": "Update Knowledge"
}
```