Setup Instructions
General
- Ensure your LLM client supports MCP (Claude Desktop, GPT, Cursor, VSCode).
- Configure your client’s MCP settings file (examples below).
- Start the client — you will be prompted for authentication
- Some clients require a restart after authentication (Claude Desktop).
- Others (VSCode, Cursor) typically don’t require a restart.
https://app.mudstack.com/sh/asset/9c8f1e7a-2d34-4f71-b58c-7e9d2a3f4b10/2e7c4d8a-91f2-4c73-8f6b-1a0e5bc9d432/ab51f7c0-38d2-4e1b-b927-3f68a2cd8e4f
The account ID is the first ID string in this URL 9c8f1e7a-2d34-4f71-b58c-7e9d2a3f4b10
.
For your first message, write Get account data for 9c8f1e7a-2d34-4f71-b58c-7e9d2a3f4b10
You should receieve a summary of your account data if everything is connected properly.
Once you provide the account ID once, the LLM will remember it. Using the get-account-data tool, the LLM can fetch all workspace IDs and metadata.
This allows you to reference workspaces by name, while the model will infer the correct IDs automatically.
Chat GPT (Web)
- Cick on your profile icon in the bottom left and select
Settings
- Click on
Connectors
in the left hand column - Click the
Create
button in the top right, and configure the server. The MCP Server URL ishttps://mcp.mudstack.com/mcp
, and the authentication isOauth
. - Trust the aplication and create the server
- You’ll see an authentication window appear. Select
allow
- When you are ready to use the server, click the
+
icon, click onMore
, and selectDeveloper Mode
. Click the dropdownAdd Sources
and select the Mudstack MCP server.
Claude Desktop
- The Mudstack MCP Server and many other MCP servers require Node.js to run. Verify your Node.js installation by opening a terminal and running:
node --version
- Open Claude Desktop Settings: Click on Claude in your system’s menu bar and select
Settings...
- Access Developer settings: In the settings window, navigate to the
Developer
tab in the left sidebar. Click theEdit Config
button to open the configuration file (located at~/Library/Application\ Support/Claude/claude_desktop_config.json
) - Open the file and configure the Mudstack Server
- A browser window should open, complete the authentication process
- Restart Claude Desktop
VSCode
- Make sure mcp is enabled in your application
- Run the command
MCP: Add Server
(Ctrl
+Shift
+P
orCMD
+Shift
+P
then search forMCP: Add Server
) - Select
HTTP (HTTP or Server-Sent Events)
- For the url enter
https://mcp.mudstack.com/mcp
- Name the
Mudstack
and press enter - Choose either
Global
orWorkspace
for the install, we recommendGlobal
- You’ll see an authentication window appear. Select
allow
- Select
MCP
as the account to sign intohttps://mcp.mudstack.com/mcp
- For the chat window, make sure your mode is set to
Agent
and the Mudstack MCP tools are selected (click the wrench icon in the bottom right to check this)
Cursor
- Open Cursor Settings: Click on Cursor in your system’s menu bar and select
Settings -> Cursor Settings
- Click on
Tools
in the left hand column - If you have no MCP Tools, click
Add Custom MCP
, otherwise click on the+
button to add a new mcp server - Configure the Mudstack mcp server
- You’ll see an authentication window appear. Select
allow
Available Tools
get-account-data
Gets account information for the provided account ID.
Parameters:
account_id
(string, required)
Use case: “What workspaces do I have access to?”
search-assets
Searches for all assets in a workspace.
Parameters:
account_id
(string, required)workspace_id
(string, required)folder
(string, optional)library_id
(string, optional)asset
(string, optional)
Use case: “Find all assets in
/scenes
with ‘car’ in their name.”
lock-asset
Locks a specified asset.
Parameters:
account_id
(string, required)workspace_id
(string, required)asset_id
(string, required)
unlock-asset
Unlocks a specified asset.
Parameters:
account_id
(string, required)workspace_id
(string, required)asset_id
(string, required)
create-comment
Adds a comment to an asset.
Parameters:
account_id
(string, required)workspace_id
(string, required)asset_id
(string, required)content
(string, required)
.jpg
files.”
get-tags
Fetches all tags in a workspace.
Parameters:
account_id
(string, required)workspace_id
(string, required)
add-tag
Adds a tag to an asset.
Parameters:
account_id
(string, required)workspace_id
(string, required)asset_id
(string, required)tag_id
(string, required)
/scenery
images).
create-tag
Creates a new tag in the workspace.
Parameters:
account_id
(string, required)workspace_id
(string, required)tag_name
(string, required)tag_color
(string, optional)
update-tag
Updates an existing tag in the workspace.
Parameters:
account_id
(string, required)workspace_id
(string, required)tag_id
(string, required)tag_name
(string, required)tag_color
(string, optional)
Phase-1
tag to Phase-2
, and change the color to red.
rename-asset
Renames a specific asset.
Parameters:
account_id
(string, required)workspace_id
(string, required)asset_id
(string, required)new_name
(string, required)
-finished
suffix to all assets in /parts
.
asset-history
Gets the version history of an asset.
Parameters:
account_id
(string, required)workspace_id
(string, required)asset_id
(string, required)num_versions
(integer, optional)
Use case: “Show all changes on this asset in the last 2 weeks.”
purge-old-versions
Deletes old versions of an asset.
Parameters:
account_id
(string, required)workspace_id
(string, required)asset_id
(string, required)
/finished
.
search-commits
Search for commits in a specific workspace.
Parameters:
account_id
(string, required)workspace_id
(string, required)num_commits
(number, optional)
Robot
.
get-commit-details
Get the details of a specific commit
Parameters:
account_id
(string, required)workspace_id
(string, required)commit_id
(string, required)
Updated character mesh
.
FAQs
What do I need to do to authenticate?
What do I need to do to authenticate?
When you first configure the Mudstack MCP server in your client, you’ll be prompted to authenticate.
Some clients (Claude Desktop) may require a restart afterwards.
What can I do with the MCP?
What can I do with the MCP?
See the Available Tools section for a complete list.
Your access depends on your account roles and workspace permissions.