Purl MCP Server
Connects AI assistants to live Purl Studio projects, enabling reading objects, modifying scripts, and setting properties.
README
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"]
}
}
}
}
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.