> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# slack

> Channels, messages, reactions, users, and workspace management

**Server path:** `/slack` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                      | Description                                                                                                                                                                                                                                                                                                                                      |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [`slack_list_channels`](#slack_list_channels)             | Browse and discover Slack channels where the bot is a member. Returns channel names, IDs, member counts, and key metadata.                                                                                                                                                                                                                       |
| [`slack_search_users`](#slack_search_users)               | Search and discover Slack users by name, email, or user ID. Returns user profiles with names, emails, display names, and user IDs. Useful for finding users or getting detailed user information.                                                                                                                                                |
| [`slack_send_message`](#slack_send_message)               | Send a message to a Slack channel or user. Supports plain text or rich Block Kit formatting. Provide either channel OR user (not both). WARNING: When using Block Kit blocks, DO NOT use interactive elements (buttons, menus, inputs) - they require advanced configuration. Use display-only blocks: section, header, divider, image, context. |
| [`slack_get_channel_history`](#slack_get_channel_history) | Retrieve message history from any Slack channel with intelligent name resolution. Accepts channel names ("engineering", "#general") or channel IDs ("C123..."). Returns recent messages with timestamps, user info, and text content.                                                                                                            |
| [`slack_add_reaction`](#slack_add_reaction)               | Add an emoji reaction to a Slack message with smart filtering. Can react to: specific message (message\_ts), latest message, nth message (position), user's message, message containing text, or combinations of filters. Automatically finds and reacts to the matching message.                                                                |
| [`slack_reply_to_thread`](#slack_reply_to_thread)         | Post a reply to an existing message thread with smart filtering. Supports plain text or rich Block Kit formatting. Can reply to: specific thread (thread\_ts), latest thread, user's thread, thread containing text, or combinations. WARNING: When using Block Kit blocks, DO NOT use interactive elements (buttons, menus, inputs).            |
| [`slack_get_thread_replies`](#slack_get_thread_replies)   | Retrieve replies from a message thread with smart filtering. Can get: specific thread (thread\_ts), latest thread, user's thread, thread containing text, or combinations. Returns parent message and all replies.                                                                                                                               |
| [`slack_list_files`](#slack_list_files)                   | List files shared in the Slack workspace with smart filtering. Can filter by channel, user, file type, or combinations. Returns file metadata including download URLs, sizes, and creators. Useful for finding recently shared documents, images, or other files.                                                                                |
| [`slack_get_dm_history`](#slack_get_dm_history)           | Get message history from a direct message conversation with smart user resolution. Accepts username, email, or user ID to identify the DM partner. Returns recent DM messages with timestamps and content. Useful for reviewing past DM conversations.                                                                                           |
| [`slack_get_workspace_info`](#slack_get_workspace_info)   | Get information about the Slack workspace (team). Returns workspace name, domain, team ID, and icon URLs. Useful for identifying which workspace the bot is operating in, especially in multi-workspace scenarios.                                                                                                                               |
| [`slack_get_mentions`](#slack_get_mentions)               | Get recent messages where the bot was mentioned with smart filtering. Can filter by channel, time range, or combinations. Returns messages with @bot mentions, useful for finding conversations the bot should respond to or review.                                                                                                             |

***

## slack\_list\_channels

Browse and discover Slack channels where the bot is a member. Returns channel names, IDs, member counts, and key metadata.

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                                                                                                                  |
| ---------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`          | number  | No       | `50`    | Maximum number of channels to return (1-200, default: 50)                                                                                                                    |
| `cursor`         | string  | No       | —       | Pagination cursor for retrieving next page                                                                                                                                   |
| `showAllDetails` | boolean | No       | `false` | If true, includes all channel metadata and also lists other available public channels the bot can join; if false (default), shows only joined channels with essential fields |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "limit": {
        "type": "number",
        "default": 50,
        "description": "Maximum number of channels to return (1-200, default: 50)"
      },
      "cursor": {
        "type": "string",
        "description": "Pagination cursor for retrieving next page"
      },
      "showAllDetails": {
        "type": "boolean",
        "default": false,
        "description": "If true, includes all channel metadata and also lists other available public channels the bot can join; if false (default), shows only joined channels with essential fields"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## slack\_search\_users

Search and discover Slack users by name, email, or user ID. Returns user profiles with names, emails, display names, and user IDs. Useful for finding users or getting detailed user information.

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                          |
| ---------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------ |
| `query`          | string  | Yes      | —       | Name, email, or user ID to search for                                                |
| `showAllDetails` | boolean | No       | `false` | If true, includes all user metadata; if false (default), shows only essential fields |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "query": {
        "type": "string",
        "description": "Name, email, or user ID to search for"
      },
      "showAllDetails": {
        "type": "boolean",
        "default": false,
        "description": "If true, includes all user metadata; if false (default), shows only essential fields"
      }
    },
    "required": [
      "PCID",
      "query"
    ]
  }
  ```
</Expandable>

***

## slack\_send\_message

Send a message to a Slack channel or user. Supports plain text or rich Block Kit formatting. Provide either channel OR user (not both). WARNING: When using Block Kit blocks, DO NOT use interactive elements (buttons, menus, inputs) - they require advanced configuration. Use display-only blocks: section, header, divider, image, context.

**Parameters:**

| Parameter | Type      | Required | Default | Description                                                                                                                                                                             |
| --------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `channel` | string    | No       | —       | Channel to send to. Accepts: channel name ("general", "#random"), or channel ID ("C123..."). Do not use for DMs.                                                                        |
| `user`    | string    | No       | —       | User to send DM to. Accepts: username ("john"), full name ("John Doe"), email ("[john.doe@company.com](mailto:john.doe@company.com)"), or user ID ("U123..."). Do not use for channels. |
| `text`    | string    | No       | —       | Message text to send. Required if blocks not provided. If blocks provided, this is fallback text for notifications.                                                                     |
| `blocks`  | object\[] | No       | —       | Block Kit blocks array for rich formatting. Use display-only blocks (section, header, divider, image, context). DO NOT use interactive elements.                                        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "channel": {
        "type": "string",
        "description": "Channel to send to. Accepts: channel name (\"general\", \"#random\"), or channel ID (\"C123...\"). Do not use for DMs."
      },
      "user": {
        "type": "string",
        "description": "User to send DM to. Accepts: username (\"john\"), full name (\"John Doe\"), email (\"john.doe@company.com\"), or user ID (\"U123...\"). Do not use for channels."
      },
      "text": {
        "type": "string",
        "description": "Message text to send. Required if blocks not provided. If blocks provided, this is fallback text for notifications."
      },
      "blocks": {
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": true
        },
        "description": "Block Kit blocks array for rich formatting. Use display-only blocks (section, header, divider, image, context). DO NOT use interactive elements."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## slack\_get\_channel\_history

Retrieve message history from any Slack channel with intelligent name resolution. Accepts channel names ("engineering", "#general") or channel IDs ("C123..."). Returns recent messages with timestamps, user info, and text content.

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                                    |
| ---------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------- |
| `channel`        | string  | Yes      | —       | Channel name (with or without #) or channel ID                                                 |
| `limit`          | number  | No       | `5`     | Maximum number of messages to return (default: 5)                                              |
| `after`          | string  | No       | —       | Filter by time: only messages after this timestamp (ISO format, e.g., "2025-12-16T00:00:00Z")  |
| `before`         | string  | No       | —       | Filter by time: only messages before this timestamp (ISO format, e.g., "2025-12-17T00:00:00Z") |
| `showAllDetails` | boolean | No       | `false` | If true, includes full message metadata; if false (default), shows only essential fields       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "channel": {
        "type": "string",
        "description": "Channel name (with or without #) or channel ID"
      },
      "limit": {
        "type": "number",
        "default": 5,
        "description": "Maximum number of messages to return (default: 5)"
      },
      "after": {
        "type": "string",
        "description": "Filter by time: only messages after this timestamp (ISO format, e.g., \"2025-12-16T00:00:00Z\")"
      },
      "before": {
        "type": "string",
        "description": "Filter by time: only messages before this timestamp (ISO format, e.g., \"2025-12-17T00:00:00Z\")"
      },
      "showAllDetails": {
        "type": "boolean",
        "default": false,
        "description": "If true, includes full message metadata; if false (default), shows only essential fields"
      }
    },
    "required": [
      "PCID",
      "channel"
    ]
  }
  ```
</Expandable>

***

## slack\_add\_reaction

Add an emoji reaction to a Slack message with smart filtering. Can react to: specific message (message\_ts), latest message, nth message (position), user's message, message containing text, or combinations of filters. Automatically finds and reacts to the matching message.

**Parameters:**

| Parameter         | Type   | Required | Default | Description                                                                                                                       |
| ----------------- | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `channel`         | string | Yes      | —       | Channel name (with or without #) or channel ID                                                                                    |
| `reaction`        | string | Yes      | —       | Emoji name without colons (e.g., "thumbsup", "fire", "eyes")                                                                      |
| `message_ts`      | string | No       | —       | Direct message timestamp to react to (Unix with microseconds, e.g., "1762357394.535179"). If provided, ignores all other filters. |
| `user_identifier` | string | No       | —       | Filter by user: username, email, or user ID (e.g., "john", "[john@company.com](mailto:john@company.com)", "U123ABC")              |
| `contains_text`   | string | No       | —       | Filter by content: react to message containing this text (case-insensitive)                                                       |
| `position`        | number | No       | `1`     | Which message to react to from filtered results: 1=latest (default), 2=2nd latest, etc.                                           |
| `after`           | string | No       | —       | Filter by time: only messages after this timestamp (ISO format, e.g., "2025-12-16T00:00:00Z")                                     |
| `before`          | string | No       | —       | Filter by time: only messages before this timestamp (ISO format, e.g., "2025-12-17T00:00:00Z")                                    |
| `search_limit`    | number | No       | `100`   | Maximum number of recent messages to search through (default: 100)                                                                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "channel": {
        "type": "string",
        "description": "Channel name (with or without #) or channel ID"
      },
      "reaction": {
        "type": "string",
        "description": "Emoji name without colons (e.g., \"thumbsup\", \"fire\", \"eyes\")"
      },
      "message_ts": {
        "type": "string",
        "description": "Direct message timestamp to react to (Unix with microseconds, e.g., \"1762357394.535179\"). If provided, ignores all other filters."
      },
      "user_identifier": {
        "type": "string",
        "description": "Filter by user: username, email, or user ID (e.g., \"john\", \"john@company.com\", \"U123ABC\")"
      },
      "contains_text": {
        "type": "string",
        "description": "Filter by content: react to message containing this text (case-insensitive)"
      },
      "position": {
        "type": "number",
        "default": 1,
        "description": "Which message to react to from filtered results: 1=latest (default), 2=2nd latest, etc."
      },
      "after": {
        "type": "string",
        "description": "Filter by time: only messages after this timestamp (ISO format, e.g., \"2025-12-16T00:00:00Z\")"
      },
      "before": {
        "type": "string",
        "description": "Filter by time: only messages before this timestamp (ISO format, e.g., \"2025-12-17T00:00:00Z\")"
      },
      "search_limit": {
        "type": "number",
        "default": 100,
        "description": "Maximum number of recent messages to search through (default: 100)"
      }
    },
    "required": [
      "PCID",
      "channel",
      "reaction"
    ]
  }
  ```
</Expandable>

***

## slack\_reply\_to\_thread

Post a reply to an existing message thread with smart filtering. Supports plain text or rich Block Kit formatting. Can reply to: specific thread (thread\_ts), latest thread, user's thread, thread containing text, or combinations. WARNING: When using Block Kit blocks, DO NOT use interactive elements (buttons, menus, inputs).

**Parameters:**

| Parameter         | Type      | Required | Default | Description                                                                                                                      |
| ----------------- | --------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `channel`         | string    | Yes      | —       | Channel name (with or without #) or channel ID                                                                                   |
| `thread_ts`       | string    | No       | —       | Direct thread timestamp to reply to (Unix with microseconds, e.g., "1762357394.535179"). If provided, ignores all other filters. |
| `text`            | string    | No       | —       | Reply text content. Required if blocks not provided. If blocks provided, this is fallback text.                                  |
| `blocks`          | object\[] | No       | —       | Block Kit blocks array for rich formatting. Use display-only blocks. DO NOT use interactive elements.                            |
| `user_identifier` | string    | No       | —       | Filter by user: find thread started by this user (username, email, or user ID)                                                   |
| `contains_text`   | string    | No       | —       | Filter by content: find thread whose parent message contains this text (case-insensitive)                                        |
| `position`        | number    | No       | `1`     | Which thread to reply to from filtered results: 1=latest thread (default), 2=2nd latest, etc.                                    |
| `after`           | string    | No       | —       | Filter by time: only threads started after this timestamp (ISO format)                                                           |
| `before`          | string    | No       | —       | Filter by time: only threads started before this timestamp (ISO format)                                                          |
| `search_limit`    | number    | No       | `100`   | Maximum number of recent messages to search through (default: 100)                                                               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "channel": {
        "type": "string",
        "description": "Channel name (with or without #) or channel ID"
      },
      "thread_ts": {
        "type": "string",
        "description": "Direct thread timestamp to reply to (Unix with microseconds, e.g., \"1762357394.535179\"). If provided, ignores all other filters."
      },
      "text": {
        "type": "string",
        "description": "Reply text content. Required if blocks not provided. If blocks provided, this is fallback text."
      },
      "blocks": {
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": true
        },
        "description": "Block Kit blocks array for rich formatting. Use display-only blocks. DO NOT use interactive elements."
      },
      "user_identifier": {
        "type": "string",
        "description": "Filter by user: find thread started by this user (username, email, or user ID)"
      },
      "contains_text": {
        "type": "string",
        "description": "Filter by content: find thread whose parent message contains this text (case-insensitive)"
      },
      "position": {
        "type": "number",
        "default": 1,
        "description": "Which thread to reply to from filtered results: 1=latest thread (default), 2=2nd latest, etc."
      },
      "after": {
        "type": "string",
        "description": "Filter by time: only threads started after this timestamp (ISO format)"
      },
      "before": {
        "type": "string",
        "description": "Filter by time: only threads started before this timestamp (ISO format)"
      },
      "search_limit": {
        "type": "number",
        "default": 100,
        "description": "Maximum number of recent messages to search through (default: 100)"
      }
    },
    "required": [
      "PCID",
      "channel"
    ]
  }
  ```
</Expandable>

***

## slack\_get\_thread\_replies

Retrieve replies from a message thread with smart filtering. Can get: specific thread (thread\_ts), latest thread, user's thread, thread containing text, or combinations. Returns parent message and all replies.

**Parameters:**

| Parameter         | Type    | Required | Default | Description                                                                                                                              |
| ----------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `channel`         | string  | Yes      | —       | Channel name (with or without #) or channel ID                                                                                           |
| `thread_ts`       | string  | No       | —       | Direct thread timestamp to get replies from (Unix with microseconds, e.g., "1762357394.535179"). If provided, ignores all other filters. |
| `user_identifier` | string  | No       | —       | Filter by user: find thread started by this user (username, email, or user ID)                                                           |
| `contains_text`   | string  | No       | —       | Filter by content: find thread whose parent message contains this text (case-insensitive)                                                |
| `position`        | number  | No       | `1`     | Which thread to get replies from: 1=latest thread (default), 2=2nd latest, etc.                                                          |
| `after`           | string  | No       | —       | Filter by time: only threads started after this timestamp (ISO format)                                                                   |
| `before`          | string  | No       | —       | Filter by time: only threads started before this timestamp (ISO format)                                                                  |
| `limit`           | number  | No       | `10`    | Maximum number of replies to return per thread (default: 10)                                                                             |
| `search_limit`    | number  | No       | `100`   | Maximum number of recent messages to search for thread parent (default: 100)                                                             |
| `showAllDetails`  | boolean | No       | `false` | If true, includes full message metadata; if false (default), shows only essential fields                                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "channel": {
        "type": "string",
        "description": "Channel name (with or without #) or channel ID"
      },
      "thread_ts": {
        "type": "string",
        "description": "Direct thread timestamp to get replies from (Unix with microseconds, e.g., \"1762357394.535179\"). If provided, ignores all other filters."
      },
      "user_identifier": {
        "type": "string",
        "description": "Filter by user: find thread started by this user (username, email, or user ID)"
      },
      "contains_text": {
        "type": "string",
        "description": "Filter by content: find thread whose parent message contains this text (case-insensitive)"
      },
      "position": {
        "type": "number",
        "default": 1,
        "description": "Which thread to get replies from: 1=latest thread (default), 2=2nd latest, etc."
      },
      "after": {
        "type": "string",
        "description": "Filter by time: only threads started after this timestamp (ISO format)"
      },
      "before": {
        "type": "string",
        "description": "Filter by time: only threads started before this timestamp (ISO format)"
      },
      "limit": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of replies to return per thread (default: 10)"
      },
      "search_limit": {
        "type": "number",
        "default": 100,
        "description": "Maximum number of recent messages to search for thread parent (default: 100)"
      },
      "showAllDetails": {
        "type": "boolean",
        "default": false,
        "description": "If true, includes full message metadata; if false (default), shows only essential fields"
      }
    },
    "required": [
      "PCID",
      "channel"
    ]
  }
  ```
</Expandable>

***

## slack\_list\_files

List files shared in the Slack workspace with smart filtering. Can filter by channel, user, file type, or combinations. Returns file metadata including download URLs, sizes, and creators. Useful for finding recently shared documents, images, or other files.

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                          |
| ---------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------ |
| `channel`        | string  | No       | —       | Filter by channel: channel name (with or without #) or channel ID                    |
| `user`           | string  | No       | —       | Filter by user: username, email, or user ID of file uploader                         |
| `count`          | number  | No       | `10`    | Number of files to return (default: 10)                                              |
| `types`          | string  | No       | —       | Filter by file type: "images", "pdfs", "zips", "gdocs", "all" (default: all)         |
| `showAllDetails` | boolean | No       | `false` | If true, includes all file metadata; if false (default), shows only essential fields |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "channel": {
        "type": "string",
        "description": "Filter by channel: channel name (with or without #) or channel ID"
      },
      "user": {
        "type": "string",
        "description": "Filter by user: username, email, or user ID of file uploader"
      },
      "count": {
        "type": "number",
        "default": 10,
        "description": "Number of files to return (default: 10)"
      },
      "types": {
        "type": "string",
        "description": "Filter by file type: \"images\", \"pdfs\", \"zips\", \"gdocs\", \"all\" (default: all)"
      },
      "showAllDetails": {
        "type": "boolean",
        "default": false,
        "description": "If true, includes all file metadata; if false (default), shows only essential fields"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## slack\_get\_dm\_history

Get message history from a direct message conversation with smart user resolution. Accepts username, email, or user ID to identify the DM partner. Returns recent DM messages with timestamps and content. Useful for reviewing past DM conversations.

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                                                              |
| ---------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
| `user`           | string  | Yes      | —       | DM partner: username, email, or user ID (e.g., "john", "[john.doe@company.com](mailto:john.doe@company.com)", "U123ABC") |
| `limit`          | number  | No       | `10`    | Maximum number of messages to return (default: 10)                                                                       |
| `after`          | string  | No       | —       | Filter by time: only messages after this timestamp (ISO format, e.g., "2025-12-16T00:00:00Z")                            |
| `before`         | string  | No       | —       | Filter by time: only messages before this timestamp (ISO format, e.g., "2025-12-17T00:00:00Z")                           |
| `showAllDetails` | boolean | No       | `false` | If true, includes full message metadata; if false (default), shows only essential fields                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "user": {
        "type": "string",
        "description": "DM partner: username, email, or user ID (e.g., \"john\", \"john.doe@company.com\", \"U123ABC\")"
      },
      "limit": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of messages to return (default: 10)"
      },
      "after": {
        "type": "string",
        "description": "Filter by time: only messages after this timestamp (ISO format, e.g., \"2025-12-16T00:00:00Z\")"
      },
      "before": {
        "type": "string",
        "description": "Filter by time: only messages before this timestamp (ISO format, e.g., \"2025-12-17T00:00:00Z\")"
      },
      "showAllDetails": {
        "type": "boolean",
        "default": false,
        "description": "If true, includes full message metadata; if false (default), shows only essential fields"
      }
    },
    "required": [
      "PCID",
      "user"
    ]
  }
  ```
</Expandable>

***

## slack\_get\_workspace\_info

Get information about the Slack workspace (team). Returns workspace name, domain, team ID, and icon URLs. Useful for identifying which workspace the bot is operating in, especially in multi-workspace scenarios.

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                               |
| ---------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------------------- |
| `showAllDetails` | boolean | No       | `false` | If true, includes all workspace metadata; if false (default), shows only essential fields |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "showAllDetails": {
        "type": "boolean",
        "default": false,
        "description": "If true, includes all workspace metadata; if false (default), shows only essential fields"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## slack\_get\_mentions

Get recent messages where the bot was mentioned with smart filtering. Can filter by channel, time range, or combinations. Returns messages with @bot mentions, useful for finding conversations the bot should respond to or review.

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                                                |
| ---------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `channel`        | string  | No       | —       | Filter by channel: channel name (with or without #) or channel ID. If not provided, searches bot channels. |
| `limit`          | number  | No       | `10`    | Maximum number of mentions to return (default: 10)                                                         |
| `after`          | string  | No       | —       | Filter by time: only mentions after this timestamp (ISO format, e.g., "2025-12-16T00:00:00Z")              |
| `before`         | string  | No       | —       | Filter by time: only mentions before this timestamp (ISO format, e.g., "2025-12-17T00:00:00Z")             |
| `showAllDetails` | boolean | No       | `false` | If true, includes full message metadata; if false (default), shows only essential fields                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "channel": {
        "type": "string",
        "description": "Filter by channel: channel name (with or without #) or channel ID. If not provided, searches bot channels."
      },
      "limit": {
        "type": "number",
        "default": 10,
        "description": "Maximum number of mentions to return (default: 10)"
      },
      "after": {
        "type": "string",
        "description": "Filter by time: only mentions after this timestamp (ISO format, e.g., \"2025-12-16T00:00:00Z\")"
      },
      "before": {
        "type": "string",
        "description": "Filter by time: only mentions before this timestamp (ISO format, e.g., \"2025-12-17T00:00:00Z\")"
      },
      "showAllDetails": {
        "type": "boolean",
        "default": false,
        "description": "If true, includes full message metadata; if false (default), shows only essential fields"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>