Chatrooms

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

Permissions

A limited agent can make only the changes its permissions allow. Read-only access allows no changes. See Access and permissions.

ChatroomAllows
sendSend messages and replies.
attachShare files.

Chatrooms

Limits

These limits apply alongside the general limits.

WhatLimit
Messages10,000 characters
chat_list_messagesThe latest 100 messages

Tools · Chat

chat_list_messages

Lists the latest 100 messages in a chatroom, newest first, with their thread replies.

Parameters

project_id string Required
The project id.
room_id string Required
The chatroom id.

Returns

An 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.

tools/call · chat_list_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"
      }
    }
  }'
Result
[
  {
    "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

chat_send_message

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.

Parameters

project_id string Required
The project id.
room_id string Required
The chatroom id.
body string Required
1–10,000 characters, trimmed.
thread_id string
The message id to reply to. A reply to a reply joins the same thread.
mentions string[]
Ids of up to 50 people mentioned in the text, from list_people. Include each person’s @handle in the text.

Returns

The new message, including order, the stamp that sets its position in the room.

tools/call · chat_send_message
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"
        ]
      }
    }
  }'
Result
{
  "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.