Kenso MCP tools

Files files

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through files_read and changes through files_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: content, file-comments-create, create, file-comments-delete, delete, get, file-comments-list, list, file-comments-update, update, upload

content

Read. GET https://api.ken.so/v1/files/{fileId}/content

Path: fileId

Read file content. Internal. Markdown comes back as text. PDF and DOCX come back as base64.

GET /api/v1/files/{fileId}/content. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
Requires Knowledge view.
A PDF or DOCX returns data with fileName, contentType, size (bytes) and
contentBase64, the file's bytes in base64. One over 2 MiB (2,097,152 bytes)
is refused with a validation error: open it in the Kenso app instead.

file-comments-create

Write. POST https://api.ken.so/v1/files/{fileId}/comments

Path: fileId

Body (json): blockIndex integer, content string, parentCommentId integer

Add a comment on a file. Internal. Requires full access. content is required.

POST /api/v1/files/{fileId}/comments. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
blockIndex and parentCommentId are optional.

create

Write. POST https://api.ken.so/v1/files

Body (json): campaignId integer, content string, name string

Create a Markdown file. Internal. Requires full access. campaign_id attaches it to a campaign.

POST /api/v1/files. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
content is sent as a string. name is required.

file-comments-delete

Write. DELETE https://api.ken.so/v1/files/{fileId}/comments/{commentId}

Path: fileId, commentId

Delete a file comment. Internal. Requires full access. Returns 204.

DELETE /api/v1/files/{fileId}/comments/{commentId}.
Sends Ken-Version 1.1 and X-Ken-Workspace-Id.

delete

Write. DELETE https://api.ken.so/v1/files/{fileId}

Path: fileId

Delete a file. Internal. Requires full access. Returns 204.

DELETE /api/v1/files/{fileId}. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.

get

Read. GET https://api.ken.so/v1/files/{fileId}

Path: fileId

Get one file. Internal. A file outside the workspace is not_found.

GET /api/v1/files/{fileId}. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
Requires Knowledge view.

file-comments-list

Read. GET https://api.ken.so/v1/files/{fileId}/comments

Path: fileId

Query: cursor string, limit integer

List comments on a file. Internal. limit is 1 to 200.

GET /api/v1/files/{fileId}/comments. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
Requires Knowledge view.

list

Read. GET https://api.ken.so/v1/files

Query: campaignId integer, cursor string, limit integer

List workspace files, or one campaign's files. Internal. campaign_id selects campaign files.

GET /api/v1/files. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
Requires Knowledge view. A campaign outside the workspace is not_found.

file-comments-update

Write. PATCH https://api.ken.so/v1/files/{fileId}/comments/{commentId}

Path: fileId, commentId

Body (json): content string

Update a file comment. Internal. Requires full access. content is required.

PATCH /api/v1/files/{fileId}/comments/{commentId}.
Sends Ken-Version 1.1 and X-Ken-Workspace-Id.

update

Write. PATCH https://api.ken.so/v1/files/{fileId}

Path: fileId

Body (json): content string, name string

Update a file name or content. Internal. Requires full access. Omitted fields stay unchanged.

PATCH /api/v1/files/{fileId}. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.

upload

Write. POST https://api.ken.so/v1/files/uploads

Query: campaignId integer

Upload a PDF or DOCX onto a campaign. Internal. Requires full access. campaign_id is required. Limit is 50 MB.

POST /api/v1/files/uploads. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
Multipart field file, optional form name, and query campaignId.

file_content_base64 is the document's bytes in base64 and file_name its
name (.pdf or .docx). The hosted MCP refuses file_path, because it cannot
read your machine; off the hosted MCP, file_path opens only a file inside
the MCP export directory.