Richard McKellar

Conversations List

List active messaging conversations across connected platforms. Returns conversations with their session keys (needed for messages_read), platform, chat type, display name, and last activity time. Args: platform: Filter by platform name (telegram, discord, slack, etc.) limit: Maximum number of conversations to return (default 50) search: Optional text to filter conversations by name

Conversation Get

Get detailed info about one conversation by its session key. Args: session_key: The session key from conversations_list

Messages Read

Read recent messages from a conversation. Returns the message history in chronological order with role, content, and timestamp for each message. Args: session_key: The session key from conversations_list limit: Maximum number of messages to return (default 50, most recent)

Attachments Fetch

List non-text attachments for a message in a conversation. Extracts images, media files, and other non-text content blocks from the specified message. Args: session_key: The session key from conversations_list message_id: The message ID from messages_read

Events Poll

Poll for new conversation events since a cursor position. Returns events that have occurred since the given cursor. Use the returned next_cursor value for subsequent polls. Event types: message, approval_requested, approval_resolved Args: after_cursor: Return events after this cursor (0 for all) session_key: Optional filter to one conversation limit: Maximum events to return (default 20)

Events Wait

Wait for the next conversation event (long-poll). Blocks until a matching event arrives or the timeout expires. Use this for near-real-time event delivery without polling. Args: after_cursor: Wait for events after this cursor session_key: Optional filter to one conversation timeout_ms: Maximum wait time in milliseconds (default 30000)

Messages Send

Send a message to a platform conversation. The target format is "platform:chat_id" — same format used by the channels_list tool. You can also use human-friendly channel names that will be resolved automatically. Examples: target="telegram:6308981865" target="discord:#general" target="slack:#engineering" Args: target: Platform target in "platform:identifier" format message: The message text to s

Channels List

List available messaging channels and targets across platforms. Returns channels that you can send messages to. The target strings returned here can be used directly with the messages_send tool. Args: platform: Filter by platform name (telegram, discord, slack, etc.)

Permissions List Open

List pending approval requests observed during this bridge session. Returns exec and plugin approval requests that the bridge has seen since it started. Approvals are live-session only — older approvals from before the bridge connected are not included.

Permissions Respond

Respond to a pending approval request. Args: id: The approval ID from permissions_list_open decision: One of "allow-once", "allow-always", or "deny"