bn-slack-mcp-server 0.0.1

package/tools.json

@@ -0,0 +1,483 @@
+{
+  "conversations_history": {
+    "name": "conversations_history",
+    "description": "Retrieve messages from a Slack channel or direct message conversation.\n\n**Primary Use Cases:**\n- Read recent conversations in a channel\n- Get context before posting a message\n- Summarize channel activity\n- Find specific discussions\n\n**Supports:**\n- Channel IDs (C01ABC2DEF3), channel names (#general), and DM shortcuts (@username)\n- Time-based limits (1d, 1w, 30d) or numeric limits (50, 100)\n- Optional user details enrichment for readable output\n- Pagination for large result sets\n\n**Best Practice:** Use time-based limits (e.g., \"1d\") for recent activity; use numeric limits for fixed message counts.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "The Slack channel or direct message to fetch messages from.\n\n**Accepted Formats:**\n1. **Channel ID** (recommended for reliability):\n   - Public channels: C followed by 10 alphanumeric chars (e.g., \"C01ABC2DEF3\")\n   - Private channels: C or G followed by 10 chars\n   - Direct messages: D followed by 10 chars\n   - Group DMs: G followed by 10 chars\n\n2. **Channel Name** (auto-resolved to ID):\n   - \"#general\" - Public channel\n   - \"#engineering-team\" - Hyphenated names work\n\n3. **DM Shortcut** (opens/finds DM with user):\n   - \"@john\" - DM with user named john\n   - \"@john_dm\" - Alternative DM format\n\n**How to Find Channel IDs:**\n- Use `channels_list` tool\n- From Slack URL: https://workspace.slack.com/archives/C01ABC2DEF3\n- In Slack app: Right-click channel -> Copy link"
+        },
+        "limit": {
+          "type": "string",
+          "description": "Controls how many messages to retrieve.\n\n**Time-Based Limits (Recommended):**\n- \"1d\" - Last 1 day (DEFAULT)\n- \"1w\" - Last 7 days\n- \"30d\" - Last 30 days\n\n**Numeric Limits:**\n- \"50\" - Last 50 messages\n- \"100\" - Last 100 messages\n- \"1000\" - Maximum (API limit)\n\n**Choosing the Right Limit:**\n- Daily activity: \"1d\" or \"2d\"\n- Weekly summary: \"1w\"\n- Fixed count: Use numeric like \"50\""
+        },
+        "include_activity_messages": {
+          "type": "boolean",
+          "description": "Whether to include system/activity messages.\n\n**false (DEFAULT):** Only user-posted messages. Best for reading conversations.\n\n**true:** Includes system messages like:\n- \"john joined the channel\"\n- \"Topic changed to: Q4 Planning\"\n- Bot integration messages"
+        },
+        "include_user_details": {
+          "type": "boolean",
+          "description": "Whether to enrich messages with user information.\n\n**true (DEFAULT):** Each message includes user_details:\n- username, real_name, display_name, is_bot\n- No need for separate user_info calls\n\n**false:** Only user ID included. Faster, smaller payload."
+        },
+        "cursor": {
+          "type": "string",
+          "description": "Pagination cursor from previous response.\n\nCheck for \"has_more\": true and \"next_cursor\" in response, then pass next_cursor as cursor for more messages."
+        }
+      },
+      "required": ["channel_id"]
+    }
+  },
+  "conversations_replies": {
+    "name": "conversations_replies",
+    "description": "Get all replies in a message thread.\n\n**Use Cases:**\n- Read full thread discussion\n- Get context on a threaded conversation\n- Find follow-up messages to a question\n\n**Required:** Both channel_id and thread_ts (parent message timestamp).\n\n**Tip:** Find thread_ts from conversations_history - look for messages with \"reply_count\" > 0.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "Channel containing the thread.\n\n**Formats:**\n- Channel ID: \"C01ABC2DEF3\" (recommended)\n- Channel name: \"#general\"\n- DM: \"@username\" or \"D01ABC2DEF3\""
+        },
+        "thread_ts": {
+          "type": "string",
+          "description": "Timestamp of the parent message (thread starter).\n\n**Format:** Unix timestamp with microseconds: \"1609459200.000100\"\n\n**How to Find:**\n1. From conversations_history: Look for \"ts\" field on messages with \"reply_count\" > 0\n2. From Slack URL: https://workspace.slack.com/archives/C01ABC/p1609459200000100\n   - Remove 'p' prefix and insert decimal: 1609459200.000100"
+        },
+        "limit": {
+          "type": "string",
+          "description": "Reply limit. Same format as conversations_history:\n- Time-based: \"1d\", \"1w\"\n- Numeric: \"100\"\n\nMost threads have <100 replies."
+        },
+        "include_activity_messages": {
+          "type": "boolean",
+          "description": "Include system messages within thread. Default: false."
+        },
+        "cursor": {
+          "type": "string",
+          "description": "Pagination cursor for long threads."
+        }
+      },
+      "required": ["channel_id", "thread_ts"]
+    }
+  },
+  "conversations_add_message": {
+    "name": "conversations_add_message",
+    "description": "Send a message to a Slack channel or DM.\n\n**Use Cases:**\n- Post updates to a channel\n- Send DMs to users\n- Reply to threads\n- Make announcements\n\n**Supports:**\n- Slack formatting: *bold*, _italic_, `code`, ```code blocks```\n- Mentions: <@USER_ID>, <!here>, <!channel>\n- Links: <https://url.com|display text>\n- Emojis: :thumbsup: :rocket:\n\n**Markdown Conversion:** When content_type is \"text/markdown\" (default), standard markdown is converted to Slack format.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "Where to post the message.\n\n**Formats:**\n- Channel ID: \"C01ABC2DEF3\" (most reliable)\n- Channel name: \"#general\", \"#announcements\"\n- DM to user: \"@john\" (creates/uses existing DM)\n- DM by ID: \"D01ABC2DEF3\"\n\n**Permissions:**\n- Public channels: chat:write scope\n- Private channels: Must be a member + chat:write\n- DMs: im:write scope"
+        },
+        "payload": {
+          "type": "string",
+          "description": "The message content to send.\n\n**Plain Text:** \"Hello team!\"\n\n**Slack Formatting (mrkdwn):**\n- *bold* -> bold text\n- _italic_ -> italic text\n- `code` -> inline code\n- ```code block``` -> multi-line code\n\n**Links:** <https://example.com|Click here>\n\n**Mentions:**\n- User: <@U01ABC2DEF3> or use @username (auto-resolved)\n- <!here> - notify active members\n- <!channel> - notify all members\n\n**Emojis:** :thumbsup: :rocket: :white_check_mark:\n\n**Example:** \"*Important:* Deployment complete :white_check_mark: <!here>\""
+        },
+        "thread_ts": {
+          "type": "string",
+          "description": "Reply to a specific thread (optional).\n\n**Format:** \"1609459200.000100\" (parent message ts)\n\n**Behavior:**\n- If provided: Posts as reply in thread\n- If omitted: Posts as new message in channel"
+        },
+        "content_type": {
+          "type": "string",
+          "description": "Content type of the message.\n\n**\"text/markdown\" (DEFAULT):** Markdown converted to Slack mrkdwn\n**\"text/plain\":** Message sent as-is without conversion"
+        }
+      },
+      "required": ["channel_id", "payload"]
+    }
+  },
+  "conversations_search_messages": {
+    "name": "conversations_search_messages",
+    "description": "Search for messages across Slack using text queries and filters.\n\n**Use Cases:**\n- Find past discussions about a topic\n- Locate messages from a specific person\n- Retrieve a specific message by URL\n- Search within date ranges\n\n**URL Lookup:** Paste a Slack message URL directly to retrieve that exact message.\n\n**Search Operators:** Combine search_query with filters for precise results:\n- search_query=\"deployment\" + filter_in_channel=\"#engineering\"\n- filter_users_from=\"@john\" + filter_date_after=\"2024-01-01\"\n\n**Note:** Either search_query OR at least one filter is required.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "search_query": {
+          "type": "string",
+          "description": "Search term(s) OR a Slack message URL.\n\n**Text Search:**\n- \"quarterly report\" - Messages containing words\n- \"\\\"release notes\\\"\" - Exact phrase match\n\n**URL Lookup:**\n- Paste Slack URL: \"https://workspace.slack.com/archives/C01ABC/p1609459200000100\"\n- Returns that exact message\n\n**Combining with Filters:**\n- search_query=\"deployment\" + filter_in_channel=\"#engineering\"\n- search_query=\"review\" + filter_users_from=\"@john\"\n\n**Note:** Either search_query OR at least one filter required."
+        },
+        "filter_in_channel": {
+          "type": "string",
+          "description": "Restrict search to specific channel.\n\n**Formats:**\n- \"#channel-name\" - By name\n- \"C01ABC2DEF3\" - By ID\n\n**Example:** \"#engineering\" - Only engineering channel"
+        },
+        "filter_in_im_or_mpim": {
+          "type": "string",
+          "description": "Restrict search to DM or group DM.\n\n**Formats:**\n- \"@username\" - DM with user\n- \"D01ABC2DEF3\" - DM by ID\n- \"G01ABC2DEF3\" - Group DM"
+        },
+        "filter_users_from": {
+          "type": "string",
+          "description": "Only messages sent BY a specific user.\n\n**Formats:**\n- \"@john\" - By username\n- \"U01ABC2DEF3\" - By user ID\n\n**Use Case:** Find all updates posted by a specific person"
+        },
+        "filter_users_with": {
+          "type": "string",
+          "description": "Messages in conversations that include a user.\n\n**Difference from filter_users_from:**\n- filter_users_from: Messages SENT BY the user\n- filter_users_with: Messages WHERE the user is present in conversation"
+        },
+        "filter_date_before": {
+          "type": "string",
+          "description": "Messages BEFORE this date.\n\n**Formats:**\n- \"2024-01-15\" - Before January 15, 2024\n- \"yesterday\" - Before yesterday\n- \"last week\" - Before last week"
+        },
+        "filter_date_after": {
+          "type": "string",
+          "description": "Messages AFTER this date.\n\n**Formats:**\n- \"2024-01-01\" - After January 1, 2024\n- \"yesterday\" - After yesterday\n- \"last month\" - After last month"
+        },
+        "filter_date_on": {
+          "type": "string",
+          "description": "Messages on a specific date only.\n\n**Formats:**\n- \"2024-01-15\" - On January 15 only\n- \"today\" - Today only\n- \"yesterday\" - Yesterday only"
+        },
+        "filter_date_during": {
+          "type": "string",
+          "description": "Messages during a named period.\n\n**Formats:**\n- \"today\", \"yesterday\"\n- \"this week\", \"last week\"\n- \"this month\", \"last month\"\n- \"January\", \"Q4\""
+        },
+        "filter_threads_only": {
+          "type": "boolean",
+          "description": "Only return threaded messages.\n\n**true:** Only thread parents and replies\n**false (DEFAULT):** All messages"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum search results (1-100). Default: 20.\n\n**Recommendations:**\n- Quick lookup: 10-20\n- Comprehensive search: 50-100"
+        },
+        "cursor": {
+          "type": "string",
+          "description": "Pagination cursor for more results."
+        }
+      }
+    }
+  },
+  "bulk_conversations_history": {
+    "name": "bulk_conversations_history",
+    "description": "Efficiently fetch messages from MULTIPLE channels in one operation.\n\n**Why Use This:**\n- More efficient than multiple conversations_history calls\n- Single cache load for all channels\n- Better rate limit management\n- Results organized by channel\n\n**Use Cases:**\n- Daily digest from multiple channels\n- Cross-channel activity summary\n- Find messages from one person across channels\n\n**Response Structure:**\n```json\n{\n  \"channels\": [\n    { \"channel_id\": \"C01ABC\", \"messages\": [...], \"message_count\": 50 },\n    { \"channel_id\": \"C02DEF\", \"messages\": [...], \"message_count\": 30 }\n  ],\n  \"summary\": { \"total_messages\": 80, \"api_calls\": 2 }\n}\n```\n\n**Recommendation:** Limit to 5-10 channels per call.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_ids": {
+          "type": "string",
+          "description": "Comma-separated list of channels.\n\n**Formats (can mix):**\n- \"#general, #engineering, #support\"\n- \"C01ABC, C02DEF, C03GHI\"\n- \"#general, C01ABC, @john_dm\"\n\n**Examples:**\n- Team channels: \"#frontend, #backend, #devops\"\n- Project channels: \"#project-alpha, #project-beta\"\n\n**Limit:** Recommend 5-10 channels per call to avoid timeout."
+        },
+        "limit": {
+          "type": "string",
+          "description": "Message limit PER CHANNEL (not total).\n\n**Formats:**\n- \"1d\" (DEFAULT) - Last 24 hours from each\n- \"1w\" - Last 7 days from each\n- \"50\" - Last 50 messages from each"
+        },
+        "include_user_details": {
+          "type": "boolean",
+          "description": "Enrich messages with user details. Default: true.\n\nUses single cached user lookup for efficiency."
+        },
+        "include_activity_messages": {
+          "type": "boolean",
+          "description": "Include system/activity messages. Default: false."
+        },
+        "filter_user": {
+          "type": "string",
+          "description": "Filter to messages from a specific user across ALL channels.\n\n**Formats:**\n- \"@username\" - By username\n- \"U01ABC2DEF3\" - By user ID\n- \"john.doe\" - By name\n\n**Use Case:** See all messages from one person across multiple channels."
+        }
+      },
+      "required": ["channel_ids"]
+    }
+  },
+  "users_list": {
+    "name": "users_list",
+    "description": "Get a list of workspace users with basic information.\n\n**Use Cases:**\n- Find team members\n- Get user IDs for mentions\n- Audit active vs deleted accounts\n- List workspace administrators\n\n**Performance:** Always uses cached data (24h TTL) for fast response.\n\n**Filter Options:**\n- \"active\" - Current users (default)\n- \"deleted\" - Deactivated accounts\n- \"admins\" - Administrators only\n- \"all\" - Everyone",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "filter_type": {
+          "type": "string",
+          "description": "Filter users by account status.\n\n**Options:**\n- \"active\" (DEFAULT) - Users with active accounts\n- \"deleted\" - Deactivated/deleted users\n- \"admins\" - Workspace administrators only\n- \"all\" - All users regardless of status"
+        },
+        "include_bots": {
+          "type": "boolean",
+          "description": "Include bot users in results.\n\n**false (DEFAULT):** Only human users\n**true:** Includes Slackbot, integration bots, apps"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum users to return.\n\n**Default:** 50\n**Set to 0:** Returns all users (no limit)\n\nResults from cache, so large limits are fast."
+        }
+      }
+    }
+  },
+  "user_info": {
+    "name": "user_info",
+    "description": "Get detailed information about one or more users.\n\n**Use Cases:**\n- Get full profile (email, title, phone)\n- Look up user by name or ID\n- Get multiple users at once\n- Verify user details\n\n**Flexible Matching:** Matches username, display_name, or real_name.\n\n**Returns:** Full profile, status (deleted, admin, bot), timezone, profile images.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "user_ids": {
+          "type": "string",
+          "description": "User(s) to get information about.\n\n**Single User:**\n- \"@john\" - By username\n- \"U01ABC2DEF3\" - By user ID\n- \"john\" - Without @ also works\n\n**Multiple Users (comma-separated):**\n- \"@john, @jane, @bob\"\n- \"U01ABC, U02DEF\"\n- \"@john, U01ABC\" - Mixed formats\n\n**Name Matching:** Flexibly matches username, display_name, or real_name"
+        },
+        "use_cache": {
+          "type": "boolean",
+          "description": "Try cache before API calls.\n\n**true (DEFAULT):** Faster, data may be up to 24h old\n**false:** Always fetches fresh from Slack API"
+        }
+      },
+      "required": ["user_ids"]
+    }
+  },
+  "user_presence": {
+    "name": "user_presence",
+    "description": "Check a user's presence status (online, away, etc.).\n\n**Use Cases:**\n- Check if someone is available before messaging\n- Verify if a user is currently online\n- See when someone was last active\n\n**Returns:**\n- presence: \"active\" or \"away\"\n- online: true/false\n- auto_away: true if Slack set away automatically\n- manual_away: true if user set away manually\n- last_activity: timestamp",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "user_id": {
+          "type": "string",
+          "description": "The user to check presence for.\n\n**Formats:**\n- \"@username\" - By username\n- \"U01ABC2DEF3\" - By user ID"
+        }
+      },
+      "required": ["user_id"]
+    }
+  },
+  "channel_info": {
+    "name": "channel_info",
+    "description": "Get detailed information about a specific channel.\n\n**Use Cases:**\n- Get channel topic and purpose\n- Check member count\n- Verify channel exists before posting\n- Get channel metadata\n\n**Returns:**\n- Basic: name, id, created timestamp\n- Content: topic, purpose\n- Membership: member_count, is_member\n- Status: is_archived, is_private",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "The channel to get information about.\n\n**Formats:**\n- \"C01ABC2DEF3\" - Channel ID (recommended)\n- \"#general\" - Channel name\n- \"@username_dm\" - DM channel"
+        },
+        "include_locale": {
+          "type": "boolean",
+          "description": "Include locale/language information. Usually not needed. Default: false."
+        },
+        "use_cache": {
+          "type": "boolean",
+          "description": "Try cache first (6h TTL for channels).\n\n**true (DEFAULT):** Fast response from cache\n**false:** Fresh data from Slack API"
+        }
+      },
+      "required": ["channel_id"]
+    }
+  },
+  "channel_members": {
+    "name": "channel_members",
+    "description": "Get list of members in a channel with their details.\n\n**Use Cases:**\n- See who's in a channel\n- Verify channel membership\n- Find admins/bots in channel\n- Get member count\n\n**Returns:** List with user ID, username, real_name, display_name, admin status, bot status.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "The channel to list members of.\n\n**Formats:**\n- \"C01ABC2DEF3\" - Channel ID\n- \"#general\" - Channel name"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum members to return (1-1000). Default: 100.\n\nFor large channels, use pagination with cursor."
+        },
+        "cursor": {
+          "type": "string",
+          "description": "Pagination cursor from previous response.\n\nUse for channels with 100+ members."
+        }
+      },
+      "required": ["channel_id"]
+    }
+  },
+  "channels_list": {
+    "name": "channels_list",
+    "description": "Get list of channels by type.\n\n**Use Cases:**\n- Browse available channels\n- Find channel IDs for other operations\n- List DMs and group DMs\n- Find popular channels (by member count)\n\n**Channel Types:**\n- public_channel - Public channels\n- private_channel - Private channels (only those you're in)\n- im - Direct messages\n- mpim - Group direct messages",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_types": {
+          "type": "string",
+          "description": "Types of channels to list (comma-separated).\n\n**Options:**\n- \"public_channel\" - Public channels\n- \"private_channel\" - Private channels (only those you're in)\n- \"im\" - Direct messages (1:1)\n- \"mpim\" - Group DMs\n\n**Examples:**\n- \"public_channel\" - Just public\n- \"public_channel,private_channel\" - All regular channels\n- \"im,mpim\" - All direct messages"
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sort order.\n\n**Options:**\n- \"popularity\" - Sort by member count (most first)\n- (omit) - Default Slack API order"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum channels (1-999). Default: 100."
+        },
+        "cursor": {
+          "type": "string",
+          "description": "Pagination cursor for workspaces with many channels."
+        }
+      },
+      "required": ["channel_types"]
+    }
+  },
+  "channels_detailed": {
+    "name": "channels_detailed",
+    "description": "Get comprehensive channel list with details.\n\n**Use Cases:**\n- Get channel overview with metadata\n- Compare channels by member count\n- Export channel list with details\n\n**Difference from channels_list:**\n- More detailed information\n- Optional extra API calls for full details\n- Single efficient call vs N individual calls",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_types": {
+          "type": "string",
+          "description": "Channel types to fetch.\n\n**Default:** \"public_channel,private_channel\"\n\n**Options:** Same as channels_list"
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sort by \"popularity\" (member count) or omit for default."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum channels (1-999). Default: 100."
+        },
+        "include_detailed_info": {
+          "type": "boolean",
+          "description": "Fetch extra details with additional API calls.\n\n**false (DEFAULT):** Single API call, basic info, fast\n**true:** Additional call per channel, full details, slower\n\nRecommendation: Use false unless you need every detail."
+        }
+      }
+    }
+  },
+  "set_channel_topic": {
+    "name": "set_channel_topic",
+    "description": "Set the topic for a channel.\n\n**Use Cases:**\n- Update channel topic for a project phase\n- Set meeting schedule in topic\n- Add important links/info to topic\n\n**Display:** Topic shows at the top of the channel.\n**Max Length:** 250 characters.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "Channel to update topic.\n\n**Formats:** \"C01ABC2DEF3\" or \"#channel-name\"\n\n**Permissions:** Must have channel edit permissions."
+        },
+        "topic": {
+          "type": "string",
+          "description": "New topic text (max 250 chars, plain text).\n\n**Examples:**\n- \"Q4 Planning - Meeting Thursdays at 2pm\"\n- \"Support escalations - @oncall for urgent\"\n- \"Read-only announcements channel\""
+        }
+      },
+      "required": ["channel_id", "topic"]
+    }
+  },
+  "set_channel_purpose": {
+    "name": "set_channel_purpose",
+    "description": "Set the purpose for a channel.\n\n**Use Cases:**\n- Describe what the channel is for\n- Set guidelines for channel usage\n- Help new members understand the channel\n\n**Display:** Purpose shows in channel details/about section.\n**Max Length:** 250 characters.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "Channel to update purpose.\n\n**Formats:** \"C01ABC2DEF3\" or \"#channel-name\""
+        },
+        "purpose": {
+          "type": "string",
+          "description": "New purpose text (max 250 chars).\n\n**Examples:**\n- \"Engineering team discussions and updates\"\n- \"Customer support ticket escalations\"\n- \"Random watercooler chat and team bonding\""
+        }
+      },
+      "required": ["channel_id", "purpose"]
+    }
+  },
+  "message_permalink": {
+    "name": "message_permalink",
+    "description": "Get a permanent link to a specific message.\n\n**Use Cases:**\n- Share message references\n- Create links that work across Slack clients\n- Reference specific messages in documentation\n\n**Returns:** Permanent URL like:\nhttps://workspace.slack.com/archives/C01ABC/p1609459200000100",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "Channel containing the message.\n\n**Formats:** \"C01ABC2DEF3\" or \"#channel-name\""
+        },
+        "message_ts": {
+          "type": "string",
+          "description": "Timestamp of the message.\n\n**Format:** \"1609459200.000100\" (Unix timestamp with microseconds)\n\n**Source:** From \"ts\" field in any message object."
+        }
+      },
+      "required": ["channel_id", "message_ts"]
+    }
+  },
+  "add_reaction": {
+    "name": "add_reaction",
+    "description": "Add an emoji reaction to a message.\n\n**Use Cases:**\n- Acknowledge messages with reactions\n- Add emoji responses (thumbsup, checkmark, etc.)\n- Indicate message status with reactions\n\n**Important:** Use emoji name WITHOUT colons.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "Channel containing the message.\n\n**Formats:** \"C01ABC2DEF3\" or \"#channel-name\""
+        },
+        "message_ts": {
+          "type": "string",
+          "description": "Timestamp of the message to react to.\n\n**Format:** \"1609459200.000100\"\n**Source:** From message \"ts\" field"
+        },
+        "emoji_name": {
+          "type": "string",
+          "description": "Emoji name WITHOUT colons.\n\n**Common Emojis:**\n- \"thumbsup\" - NOT \":thumbsup:\"\n- \"thumbsdown\"\n- \"heart\"\n- \"rocket\"\n- \"eyes\"\n- \"white_check_mark\"\n- \"x\"\n- \"thinking_face\"\n- \"tada\"\n- \"fire\"\n- \"+1\" (same as thumbsup)\n\n**Custom Emojis:** Your workspace's custom emojis work too."
+        }
+      },
+      "required": ["channel_id", "message_ts", "emoji_name"]
+    }
+  },
+  "files_list": {
+    "name": "files_list",
+    "description": "List files shared in the workspace.\n\n**Use Cases:**\n- Find files shared in a channel\n- List files uploaded by a user\n- Filter by file type (images, PDFs, etc.)\n- Get file metadata and URLs\n\n**Returns:** File name, type, size, URLs, uploader, timestamps.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "channel_id": {
+          "type": "string",
+          "description": "Filter to files shared in a specific channel.\n\n**Formats:** \"C01ABC2DEF3\" or \"#channel-name\"\n\n**Omit:** Returns files from all accessible channels."
+        },
+        "user_id": {
+          "type": "string",
+          "description": "Filter to files uploaded by a specific user.\n\n**Formats:** \"@username\" or \"U01ABC2DEF3\"\n\n**Omit:** Returns files from all users."
+        },
+        "count": {
+          "type": "number",
+          "description": "Number of files to return (1-1000). Default: 10.\n\nStart with 10-20, increase if needed."
+        },
+        "types": {
+          "type": "string",
+          "description": "Filter by file type(s).\n\n**Options:**\n- \"all\" (DEFAULT) - All file types\n- \"images\" - png, jpg, gif\n- \"videos\" - mp4, mov\n- \"pdfs\" - PDF documents\n- \"docs\" - Word documents\n- \"gdocs\" - Google Docs\n- \"zips\" - Compressed files\n- \"spaces\" - Slack posts/snippets\n\n**Multiple types:** \"images,pdfs\""
+        }
+      }
+    }
+  },
+  "workspace_info": {
+    "name": "workspace_info",
+    "description": "Get information about the current Slack workspace/team.\n\n**Use Cases:**\n- Verify which workspace you're connected to\n- Get workspace domain for building URLs\n- Check Enterprise Grid membership\n\n**No parameters required.**\n\n**Returns:**\n- id: Team/workspace ID (T01ABC2DEF3)\n- name: Workspace name\n- domain: Slack domain (for URLs)\n- email_domain: Email domain for members\n- enterprise_id/name (if applicable)\n\n**Required Scope:** team:read",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
+  },
+  "initialize_cache": {
+    "name": "initialize_cache",
+    "description": "Pre-populate local caches with users and channels from Slack API.\n\n**Use Cases:**\n- Call at START of a session for faster subsequent calls\n- Warm up cache for name resolution (@username, #channel)\n- Ensure users_list and channel_info are fast\n\n**What It Does:**\n1. Fetches all users -> ~/slack-cache/users_cache.json\n2. Fetches all channels -> ~/slack-cache/channels_cache_v2.json\n\n**Cache Duration:**\n- Users: 24 hours TTL\n- Channels: 6 hours TTL\n\n**No parameters required.**",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
+  },
+  "cache_info": {
+    "name": "cache_info",
+    "description": "Get details about the local cache files.\n\n**Use Cases:**\n- Debug why name resolution isn't working\n- Check if cache is stale\n- Verify cache was created successfully\n\n**Returns:**\n- File paths (absolute locations)\n- File sizes (KB)\n- Last modified times\n- Age in hours\n- Freshness status (is_fresh)\n\n**No parameters required.**",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
+  },
+  "clear_cache": {
+    "name": "clear_cache",
+    "description": "Clear cache files to force refresh from Slack API.\n\n**Use Cases:**\n- Force refresh when data seems stale\n- After workspace changes (new users, new channels)\n- Troubleshooting resolution issues\n\n**After Clearing:** Cache files recreated on next API call.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "cache_type": {
+          "type": "string",
+          "enum": ["users", "channels", "both"],
+          "description": "Which cache to clear.\n\n**Options:**\n- \"both\" (DEFAULT) - Clear users AND channels\n- \"users\" - Clear only users cache\n- \"channels\" - Clear only channels cache"
+        }
+      }
+    }
+  },
+  "check_permissions": {
+    "name": "check_permissions",
+    "description": "Test what Slack API scopes/permissions the current token has.\n\n**Use Cases:**\n- Debug \"permission denied\" errors\n- Verify token has needed scopes\n- Check what operations are possible\n\n**Tests These Scopes:**\n- users:read - Can list users\n- channels:read - Can list public channels\n- groups:read - Can list private channels\n- im:read - Can list DMs\n- mpim:read - Can list group DMs\n- team:read - Can get workspace info\n- channels:history - Can read messages\n- chat:write - Can send messages\n\n**Returns:** Status for each scope, recommendations.\n\n**No parameters required.**",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
+  },
+  "analytics_summary": {
+    "name": "analytics_summary",
+    "description": "Get basic workspace analytics from cached data.\n\n**Use Cases:**\n- Quick workspace overview\n- Understand team size\n- Count channels by type\n\n**Returns:**\n- User stats: total, active, bots, admins\n- Channel stats: public, private, DMs, group DMs\n\n**Data Source:** Uses cached data, not real-time metrics.\nProvides snapshot of workspace structure.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "date_range": {
+          "type": "string",
+          "description": "Time period label (affects label, not data).\n\n**Options:**\n- \"7d\" - Label as 7-day period\n- \"30d\" (DEFAULT) - Label as 30-day period\n- \"90d\" - Label as 90-day period\n\n**Note:** Analytics based on cached data, not historical."
+        }
+      }
+    }
+  }
+}