# Howspace MCP MCP > Howspace MCP connects your AI client to collaborative learning platforms, letting you manage entire workshops and participant lists through natural conversation. You can create new workspaces, add members by email, or check out existing campaigns—all without opening a web dashboard. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** workshops, change-management, facilitation, engagement-campaigns, collaborative-workspace, participant-management ## Description Need to run a workshop or training session but hate clicking through dashboards? This MCP handles the heavy lifting for collaborative learning environments. Think of it as having your entire L&D platform right inside your chat window. You can manage structures, like listing all existing workspaces, and populate them with people using just text commands. It's perfect for HR teams running onboarding or change management consultants handling large-scale rollouts. Instead of jumping to a web portal and manually adding 20 emails one by one, you simply tell your agent what needs doing. The Vinkius catalog makes connecting this functionality simple: connect it once from any compatible AI client, and the power is yours. It cuts down days of administrative clicking into a few conversational steps. ## Tools ### add_participant Adds a person to an existing workshop space using their email address. ### create_workspace Builds and sets up a brand new collaborative workspace for your group. ### get_me Retrieves basic information about the authenticated account user. ### get_workspace Fetches specific details and settings for a single, defined workspace. ### list_campaigns Retrieves a list of all configured engagement campaigns for tracking communication efforts. ### list_participants Shows the names and emails of all people enrolled in a specific workshop space. ### list_workspaces Provides an overview list of every single workspace you have created or own. ## Prompt Examples **Prompt:** ``` Create a new workspace called 'Q3 Strategy Workshop' and add 3 team members. ``` **Response:** ``` Workspace created! Name: 'Q3 Strategy Workshop', ID: ws_4521. Adding participants: 1) sarah@company.com (Sarah Chen) — ✅ Added. 2) mike@company.com (Mike Torres) — ✅ Added. 3) lisa@company.com (Lisa Park) — ✅ Added. All 3 participants will receive email invitations. The workspace is now ready for content configuration. You have 12 total workspaces in your account. Would you like to list all workspaces or check the campaigns? ``` **Prompt:** ``` Show all workspaces and the participants in the onboarding workspace. ``` **Response:** ``` Your workspaces: 12 total. 1) 'Employee Onboarding 2025' (ws_4001, 45 participants). 2) 'Leadership Development' (ws_4002, 28 participants). 3) 'Q3 Strategy Workshop' (ws_4521, 3 participants). 4-12) 9 other workspaces. Participants in 'Employee Onboarding 2025' (45 total): Recent additions: 1) Ana Müller (ana@company.com, added Apr 22). 2) James Rodriguez (james@company.com, Apr 20). 3) Chen Wei (wei@company.com, Apr 18). Facilitators: Sarah Chen, Mike Torres. Would you like to add more participants or view campaigns? ``` **Prompt:** ``` List all campaigns and show my account details. ``` **Response:** ``` Your profile: Sarah Chen (sarah@company.com), Role: Admin, Organization: Acme Corp. Active campaigns: 4. 1) 'New Hire Welcome' — triggers on participant addition to 'Employee Onboarding 2025', sends welcome email + first assignment. 2) 'Weekly Engagement Pulse' — runs every Monday, surveys all active workspace participants. 3) 'Leadership Reflection' — biweekly prompt in 'Leadership Development' workspace. 4) 'Workshop Reminder' — 24h before scheduled sessions. Total campaign reach: 145 participants across all workspaces. Would you like to create a new workspace or add participants? ``` ## Capabilities ### Build new workshops Create entirely new collaborative workspaces for focused group sessions or training modules. ### Check workspace details Pull specific information about any existing workshop environment, like its current settings or purpose. ### Add people to a workshop Invite new members into any workspace using just an email address and optional name. ### See who's in the group List every participant currently enrolled in a specific workshop or across your entire account. ### Review engagement campaigns View all configured communication and engagement campaigns running through Howspace. ## Use Cases ### Onboarding a new class of hires An HR manager needs to set up 'New Hire Training 2025' and enroll fifty people. Instead of logging into the system, creating the workspace, and then running through five separate screens to add everyone, they just prompt their agent: 'Create a new workspace called New Hire Training 2025 and add all emails in this file.' The MCP handles the whole sequence. ### Auditing stale workshops A facilitator needs to know which of their twelve past projects are still active or abandoned. They use `list_workspaces` to get a full inventory, then uses `get_workspace` on suspicious entries to check the last activity date and participant count. ### Preparing for an executive review A change management consultant must prove that all stakeholder groups have been reached. They use `list_campaigns` to confirm four separate communication tracks are live, then verify the total reach by running `list_participants` on key workspaces. ### Troubleshooting access issues A user can't seem to find a specific workshop. They first check their own details using `get_me`, and then ask the agent to run `list_workspaces`. The list immediately points them to the correct ID and name. ## Benefits - Stop clicking through dashboards. You can use `list_workspaces` to see every environment you own, then tell your agent which one needs work next. - Bulk-add members instantly. Instead of copy/pasting emails into a web form, just ask the MCP to execute `add_participant` for a list of people. - Track engagement easily. Use `list_campaigns` to see every communication campaign running—from welcome messages to weekly check-ins. - Know your users at a glance. By calling `list_participants`, you get a clean roster of who is actually in the workshop, saving you from manual counting. - Get context fast. The `get_workspace` tool lets you pull specific details on an environment's settings so you don't have to guess what it's for. ## How It Works The bottom line is that your AI client becomes an interface to complex workshop management systems without needing any specialized knowledge of the underlying API. 1. First, subscribe to this MCP in Vinkius. You'll need to provide your specific Howspace Base URL and API Key. 2. Next, connect the credentials to your preferred AI client—your agent handles the rest of the connection setup. 3. Then, simply ask your agent what you want to do: 'Create a new workspace called X' or 'List all participants in Y'. ## Frequently Asked Questions **How do I find out what workshops I have with the Howspace MCP?** You use `list_workspaces` to get a complete list. This tool shows every workspace ID and name associated with your account, giving you a full inventory right away. **Can I add participants without knowing their names first? Using the add_participant tool?** Yes. You only need to provide the email address when using `add_participant`. The optional name field helps, but the email is what does the heavy lifting. **What if I want to see who was added recently? Do I use list_participants?** Yes, you use `list_participants` for that. This tool pulls a roster of all members in a specific workspace, letting you review recent additions and current roles. **How does the Howspace MCP help with tracking communication? Should I check list_campaigns?** You use `list_campaigns` to see what engagement efforts are running. This is your central point for viewing all configured welcome, reminder, or pulse surveys. **If I want to create a new collaboration space, what parameters do I need for the `create_workspace` tool?** You only need to specify the desired name and details for the workspace. After running `create_workspace`, you'll immediately get confirmation of the new ID. This is handy because it means your AI agent can then proceed directly with sending invitations or configuring content, all in one go. **What information does the `get_workspace` tool return about a specific space?** It pulls detailed status and settings for that single workspace. This allows your agent to confirm if the space is active, check its current configuration, or verify its membership limits before you try making changes. **How do I use `get_me` if I need to confirm my access level or user details?** Running `get_me` retrieves the authenticated account's core profile information, like your name, role, and organization. Use this first to verify you have the proper permissions needed for large-scale actions, such as adding participants. **If I need a complete overview of my entire Howspace account, what combination of tools should I use?** Start by calling `list_workspaces` to see every project ID you manage. Then, if you want details on any specific space, follow up with `get_workspace`. This workflow lets your agent map out your whole setup before making any changes. **Can I create a workspace and add participants through the AI agent?** Yes. Use `create_workspace` with a name to create a new collaborative workspace. Then use `add_participant` with the workspace ID, participant email, and optional first/last name to invite members. Use `list_workspaces` to see all existing workspaces and `list_participants` to review who is already in a workspace. **Does Howspace require a custom Base URL in addition to the API Key?** Yes. Howspace instances are hosted on custom subdomains, so you need to provide your **Base URL** (e.g., `https://your-org.howspace.com`) along with the **API Key**. The API Key is sent as a Bearer token, and all requests are routed to your specific Howspace instance. **Can I view all campaigns running in my Howspace account?** Yes. The `list_campaigns` tool retrieves all campaigns configured in your account, including engagement campaigns, communication sequences, and notification triggers. Use `get_me` to verify your authenticated identity and permissions.