Skip to main content
Glama
ykovenskiy-hub

Purl MCP Server

by ykovenskiy-hub
OverviewSchemaRelated ServersScoreDiscussions
JavaScript

Purl MCP Server

MCP server that connects AI assistants to your live Purl Studio project. Read objects, modify scripts, set properties — all from your AI coding tool.

Quick Setup

Claude Code

claude mcp add purl -- npx purl-mcp@latest

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "purl": {
      "command": "npx",
      "args": ["purl-mcp@latest"]
    }
  }
}

VS Code

Add to your VS Code settings:

{
  "mcp": {
    "servers": {
      "purl": {
        "command": "npx",
        "args": ["purl-mcp@latest"]
      }
    }
  }
}

Related MCP server: Roblox Studio MCP Server (Posuceius Fork)

How It Works

The MCP server runs a local WebSocket bridge on port 3001. When you open Purl Studio in your browser, it automatically connects to the bridge. Your AI assistant communicates with the MCP server via stdio, which forwards requests to the browser over WebSocket.

AI Assistant  ←stdio→  MCP Server  ←WebSocket→  Browser (purl.studio)

No API keys, no cloud relay — everything runs locally on your machine.

Tools

Read Tools

Tool

Description

get_project

Get project structure (cells, settings)

list_objects

List all objects with names, types, tags

get_script

Get script code for an object or cell

get_states

Get component states/presets

dsl_reference

Query Purl DSL documentation

validate_script

Check script syntax for errors

Write Tools

Tool

Description

set_property

Set properties on an object (position, size, color, etc.)

update_script

Replace script code on an object or cell

add_object

Create a new object in a cell

remove_object

Delete an object

update_cell

Set cell-level properties (gravity, wind, size)

clone_object

Deep-clone an object tree

bulk_set_property

Set properties on multiple objects at once

Configuration

Environment Variable

Default

Description

PURL_WS_PORT

3001

WebSocket server port

You can also set the port in the browser via URL parameter: https://purl.studio?mcpPort=3002

Requirements

  • Node.js 18+

  • A browser with Purl Studio open

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Vibe Blocks MCP

    majidmanzarpour
    A
    license
    -
    quality
    -
    maintenance
    Connects Roblox Studio to AI coding editors via the Model Context Protocol, allowing AI agents to understand and interact with live Roblox Studio sessions through scene manipulation, scripting, and optional Roblox Open Cloud API integration.
    66

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ykovenskiy-hub/purl-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server