# Beekeeper MCP for AI Agents MCP > Beekeeper MCP connects your agent directly to your internal communication platform. You can manage entire organizational structures—from listing employees and channels to sending private messages—all through natural conversation with your AI client. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** frontline-workers, internal-communications, employee-engagement, team-management, workplace-productivity ## Description Managing a large, distributed workforce means juggling multiple tools: checking who’s on the roster, figuring out which announcement channel is active, and then manually posting the update. This MCP changes that. It lets your agent talk directly to your Beekeeper account, giving you complete control over internal comms and team data right where you work. Instead of logging into a dashboard just to find contact details or check group membership, you simply ask your AI client. Your agent can list all active communication channels, retrieve the full chat history between two specific people, or post an urgent announcement across multiple streams—all without lifting a finger. When integrated via Vinkius, it gives your workflow access to thousands of tools, making internal communications management totally hands-free. ## Tools ### list_posts Retrieves all the content written in a specific communication stream (channel). ### search_users Finds employee profiles using either a name or an email address. ### list_streams Lists every active discussion channel available across your organization. ### list_users Generates a complete roster of all users within the platform. ### create_post Publishes an announcement or update to a designated communication stream. ### send_message Initiates private, one-on-one chats with any user in the system. ### get_tenant_info Gathers administrative data about your entire company's Beekeeper account setup. ### get_user Pulls detailed profile information for a single specified employee. ### list_groups Retrieves a list of all defined functional groups (e.g., 'Sales', 'Logistics'). ### list_messages Fetches the conversation history for a specific chat thread. ## Prompt Examples **Prompt:** ``` Can you show me who is on the Sales team and what their email addresses are? ``` **Response:** ``` **Sales Team Roster** * John Smith (ID: u_123): john.smith@corp.com * Maria Garcia (ID: u_456): maria.garcia@corp.com * David Lee (ID: u_789): david.lee@corp.com You can also view their full group membership list by calling the `list_groups` tool. ``` **Prompt:** ``` What was the outcome of last week's meeting in the Operations Updates stream? ``` **Response:** ``` I pulled the latest messages from 'Operations Updates'. Key takeaways include: * **New Protocol:** Safety protocols start Monday (Posted by HR). * **Equipment Status:** The forklift maintenance is scheduled for Tuesday afternoon. * **Follow-up:** Team needs to submit their updated shift schedules by end of day. ``` **Prompt:** ``` Send a quick message to Sarah Miller and ask her about the Q3 budget. ``` **Response:** ``` ✅ Message sent to Sarah Miller (ID: u_99283). **Subject:** Q3 Budget Check-in Hi Sarah, could you send over an update on the Q3 budget projections when you get a minute? Thanks! ``` ## Capabilities ### Manage employee roster and groups Get comprehensive lists of all users, specific details about individuals, and the organizational groups they belong to. ### Control communication channels Discover active discussion streams and publish announcements to keep every team member updated instantly. ### Handle direct messaging Send private messages or retrieve the full conversation history between any two users. ### Track organizational structure Access system metadata and detailed tenant information for high-level administrative oversight. ## Use Cases ### Sending an urgent company-wide safety alert An operations lead needs to notify everyone about new equipment protocols. Instead of manually navigating and selecting multiple channels, the agent uses `create_post` to publish a single announcement simultaneously across 'Operations Updates' and 'Company News'. ### Finding an employee’s direct contact details An HR manager needs to reach Sarah Miller but doesn't know her user ID. The agent uses `search_users` by name, instantly providing the correct User ID and confirming she belongs to the 'Logistics Team'. ### Summarizing a client discussion A team member wants to check up on a project discussion they were absent for. They ask their agent to use `list_messages` within that specific thread, getting a bulleted summary of the last 20 exchanges. ### Getting an organizational overview A manager wants to know who's on the team and what channels exist. The agent first calls `list_groups` to see departmental structure, then uses `list_streams` to map out all active communication areas. ## Benefits - Post announcements instantly: You can use the `create_post` tool to publish urgent updates to specific streams, making sure every relevant employee sees the notice immediately. - Never search manually again: Use `search_users` to find a person's ID or contact info by name or email in seconds. No more clicking through directories. - Keep comms private and tracked: Need to check up on a chat? The agent can use `list_messages` to pull the full conversation history for review. - Understand your team structure: Running reports? You can list all defined groups using `list_groups` or get an overview of every employee with `list_users`. - Get user specifics fast: Instead of guessing, you can use `get_user` to pull specific details on a single person's profile when needed. ## How It Works The bottom line is, once connected, your AI client handles the authentication and API calls so you never have to switch tabs or copy/paste credentials again. 1. Subscribe to this MCP on Vinkius. 2. Provide your Beekeeper Subdomain and API Token credentials to connect the service. 3. Start interacting with your agent from any compatible client; you can now manage all workforce communication directly through natural conversation. ## Frequently Asked Questions **How does the Beekeeper MCP help me manage company announcements?** It lets your agent publish urgent updates across multiple channels simultaneously. Instead of manually posting to every stream, you send one command and it broadcasts the message everywhere it needs to go. **Can I use the Beekeeper MCP to find employee contact info?** Yes, absolutely. You can search for users by name or email, and the agent will pull up their full details right away. This saves you from manually searching through directories. **Is the Beekeeper MCP good for tracking conversations?** It's great for that. You can ask your agent to retrieve message histories between any two users, giving you a full record of what was discussed in that specific chat thread. **Does the Beekeeper MCP connect to all my company departments?** Yes, it gives you visibility into every defined group and communication stream. You can list all channels and groups within your organization using the agent's tools. **What if I need administrative data about my Beekeeper account?** The MCP includes functions to retrieve tenant information, so you get system-level metadata for high-level oversight. It helps administrators verify the overall health of the connection.