Search for messages across all chats or in specific chats.

Args: query: Search query string. Supports search filters (see below) limit: Maximum number of results to return (default: 20) chat_ids: Optional list of chat IDs to search within. If None, search in all chats.

Search Syntax: Boolean Operators: By default, all terms are optional (OR), as long as one term matches. Search for "foo bar baz" finds any document containing foo OR bar OR baz.

    + (must be present) - Example: +fox (fox must be found)
    - (must not be present) - Example: -news (news must be excluded)
    Example: "quick brown +fox -news" (fox required, news excluded, quick/brown optional)

    AND, OR, NOT (also &&, ||, !) - Standard boolean operators
    NOTE: NOT takes precedence over AND, which takes precedence over OR
    Example: "(quick OR brown) AND fox"

Grouping:
    Use parentheses to group terms: "(quick OR brown) AND fox"

Wildcards:
    ? - Replace single character: "qu?ck"
    * - Replace zero or more characters: "bro*"

Strict Search:
    Use quotes for exact phrase match: "some search phrase"

Fuzziness:
    Use ~ for similar terms (Damerau-Levenshtein distance, max 2 changes):
    "quikc~ brwn~ foks~" or "quikc~1" (edit distance of 1)

Proximity Search:
    Use ~N after phrase to allow words to be N positions apart:
    "fox quick"~5 (allows up to 5 words distance, any order)

Search Filters: Format: search text /filter1 param1 param2 /filter2 param

/users or /from - Find posts by specific users
    Example: /users @user1 @user2 or /from @user1 @user2

/replyto or /reply - Find messages that are replies to specified users
    Example: /replyto @user1 @user2 or /reply @user1 @user2

/to - Find messages that mention users OR are replies to them
    Example: /to @user1 @user2

/file - Find files by name pattern
    Example: /file *filen?me*

/from_date or /after - Find posts created after a date (YYYY-MM-DD, YYYY-MM, or YYYY)
    Example: /from_date 2016-01-22 or /after 2016-01 or /after 2016

/to_date or /before - Find posts created before a date (YYYY-MM-DD, YYYY-MM, or YYYY)
    Example: /to_date 2016-01-22 or /before 2016-01 or /before 2016

/tags - Find posts containing specific tags (strict match)
    Example: /tags hey may day or /tags #hey #may #day or #hey #may #day

/has - Find posts based on content type:
    /has tag - Posts containing tags (e.g., #may)
    /has link - Posts containing URLs or markdown links
    /has email - Posts containing email addresses
    /has mention - Posts mentioning any user or user with role
    /has user - Posts containing user mentions or words starting with @
    /has group - Posts containing role mentions
    /has reply - Posts that are replies
    /has file - Posts with attached files
    /has block - Posts with text in blocks (>text or ```text)
    /has poll - Posts containing polls

Returns: ToolResponse with SearchMessagesPayload containing search results with message text, sender, chat info, and timestamp

Get messages from a specific chat.

Args: chat_id: ID of the chat to get messages from limit: Maximum number of messages to return (default: 50) before_message_id: Get messages before this message ID (for pagination). If provided, returns messages older than this ID.

Returns: ToolResponse with GetChatMessagesPayload containing chat messages including sender, text, and timestamp

Send a message to a chat.

Args: chat_id: ID of the chat to send message to text: Message text to send reply_to_message_id: Post number to reply to (optional) quote_text: Text to quote from the replied message (optional, only used with reply_to_message_id)

Returns: ToolResponse with SendMessagePayload containing sent message details including message ID and timestamp

Build a conversation thread starting from a root message.

Returns all messages that are replies to the root message or replies to those replies, recursively.

Args: chat_id: ID of the chat root_message_id: Post number to use as root of the conversation limit: Maximum number of recent messages to load and search (default: 100)

Returns: ToolResponse with BuildConversationThreadPayload containing flat list of all posts in the thread, sorted by post_no. Each post contains reply_to_post_no to reconstruct the tree structure.

Upload a file to a chat.

Args: chat_id: ID of the chat to upload file to file_path: Absolute path to the file on local filesystem (mutually exclusive with file_content) file_content: Base64-encoded file content (mutually exclusive with file_path) filename: Filename to use when file_content is provided (required if file_content is set) reply_to_message_id: Post number to reply to (optional)

Returns: ToolResponse with UploadFilePayload containing uploaded file details including file ID, name, size, and URL

Get a specific message from a pararam.io URL.

Args: url: Pararam.io URL (e.g., https://app.pararam.io/#/organizations/1/threads/12345#post_no-6789)

Returns: ToolResponse with GetMessageFromUrlPayload containing message details including post_no, text, sender, and timestamp

Get list of attachments (files, images, documents) from a specific post.

Args: chat_id: ID of the chat post_no: Post number

Returns: ToolResponse with GetPostAttachmentsPayload containing list of attachments including file ID, name, size, and download URL

Download a specific attachment from a post.

If output_path is provided, saves file to disk and returns DownloadAttachmentResponse. If output_path is None and file type is supported, returns ImageContent for direct display. If output_path is None and file type is not supported, returns DownloadAttachmentErrorResponse.

Supported file types for ImageContent:

• Images: JPEG, PNG, GIF, WEBP

• Documents: PDF, DOCX, DOC, TXT, RTF, ODT, HTML, EPUB

• Spreadsheets: XLSX, XLS, CSV

• Data: JSON, XML

Args: chat_id: ID of the chat post_no: Post number file_guid: GUID of the file to download (from get_post_attachments) output_path: Optional absolute path where to save the file. If None, only supported file types can be displayed

Returns: ImageContent for supported file types (direct display in Claude), DownloadAttachmentResponse model when saved to disk, DownloadAttachmentErrorResponse model for errors, or error string

Fetch the full reply thread rooted at a post (server-side rerere traversal).

Returns every post number in the thread in the order the server reports them — the root and every transitively-reachable reply.

Args: chat_id: Numeric chat ID. post_no: Post number to root the thread traversal at.

Returns: ToolResponse with the list of post numbers comprising the thread.

Fetch direct replies to a post (one level deep, hydrated).

Args: chat_id: Numeric chat ID. post_no: Post number whose direct replies should be returned.

Returns: ToolResponse with PostInfo entries for each direct reply.

Edit an existing post.

Args: chat_id: Numeric chat ID. post_no: Post number to edit (must be authored by the token's user). text: New post text. quote: Optional quoted text override. reply_no: Optional change to which post this one replies to.

Returns: ToolResponse with the edited post's identity and new text.

Delete a post.

Args: chat_id: Numeric chat ID. post_no: Post number to delete (must be authored by the token's user).

Returns: ToolResponse confirming the delete and the resulting is_deleted flag.

Search for chats by name or description.

Args: query: Search query string limit: Maximum number of results to return (default: 20, applied client-side)

Returns: ToolResponse with SearchChatsPayload containing chat list including chat ID, name, type, and member count

Fetch a single chat's metadata by ID.

Args: chat_id: Numeric chat ID.

Returns: ToolResponse with the chat title, type, member counts, and description.

Create a personal (PM) chat with another user.

Args: user_id: Numeric ID of the user to start a PM with.

Returns: ToolResponse with the new chat's ID.

Create a group chat with the given title and member set.

Args: title: Group chat title (required). description: Optional chat description. users: List of user IDs to invite. Empty/None creates an empty chat. organization_id: Organization to scope the chat to (optional).

Returns: ToolResponse with the new chat's ID and title.

Create a branch (thread) chat rooted at a specific post in another chat.

Requires the parent chat to have allow_branch=True. Errors otherwise.

Args: parent_chat_id: ID of the chat to branch from. post_no: Post number to root the branch at. title: Optional title for the branch chat.

Returns: ToolResponse with the new branch chat's ID.

Search for users by name or unique name.

Args: query: Search query string (name or unique_name) limit: Maximum number of results to return (default: 20)

Returns: ToolResponse with SearchUsersPayload containing list of users including id, name, unique_name, and team memberships

Get detailed information about a specific user.

Args: user_id: User ID

Returns: ToolResponse with GetUserInfoPayload containing user details including id, name, unique_name, and team memberships

Get user's status in teams (member, admin, guest, or not in team).

Args: user_id: User ID to check team_id: Optional team ID to check status in specific team. If not provided, returns status in all teams.

Returns: ToolResponse with GetUserTeamStatusPayload containing team membership status including is_member, is_admin, is_guest, and state