Kenso MCP tools

Knowledge Library knowledge_library

Knowledge library: make, rename, move and delete Knowledge folders, upload a file (PDF, Word, slides, a spreadsheet, an image or text) into the company folder, and download a finished export. folders-delete deletes everything below the folder and needs confirm=true. Write markdown with knowledge create instead of uploading it.

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through knowledge_library_read and changes through knowledge_library_write. Each takes operation plus that operation's parameters, and your workspace role decides which operations you see.

Each operation with a route calls the Kenso API at https://api.ken.so with Authorization: Bearer <Kenso API key>, Ken-Version: 1.1 and X-Ken-Workspace-Id: <workspace id>. You can call that route directly with the same headers.

Operations: export-content, folders-create, upload-create, folders-delete, folders-update

export-content

Read. Early access: needs knowledge on for the workspace. GET https://api.ken.so/v1/knowledge/exports/{exportId}/content

Path: exportId

Read a Knowledge export: its status, and the zip once it is built.

GET /api/v1/jobs/{exportId}?type=knowledge_export, then GET /api/v1/knowledge/exports/{exportId}/content,
and for a zip over 2 MiB GET /api/v1/knowledge/exports/{exportId}/download-link.
Needs the knowledge flag. Sends Ken-Version 1.1. export_id is the id knowledge_review(operation=
"export-create") returned. Returns data with id, status and downloadUrl. While Kenso builds the zip,
status is running: read it again in a minute. Once built, status is succeeded with fileName and size
(bytes), plus contentBase64, the zip in base64, when it is at most 2 MiB (2,097,152 bytes). A bigger
zip returns downloadLink and downloadLinkExpiresAt instead: a link the person opens in a browser
without signing in, for 15 minutes, so give it only to the person who asked; read the export again
for a new one. downloadUrl needs the member's credentials, so it is not a link to open in a browser.
Only the member who started the export reads it, for 24 hours: another member's, another workspace's
and an expired export are 404. An export too big to build is 409 export_too_big. Requires Knowledge
view.

folders-create

Write. Early access: needs knowledge on for the workspace. POST https://api.ken.so/v1/knowledge/folders

Body (json): description string, name string, parentId integer

Create a Knowledge folder inside another folder. Returns 201 with the folder.

POST /api/v1/knowledge/folders. Needs the knowledge flag. Sends Ken-Version 1.1. parent_id is the
folder to create it in (knowledge(operation="folders-list") lists them). name is 1 to 200 characters
and unique among its siblings in any case (409 duplicate). description is up to 1000 characters. The
folder takes its parent's section, account and owner. Requires Knowledge edit and the right to add to
the parent.

upload-create

Write. Early access: needs knowledge on for the workspace. POST https://api.ken.so/v1/knowledge/uploads

Upload a file (PDF, Word, slides, a spreadsheet, an image or text) into Knowledge.

POST /api/v1/knowledge/uploads. Needs the knowledge flag. Sends Ken-Version 1.1. Multipart field file
plus optional form field folderId. file_content_base64 is the file's bytes in base64 and file_name its
name, ending in .txt, .md, .csv, .json, .html, .pdf, .docx, .pptx, .xlsx, .png, .jpg, .tif or .webp; at
most 50 MB. folder_id is the company folder (the one named after the workspace) or a folder in it, the
default being the company folder; any other folder is 409 invalid_state upload_folder_not_supported.
Returns 201 with the new Knowledge file in status reading while Kenso parses it (OCR for scans and
images); it turns ok once read, as knowledge(operation="get") shows. For markdown you wrote yourself use
knowledge(operation="create"). Requires Knowledge edit, and a workspace admin for the company folder
itself.

folders-delete

Write. Early access: needs knowledge on for the workspace. DELETE https://api.ken.so/v1/knowledge/folders/{folderId}

Path: folderId

Delete a Knowledge folder with the folders and files below it. Refused without confirm=true.

DELETE /api/v1/knowledge/folders/{folderId}. Needs the knowledge flag. Sends Ken-Version 1.1.
confirm must be true: show the person the folder and what is inside it (knowledge_review(operation=
"tree-get") or knowledge(operation="list", folder_id=...)) and call again with confirm=true on their
yes. Returns {"folders": 3, "files": 5}, what was deleted. Ken's own folders, and a folder that holds
one of Ken's folders or files, are 409 invalid_state. Other members' private files below it are not
deleted: they move up to the folder's parent and are not counted. Requires Knowledge edit and the
folder's edit rights.

folders-update

Write. Early access: needs knowledge on for the workspace. PATCH https://api.ken.so/v1/knowledge/folders/{folderId}

Path: folderId

Body (json): name string, parentId integer

Rename a Knowledge folder, or move it under another folder of the same section.

PATCH /api/v1/knowledge/folders/{folderId}. Needs the knowledge flag. Sends Ken-Version 1.1. Send
name (1 to 200 characters), parent_id, or both; omitted fields stay. Ken's own folders can be renamed;
only a folder a person made moves, and only within its section. Returns the folder. Requires
Knowledge edit and the folder's edit rights.