# Workvivo MCP MCP > Workvivo MCP connects your AI agent directly to your company's internal communication hub. This lets you manage employee profiles, post updates, and track department activity using natural conversation. It’s for anyone who needs a single place to run reports on organizational data—no more logging into the Workvivo dashboard just to share an announcement or check staff details. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** employee-engagement, internal-comms, company-culture, social-feed, employee-directory, workplace-collaboration ## Description This connector gives your AI agent full access to your employee experience infrastructure. Need to broadcast something company-wide? You can craft and publish posts right from your chat window, targeting specific teams or the general feed. Want to know who’s on the team? The system lists every registered staff member and pulls their profile details instantly. It also tracks everything else: upcoming department events, current interest groups, and what people are posting about. The real win is how this MCP plays with other tools. You can connect it alongside a billing platform or a CRM to build workflows that go beyond just internal comms; for instance, you could trigger an announcement *after* a new employee record was created in the HR system. Because everything runs on Vinkius, your credentials pass through a zero-trust proxy and are used only in transit, keeping your keys off any disk. Your agent becomes your centralized communications officer. ## Tools ### create_social_post Publishes new text content directly onto the company activity feed. ### delete_social_post Removes a social post from Workvivo permanently. ### get_event_details Retrieves all known details, like location and start time, for a single calendar event. ### get_post_details Pulls the full content and metrics (likes/comments) for one specific social post. ### get_space_details Retrieves information, including membership counts, about a particular collaboration space or group. ### get_employee_profile Fetches the contact information and job title for one specific employee. ### list_company_events Shows a summary list of all scheduled corporate events on the calendar. ### list_workvivo_posts Shows a chronological list of all recent activity on the company feed. ### list_collaboration_spaces Provides a list of all existing interest groups and departmental spaces. ### list_employees Generates a directory listing containing names and basic info for every registered employee. ## Prompt Examples **Prompt:** ``` List the last 5 posts on the company feed. ``` **Response:** ``` I found the 5 most recent posts: 1. 'Q1 Goals Achievement' by John Doe, 2. 'New Office Opening' by Jane Smith, 3. 'Welcome our New Hires' by HR, and 2 others. Which one would you like to see the comments for? ``` **Prompt:** ``` Find the profile for employee ID 'emp-123'. ``` **Response:** ``` Profile for emp-123: Name: Robert Brown, Title: Senior Software Engineer, Department: Engineering, Email: robert@example.com. Would you like me to see which spaces he belongs to? ``` **Prompt:** ``` What are the details for the 'Town Hall' event today? ``` **Response:** ``` Event 'Monthly Town Hall' (ID: ev-999): Starts at 03:00 PM UTC, Location: Main Auditorium / Zoom. Description: Q1 strategy update and open Q&A with the CEO. No agenda attachments found. ``` ## Capabilities ### Publish announcements Create new posts that appear on the company activity feed. ### Manage employee records Find and pull detailed profile information for any specific staff member by their ID or name. ### List available teams and groups Retrieve a list of all collaboration spaces, departments, and interest groups within the company. ### Track corporate events See upcoming company events, including locations and start times from the central calendar. ### Analyze content activity View details on specific posts or understand general activity levels across the entire platform. ### Clean up old data Permanently delete social posts that are obsolete, ensuring clean records. ## Use Cases ### The Project Lead needs to announce a new policy. Instead of writing an email and hoping people see it, the agent runs `create_social_post` targeting the 'Project X' space ID. The announcement immediately appears in the right place, ensuring maximum visibility for all stakeholders. ### HR needs to onboard a new hire and announce them. The agent first calls `list_employees` to verify the directory structure, then uses `get_employee_profile` on the new user. Finally, it runs `create_social_post` to make sure the whole company knows about the addition. ### Executive Assistant needs event details for a board meeting. They ask their agent for 'Town Hall next Tuesday.' The MCP uses `list_company_events` to find the date, and then calls `get_event_details` to confirm the location and start time instantly. ### Comms team wants a list of all department groups. They ask the agent to 'Show me all internal teams.' The MCP responds by running `list_collaboration_spaces`, giving them the full scope of departmental groups they can target. ## Benefits - Write posts instantly: You can publish announcements using `create_social_post` without ever logging into the Workvivo dashboard. Your agent handles the API call for you. - Keep staff info current: Need to know who’s on a project? Use `list_employees` and then `get_employee_profile` to pull contact details in seconds, not minutes. - Track company happenings: Get an overview of all activity using `list_workvivo_posts`, or drill down into a specific update by calling `get_post_details`. - Automate group updates: Quickly see which department needs attention by running `list_collaboration_spaces` and then checking the details of any space with `get_space_details`. - Verify event data: Don’t guess about dates. Use `list_company_events` to see what's coming up, and if you need specifics, call `get_event_details` for the full scope. - Maintain clean records: If a post is outdated or incorrect, use `delete_social_post` to permanently remove it from the feed. ## How It Works The bottom line is you manage your entire employee experience from one chat window, never needing to log into the Workvivo website itself. 1. Subscribe to the Workvivo MCP and enter your specific domain details and API token. 2. Connect your agent client (Claude, Cursor, etc.) using the Vinkius platform connection point. 3. Ask a natural language question—like 'List all employees in Engineering' or 'Post an update about next month’s retreat.' The agent handles the rest. ## Frequently Asked Questions **How do I use the list_employees tool? ** You simply ask your agent to 'List all employees.' The MCP runs `list_employees` and provides you with a directory summary of every person registered in Workvivo. **Can create_social_post only post basic text?** No, it handles full content. You provide the text and an optional space ID, and the MCP executes `create_social_post` to publish a formatted update directly to the feed. **What is get_space_details used for?** You use this when you know the name of a department or group but need specifics. It runs `get_space_details`, providing membership counts and other details about that specific collaboration space. **Is list_workvivo_posts better than listing company events?** They track different things. Use `list_workvivo_posts` for general, continuous social activity on the feed. Use `list_company_events` when you need official details about a scheduled date or location. **When I use the `delete_social_post` tool, how are the actions logged for compliance?** The action is permanently deleted from Workvivo. However, the MCP logs this event with a cryptographically signed audit trail, providing a tamper-proof record of who initiated the deletion and when. **If I use `list_employees`, how does the agent handle retrieving data for a very large company directory?** The tool is designed for bulk retrieval. If you have thousands of records, the agent automatically handles pagination, requesting subsequent pages until it confirms all registered employee profiles have been listed. **What happens if I try to use `get_post_details` with a social post ID that doesn't exist?** The MCP won't fail; it will return a clear, structured error message. The agent tells you exactly why the request failed or confirms that the specified post ID is invalid or obsolete. **Are there rate limits when I use `create_social_post` many times in quick succession?** Yes, Workvivo enforces standard API usage limits. If your agent attempts to create too many posts too quickly, it will pause and notify you before running into an error. **Can I check which users belong to a specific collaboration space?** Yes. The `get_space_details` tool allows your AI agent to retrieve the membership count and configuration for any specific space ID, helping you monitor team alignment directly through chat. **How do I see the contact details for a colleague using chat?** You can use the `get_employee_profile` tool. Simply provide the unique employee ID, and your agent will return their full profile details, including email, job title, and department information. **Can I post an announcement to the global activity feed via chat?** Absolutely. Use the `create_social_post` tool and provide your update text. If you don't specify a space ID, the post will be shared to the main company activity feed, making it visible to all users.