viaSocket Help

Toolhouse Integration Guide

Connect Julius AI to 2,500+ apps via Mushroom MCP

Toolhouse Method — Requires a Toolhouse account. Connect via the Agent Studio inside your Toolhouse workspace.

#

Overview

Mushroom is viaSocket's MCP server platform that connects Toolhouse to 2,500+ apps like Google Sheets, Slack, Gmail, and HubSpot via a single secure URL.

This guide covers connecting your Mushroom MCP cluster to Toolhouse so your AI agent can access real-world tools and execute actions securely through MCP.

#

Part 1: Set Up Mushroom

Complete these steps first. They are the same regardless of which AI client you are connecting.

Step 1: Go to Mushroom

Open mushroom.viasocket.com in your browser. Click "+ New Cluster" to begin.


Step 2: Add Mushrooms (Apps)

You land on the Mushrooms dashboard. Click "+ Add new App" to open the integration catalogue.


Step 3: Pick an App from the Catalogue

Search or scroll to find the app you need — Google Sheets, Slack, Gmail, HubSpot, and 2,500+ more. Click on it to open its configuration screen.


Step 4: Authorize & Select Actions

In the authentication pop-up, toggle the triggers and actions you want active. Mushroom pre-selects sensible defaults based on your previous connections.

Scroll down and click "Next" — the authorization pop-up will open. Sign in and grant permissions. Once authorized, you will be returned to the app's configuration screen.


Step 5: Configure App Actions

Each app offers two options:

  • Enable Everything (AI-Powered) — Toolhouse automatically decides which actions to use.

  • Configure Actions manually — pick only the specific actions you want to expose (e.g., Add New Row, Get Row Details, Delete Row).

Once the actions are configured, scroll down and click the "Enable" button.


Step 6: Copy Your MCP Endpoint URL

Back on the dashboard, your app appears under your Cluster. Scroll down to the Configuration panel at the bottom of the page.

[Image — Mushroom cluster dashboard showing MCP Endpoint URL and Copy button]

The Configuration panel shows:

  • MCP Endpoint URL — a unique HTTPS URL for your cluster.

  • JSON config block — the ready-made config for supported clients.

Security: Keep this URL private. It authorises AI actions on your connected accounts. Do not share it publicly or commit it to version control.

Copy your MCP Endpoint URL from the panel. You will paste it into Toolhouse in the next steps.

#

Part 2: Connect Toolhouse


Step 1: Open Agent Studio

Log in to your Toolhouse account. Open Agent Studio from the left sidebar.


Step 2: Create a New Agent

Click to create a new agent. Write your agent prompt and submit it. Once the agent is created, open the Chatbot Builder.


Step 3: Add a System Message

In the Chatbot Builder, add an additional system message. Copy and paste the following exactly:

Now add support to connect to the following MCP server:
https://mcp.viasocket.com/mcp/your-unique-id

Replace your-unique-id with the MCP Endpoint URL you copied from your Mushroom cluster dashboard.


Step 4: Save and Run

Save the Chatbot Builder configuration. Your agent will now discover and use your Mushroom-connected apps automatically during execution — no manual API calls required.

Done! Toolhouse is now connected to your Mushroom power-ups. You can add more apps to your Mushroom cluster at any time without reconfiguring your agent.

Note on MCP Endpoint URL:

  • Your agent discovers Mushroom tools via MCP automatically

  • All connected apps become available during agent execution

  • No manual API calls are required

  • Keep your MCP Endpoint URL private — it authorises actions on all your connected accounts

⚠️ Caution: Treat your MCP Endpoint URL like a password! It can be used to run tools attached to this server and access your data.