Chatroom messages, threads, mentions and shared files.
A chatroom is a resource with kind chat. Chat tools take its id as room_id.
To mention someone, write @handle in the message and pass their id in mentions (both from list_people). @channel mentions everyone with access to the room.
To share a file, upload it with the room as space_id. The completed upload appears as a message with the file as its attachment. See Upload a file.
The examples use the callTool helper. To connect, see the Quickstart or Authentication.
Chatrooms
A limited agent can make only the changes its permissions allow. Read-only access allows no changes. See Access and permissions.
| Chatroom | Allows |
|---|---|
send | Send messages and replies. |
attach | Share files. |
Chatrooms
These limits apply alongside the general limits.
| What | Limit |
|---|---|
| Messages | 10,000 characters |
chat_list_messages | The latest 100 messages |
Tools · Chat
Lists the latest 100 messages in a chatroom, newest first, with their thread replies.
project_id string Requiredroom_id string RequiredAn array of messages. sender_name is the sender’s name, and sender_agent_id is set when the sender is an agent. attachment holds a shared file. replies contains the thread’s messages, oldest first, each with thread_id. channel is true if the message mentions @channel. edited_at is the time of the last edit, or null if the message was never edited. A deleted message that started a thread remains as an empty message with deleted: true. reactions lists each emoji with its count, people and mine (whether the acting person reacted). Agents can’t edit, delete or react to messages.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "chat_list_messages",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"room_id": "734c857985a14b1af535621e60590e62"
}
}
}'[
{
"id": "cef331a96793e1a9c233357773d4942c",
"order": "1790811964340.0000.s87b9c9e9c5f8",
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"room_id": "734c857985a14b1af535621e60590e62",
"body": "@dana Roadmap is up on the board.",
"created_at": "2026-09-30T23:46:04.340Z",
"sender_user_id": "5761e31cd8538b7da8a3ddd4157bd632",
"sender_agent_id": "9735814189d64dd5dc193fe843b45992",
"sender_name": "Release bot",
"mentions": [
"b8bc98d760d80b652c1b714e88c31882"
],
"channel": false,
"thread_id": null,
"replies": []
}
]Tools · Chat
Sends a message to a chatroom, or a reply in a thread if thread_id is set. To mention someone, write @handle (from list_people) and pass their id in mentions. @channel mentions everyone with access to the room. To share a file, upload it with file_begin_upload, passing the room as space_id.
project_id string Requiredroom_id string Requiredbody string Requiredthread_id string mentions string[] list_people. Include each person’s @handle in the text.The new message, including order, the stamp that sets its position in the room.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "chat_send_message",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"room_id": "734c857985a14b1af535621e60590e62",
"body": "@dana Roadmap is up on the board.",
"mentions": [
"b8bc98d760d80b652c1b714e88c31882"
]
}
}
}'{
"id": "cef331a96793e1a9c233357773d4942c",
"order": "1790811964340.0000.s87b9c9e9c5f8",
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"room_id": "734c857985a14b1af535621e60590e62",
"body": "@dana Roadmap is up on the board.",
"created_at": "2026-09-30T23:46:04.340Z",
"sender_user_id": "5761e31cd8538b7da8a3ddd4157bd632",
"sender_agent_id": "9735814189d64dd5dc193fe843b45992",
"sender_name": "Release bot",
"mentions": [
"b8bc98d760d80b652c1b714e88c31882"
],
"channel": false,
"thread_id": null,
"replies": []
}Questions or something missing? Contact us.