# Howspace MCP > Howspace MCP Server manages collaborative learning and organizational development. Use this server to programmatically create workspaces, add participants by email, list all workspaces, and track engagement campaigns. It lets your AI agent manage complex workshops and onboarding workflows without needing to open the Howspace dashboard. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** workshops, change-management, facilitation, engagement-campaigns, collaborative-workspace, participant-management ## Description You're using the Howspace MCP Server to handle all your collaborative workshops and organizational development stuff. It lets your AI agent build and manage everything inside Howspace without you having to open the dashboard. You can programmatically create workspaces, add people, and track engagement campaigns—it's built for managing complex workflows. You'll use `create_workspace` to set up a new collaborative environment, giving it a name. You can check out all your existing workspaces with `list_workspaces`, or if you need the specifics on just one, you can use `get_workspace` to get its details and settings. To bring people into a workshop, just use `add_participant` and provide their email address. You can see who's already in a workspace by running `list_participants` for that specific space. For tracking engagement, you'll use `list_campaigns` to pull a list of every active campaign set up in your account. You can also use `get_me` to pull basic profile information about the API user running the commands. ## Tools ### add_participant Adds a person to a workspace using their email address. ### create_workspace Creates a new, empty collaborative workspace. ### get_me Retrieves the profile information of the authenticated API user. ### get_workspace Gets the specific details and settings for a named workspace. ### list_campaigns Retrieves a list of all engagement campaigns set up in your Howspace account. ### list_participants Shows all users currently listed in a specific workspace. ### list_workspaces Lists every workspace currently existing in your account. ## 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 Use `create_workspace` to set up a new collaborative environment by name. ### Add members to a workspace Use `add_participant` to invite people to a specific workspace using their email address. ### List and inspect workspaces Use `list_workspaces` and `get_workspace` to see all current workspaces or get the details for one specific workspace. ### Manage participants Use `list_participants` to see who is currently a member of a given workspace. ### Track campaigns Use `list_campaigns` to list all active engagement campaigns configured in your account. ### Check user details Use `get_me` to retrieve basic information about the API user account. ## Use Cases ### Setting up a new team workshop A consultant needs a workshop for 'Q4 Strategy' and must invite 15 people. Instead of going to the website, they ask their agent: 'Create a new workspace called Q4 Strategy and add the 15 emails.' The agent runs `create_workspace` then calls `add_participant` repeatedly, and the workshop is ready. ### Auditing participant membership HR needs to confirm that all 50 new hires are in the '2025 Onboarding' workspace. They prompt: 'List participants in the 2025 Onboarding workspace.' The agent runs `list_participants` and returns the full, accurate roster instantly. ### Checking all managed campaigns A manager wants to know what engagement programs are running. They ask the agent to 'List all campaigns.' The agent runs `list_campaigns` and reports back the name, trigger, and scope of every campaign in the account. ### Finding the right workspace details The L&D manager needs to know the specific settings for the 'Leadership Development' workshop. They prompt: 'What are the details for the Leadership Development workspace?' The agent calls `get_workspace` and provides the settings instantly. ## Benefits - Create and manage full workshops using `create_workspace` and `get_workspace`. You don't need to open the dashboard to set up a new learning environment. - Onboard new hires in bulk. Use `add_participant` to invite multiple people by email, triggering immediate invitations. - Track engagement status by listing all active campaigns with `list_campaigns`. You see which communications are running without leaving your chat. - Get a full picture of your account with `list_workspaces`. See every workshop you manage in one query. - Verify who belongs where. Call `list_participants` to confirm the exact membership roster of any workspace. - Quickly check account details. Use `get_me` to pull your current user information without navigating any settings pages. ## How It Works The bottom line is, you talk to your agent, and it talks to Howspace for you. 1. Subscribe to the Howspace server and provide your Base URL and API Key. 2. Your AI client uses the natural language prompt to determine the required action (e.g., 'Add Sarah to the Q3 workshop'). 3. The agent invokes the appropriate tool (`add_participant`) and returns the confirmation and resulting data. ## Frequently Asked Questions **How do I use the `add_participant` tool with Howspace MCP Server?** You ask your agent to add the participant by providing their email and the target workspace name. The agent uses `add_participant` to send the invitation and confirm the addition. **Can I use `list_workspaces` to find all my workshops?** Yes. Prompting the agent with 'List all workspaces' triggers `list_workspaces` and gives you a complete index of every workspace in your Howspace account. **What if I need to check a specific workspace's settings?** Use `get_workspace`. You just need to name the workspace, and the agent calls `get_workspace` to pull all the specific details and settings. **Does `list_participants` need a workspace ID?** Yes, the tool requires you to specify which workspace you want to check. You need to give the agent enough context to run `list_participants` accurately. **How do I check my API user info using `get_me`?** Simply ask your agent to 'Show my account details.' It runs `get_me` and returns your name, role, and organization details. **How do I list all campaigns using the `list_campaigns` tool?** You call `list_campaigns` directly. This tool retrieves all configured campaigns, letting you see their names and what they trigger on. This is useful for auditing engagement or seeing what communication efforts are active in your account. **What is the best way to add a new member using the `add_participant` tool?** The `add_participant` tool requires the participant's email address. You can optionally include a name when calling the tool. Once added, the participant gets an email invitation, ready to join the specified workspace. **Can I check details for a specific workspace using `get_workspace`?** Yes, you pass the specific workspace ID to `get_workspace`. The tool returns all settings and details for that single workspace. This lets you verify permissions or check the current status without listing everything. **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.