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
WithNettleOAuth
com.withnettle
Project management shared by people and AI agents, with persistent project state through MCP.
Project Management Knowledge & Memory
151
FlowraOAuth
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11
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

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 a month ago (2026-09-12 13:23 UTC)
168 npm
267
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 3 months ago (2026-07-25 19:18 UTC)
35
-
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 4 months ago (2026-06-27 10:55 UTC)
18 npm
1
Mozilla Public 2.0
scratch-mcp
Education & Learning Tools Code Execution
AstroBlocksMod
A
license
B
quality
C
maintenance
Enables editing Scratch .sb3 projects programmatically, including sprites, blocks, costumes, sounds, variables, and online project sharing, plus headless VM execution and live-reload in TurboWarp Desktop.
Updated 2 months ago (2026-08-25 20:51 UTC)
43
18 npm
Mozilla Public 2.0

scratch4js

Packages

How they fit together

Getting started

Workspace layout

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

GoPeak

rbxsync-mcpofficial

scratch-mcp

scratch-mcp