# Flock MCP for AI Agents AI Agent Connect > Flock MCP lets your agent handle team chat, manage private groups, and pull user data from your Flock workspace. Send rich messages using FlockML and audit channel memberships without switching tabs. It connects your bot to your agent so you can manage everything through plain text. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_pNodqaVfbHsRl8x4OXRHVJDVh7pxVSSAqOoVRDeO/ai-agent-connect - **Tags:** team-chat, instant-messaging, rich-messaging, workspace-management, channel-automation, roster-management ## Description This Flock MCP puts your team's communication under your agent's control. Instead of hunting through different channels or manually checking who's in which group, you can just ask your agent to do it. It handles the heavy lifting of navigating your Flock workspace, whether you're trying to find a specific public channel or need to see the exact membership of a private group. You can pull historical chat logs to see what went down in a thread or grab profile metadata like time zones and LDAP properties for your team. It even understands FlockML, meaning your agent can send out rich, formatted announcements with attachments that actually look good. It's a huge time saver if you're tired of the manual overhead of managing a large workspace. You can find this in the Vinkius catalog to get your bot connected in minutes. It makes it easy to audit your IAM boundaries and see exactly who has read permissions on sensitive groups. You can also map out your company's roster, turning @mentions into actual UUIDs so your agent never sends a message to the wrong person. It's about taking the manual work out of team coordination and letting your agent handle the data retrieval. Whether you're looking for a specific user's time zone or trying to find every public channel in a massive workspace, this connection gives your agent the eyes it needs to see the whole picture. ## Tools ### channels_get_info Get the description and banner details for a specific channel. This helps your agent understand the purpose of different rooms. ### channels_list_public See a list of all public channels in your Flock workspace. It's great for quickly finding the right place to post. ### channels_list_members See every active user in a specific channel. Use this to verify who can see certain messages. ### groups_list_members Check who has read permissions for a specific group. This is essential for auditing sensitive message targets. ### roster_list_directory Map user aliases like @names to their actual UUIDs. This ensures your agent routes messages to the right people. ### chat_send_message Send a message to a chat room. It handles FlockML to create rich attachments and formatted layouts. ### chat_fetch_messages Pull the recent history from a Flock room. You get the raw data for any past conversation. ### users_get_metadata Get profile info like time zones and LDAP properties for a user. It's perfect for understanding your team's setup. ### groups_get_info Look up the internal details of a private group. Use this to see how hidden groups are configured. ### groups_list_private Find all the private groups in your workspace. It helps you see the boundaries of your team's private chats. ## Prompt Examples **Prompt:** ``` Send a message to the #announcements channel about the new holiday schedule. ``` **Response:** ``` I've sent that out. Since you're using the Flock MCP, I used FlockML to make sure the announcement has a clean layout and the dates are easy to read. I've also tagged the #announcements channel specifically. ✅ ``` **Prompt:** ``` Who is in the 'Project X' private group? ``` **Response:** ``` Checking the permissions for 'Project X' now... **Group Members:** - Jane Doe (u:123) - John Smith (u:456) - Alex Chen (u:789) I've verified these are the only active UUIDs with read permissions for that group. ``` **Prompt:** ``` What's the time zone for @sarah_j? ``` **Response:** ``` I've pulled the metadata for @sarah_j. - **Name:** Sarah Jenkins - **Time Zone:** America/Los_Angeles - **Status:** Active She's currently in 3 private groups. ``` ## Capabilities ### Send rich messages Use FlockML to send formatted layouts and enterprise attachments. ### Audit group members Check who has read permissions on private groups to keep things secure. ### Pull chat history Fetch raw JSON logs from any room to see past conversations. ### Map user aliases Turn @mentions into actual UUIDs for accurate routing across the company. ### Extract user metadata Get profile details like time zones and SSO properties from your team. ### Discover public channels List all active public environments in your workspace at once. ## Use Cases ### Auditing permissions An IT admin asks the agent to check who has access to the 'Finance' private group to ensure only the right people are in. ### Sending announcements A team lead tells the agent to send a formatted update to a public channel using FlockML to include a link and a banner. ### Onboarding research A manager asks the agent to pull the last 20 messages from a project room to see what was discussed last week. ### User lookups A dev asks the agent for the time zone of a specific user to schedule a meeting without searching through profiles. ## Benefits - Send rich formatted messages. Use chat_send_message with FlockML to send professional layouts and attachments. - Audit team permissions. Use groups_list_members to verify who has access to sensitive private groups. - Map your company roster. Use roster_list_directory to turn @mentions into accurate routing for your agent. - Pull historical data. Use chat_fetch_messages to grab raw JSON logs from any room for analysis. - Get deep user profiles. Use users_get_metadata to see time zones and SSO properties for everyone in the company. - Discover workspace structure. Use channels_list_public to see all your public environments in one go. ## How It Works The bottom line is you get a direct bridge between your AI agent and your Flock workspace. 1. Grab your Flock Bot Token from the Developer Dashboard 2. Plug that token into your agent's configuration 3. Start asking your agent to manage channels or send messages ## Frequently Asked Questions **Can the Flock MCP send formatted messages?** Yes, it supports FlockML. This means your agent can send rich layouts and enterprise attachments instead of just plain text. **How does the Flock MCP handle private groups?** It can identify bounded private groups and show you the precise definitions of who has access, making it easy to audit your workspace. **Can I use the Flock MCP to see who is in a channel?** Yes, it can list the active members of any channel so you can verify who is seeing your messages. **Can the Flock MCP pull old chat history?** It can fetch chronological logs from any room as raw JSON objects, which is great for looking back at past decisions. **Does the Flock MCP work with my existing bot?** Yes, you just need to provide your Flock Bot Token from the developer dashboard to connect it to your agent. **Can the Flock MCP find user details?** It can extract profile metadata like time zones and LDAP properties for any user in your company roster. **Can my agent send formatted messages using FlockML?** Yes. Use the 'chat_send_message' tool and provide your XML string in the 'flockml' parameter. The agent will bypass standard Markdown limits to render rich enterprise attachments and layouts natively in Flock. **How do I list all members of a specific private group via chat?** Use the 'groups_list_members' tool. Provide the Group UUID. Your agent will surface the explicitly mapped profiles within that group, helping you verify sensitive message targets securely. **Can I search for a user's UUID using their '@' alias through the agent?** Absolutely. The 'roster_list_directory' tool discovers global identity blocks mapping direct aliases to absolute string UUIDs, ensuring you can route messages accurately to anyone in your company.