Which integrations are available for this server?

Allows reading, editing, and saving Scratch .sb3 project files programmatically, with tools for modifying sprites, scripts, costumes, sounds, and other project assets.

How do I use scratch-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@scratch-mcp Add a cat sprite that says 'Hello' when clicked" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

scratch-mcp

by playforge-coding

Overview Schema Source Related Servers Discussions Admin

JavaScript

Local

scratch4js

A pnpm monorepo of small, focused JavaScript packages for working with Scratch and TurboWarp — edit .sb3 projects programmatically, talk to the Scratch website, drive it all from an AI agent, and build & bundle TurboWarp extensions.

📖 Documentation: https://playforge-coding.github.io/scratch4js/

Packages

Path	Package	What it is
`packages/scratch4js`	`scratch4js`	The core library: read/edit `.sb3` files with a small, declarative API.
`packages/s-api4js`	`s-api4js`	A class-based wrapper for the Scratch website API: read public data, and log in to download/edit/publish `.sb3`.
`packages/scratch-mcp`	`scratch-mcp`	An MCP server exposing the library's editing surface as tools, plus a TurboWarp live-reload bridge.
`packages/tw-plugin-webpack`	`tw-plugin-webpack`	webpack/Rspack plugin that bundles a multi-file TurboWarp extension into one IIFE-wrapped file.
`packages/tw-plugin-rollup`	`tw-plugin-rollup`	Rollup/Rolldown/Vite plugin that bundles a multi-file TurboWarp extension into one IIFE-wrapped file.
`packages/create-tw-extension`	`create-tw-extension`	Scaffolder (`npm create tw-extension`) for a new TurboWarp extension project with your choice of bundler.
`packages/web-editor`	`browser-ide-kit`	Reusable React building blocks for in-browser IDEs: split-pane layout, Monaco, an xterm/WebContainer terminal, file tree.
`packages/tw-extension-maker`	`tw-extension-maker`	In-browser IDE (built on `browser-ide-kit`) that bundles a TurboWarp extension in a WebContainer and previews it live.
`packages/userscript`	`userscript`	TurboWarp Desktop userscript (ES modules → one IIFE): scratch-mcp live-reload + real-time collaboration over a WebSocket relay.

Related MCP server: rbxsync-mcp

How they fit together

  AI agent / MCP client
          │  (MCP tools over stdio)
          ▼
   ┌──────────────┐   edits in memory   ┌────────────┐
   │  scratch-mcp │ ──────────────────► │ scratch4js │
   └──────┬───────┘   save → .sb3 file  └────────────┘
          │ WebSocket bridge (localhost:9060)
          ▼  "loadSB3" → fetch /get.sb3
   TurboWarp Desktop + userscript  ──►  live preview

An agent edits a project through scratch-mcp; on save the server writes the .sb3 and signals the userscript, which reloads it into TurboWarp Desktop instantly.

Getting started

pnpm install
pnpm build          # build every package (-r build)
pnpm lint
pnpm fmt            # prettier --write .

Then:

Install the userscript into TurboWarp Desktop (pnpm --filter userscript deploy; per-OS paths in its README).
Run the MCP server and point your MCP client at it.
Open .sb3 files, edit, and save_project to see changes live.

Workspace layout

.
├── packages/
│   ├── scratch4js/          # the core library (+ examples + example.sb3)
│   ├── s-api4js/            # Scratch website API wrapper
│   ├── scratch-mcp/         # the MCP server + live-reload bridge
│   ├── tw-plugin-webpack/   # webpack/Rspack extension bundler plugin
│   ├── tw-plugin-rollup/    # Rollup/Rolldown/Vite extension bundler plugin
│   ├── create-tw-extension/ # extension scaffolder CLI
│   ├── web-editor/          # in-browser IDE building blocks
│   ├── tw-extension-maker/  # in-browser extension IDE
│   └── userscript/          # TurboWarp Desktop userscript: live-reload + collaboration
├── docs/                    # Rspress documentation site
├── pnpm-workspace.yaml
└── package.json             # workspace root (build/lint/fmt delegate to -r)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

mcp-serverOAuth
com.niftypm
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Project Management Communication File Systems
2
supportsheep
io.github.pooriaarab
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Customer Support Content Management Systems Marketing
1
Flato Design MCPOAuth
io.github.sologovision
Connect AI agents to Flato's editable canvas runtime through a hosted MCP server.
Design Tools Developer Tools
22
clipkit A
dev.clipkit
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
Multimedia Processing Image & Video Processing
15216

Related MCP Servers

GoPeak
Developer Tools Games & Gamification
HaD0Yun
A
license
Not graded
quality
A
maintenance
Enables AI assistants to edit, run, inspect, and fix Godot 4 projects through an MCP server with dynamic tool groups and setup-gated capabilities.
Updated 4 days ago (2026-09-12 13:23 UTC)
191 npm
255
MIT
rbxsync-mcpofficial
Developer Tools Testing & QA Tools Coding Agents
Smokestack-Games
F
license
Not graded
quality
D
maintenance
Enables AI agents to extract, sync, test, and debug Roblox games bidirectionally between Studio and filesystem via MCP.
Updated 2 months ago (2026-07-25 19:18 UTC)
31
-
ultimate-construct3-mcp
Developer Tools Games & Gamification Documentation Access
nahuelgallo
A
license
Not graded
quality
D
maintenance
Unified MCP server for Construct 3 providing offline documentation, project read/write, analysis, and scripting support. Enables AI-driven game development and project management through natural language.
Updated 6 months ago (2026-03-16 07:03 UTC)
1
MIT
scratch-mcp
Education & Learning Tools Coding Agents
FromArkZoo
A
license
Not graded
quality
D
maintenance
Enables AI agents to create, compile, and run Scratch projects by editing plain text and using a live editor loop.
Updated 3 months ago (2026-06-27 10:55 UTC)
13 npm
1
Mozilla Public 2.0