Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PARARAM_LOGIN | Yes | Your pararam.io login | |
| PARARAM_2FA_KEY | No | Your 2FA secret key for TOTP authentication | |
| PARARAM_PASSWORD | Yes | Your pararam.io password |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_messages | 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_chat_messages | 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, currently not used) Returns: ToolResponse with GetChatMessagesPayload containing chat messages including sender, text, and timestamp |
| send_message | 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_conversation_thread | 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_file_to_chat | 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_message_from_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_post_attachments | 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_post_attachment | 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:
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 |
| search_chats | 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 |
| search_users | 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_user_info | 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_team_status | 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 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |