MCP

The Model Context Protocol (MCP) integration lets Mudstack connect directly to AI clients like Claude, GPT, Cursor, and VSCode. Once connected, your LLM can securely search, tag, rename, lock, and comment on assets inside your workspaces — all through structured tool calls. Configure the MCP server once, authenticate with your account ID, and your AI will have everything it needs to work with your libraries and projects.

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.

It is important to have your account ID, as every MCP call requires it. Your account ID is easiest to grab by copying a link from a file in the app.

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 is https://mcp.mudstack.com/mcp, and the authentication is Oauth.
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 on More, and select Developer Mode. Click the dropdown Add 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 the Edit 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

{
  "mcpServers": {
    "mudstack": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.mudstack.com/mcp"
      ]
    }
  }
}

VSCode

Make sure mcp is enabled in your application
Run the command MCP: Add Server (Ctrl+Shift+P or CMD+Shift+P then search for MCP: 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 or Workspace for the install, we recommend Global
You’ll see an authentication window appear. Select allow
Select MCP as the account to sign into https://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)

{
  "servers": {
    "mudstack": {
      "url": "https://mcp.mudstack.com/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

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

{
  "mcpServers": {
    "mudstack": {
      "url": "https://mcp.mudstack.com/mcp",
      "type": "http"
    }
  }
}

{
  "mcpServers": {
    "mudstack": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mudstack.com/mcp"]
    }
  }
}

Available Tools

`get-account-data`

Gets account information for the provided account ID. Parameters:

account_id (string, required)

Purpose: Returns roles, IDs, and workspace information.
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)

Purpose: Flexible filesystem search. Returns asset IDs and metadata.
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)

Use case: Batch lock assets for editing.

`unlock-asset`

Unlocks a specified asset. Parameters:

account_id (string, required)
workspace_id (string, required)
asset_id (string, required)

Use case: Undo a Lock.

`create-comment`

Adds a comment to an asset. Parameters:

account_id (string, required)
workspace_id (string, required)
asset_id (string, required)
content (string, required)

Use case: “Add a ‘looks good!’ comment to all .jpg files.”

`get-tags`

Fetches all tags in a workspace. Parameters:

account_id (string, required)
workspace_id (string, required)

Purpose: Enables tag-aware tool calls.

`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)

Use case: Bulk classification (e.g., add “summer” tag to all /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)

Use case: Create tags dynamically for workflows.

`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)

Use case: Update 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)

Use case: Append -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)

Purpose: Summarize commits, renames, reviews, etc.
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)

Use case: Clean up all completed assets in /finished.

`search-commits`

Search for commits in a specific workspace. Parameters:

account_id (string, required)
workspace_id (string, required)
num_commits (number, optional)

Use case: Search for commits with in the last month the name Robot.

`get-commit-details`

Get the details of a specific commit Parameters:

account_id (string, required)
workspace_id (string, required)
commit_id (string, required)

Use case: Give me a list of changes in the commit Updated character mesh.

FAQs

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?

See the Available Tools section for a complete list. Your access depends on your account roles and workspace permissions.

Welcome

Getting Started

Features

Support

Setup Instructions

General

Chat GPT (Web)

Claude Desktop

VSCode

Cursor

Available Tools

`get-account-data`

`search-assets`

`lock-asset`

`unlock-asset`

`create-comment`

`get-tags`

`add-tag`

`create-tag`

`update-tag`

`rename-asset`

`asset-history`

`purge-old-versions`

`search-commits`

`get-commit-details`

FAQs

Welcome

Getting Started

Features

Support

​Setup Instructions

​General

​Chat GPT (Web)

​Claude Desktop

​VSCode

​Cursor

​Available Tools

​get-account-data

​search-assets

​lock-asset

​unlock-asset

​create-comment

​get-tags

​add-tag

​create-tag

​update-tag

​rename-asset

​asset-history

​purge-old-versions

​search-commits

​get-commit-details

​FAQs

Setup Instructions

General

Chat GPT (Web)

Claude Desktop

VSCode

Cursor

Available Tools

`get-account-data`

`search-assets`

`lock-asset`

`unlock-asset`

`create-comment`

`get-tags`

`add-tag`

`create-tag`

`update-tag`

`rename-asset`

`asset-history`

`purge-old-versions`

`search-commits`

`get-commit-details`

FAQs