Rosh MCP Server
Give any AI the power to create and publish interactive web apps, games, and 3D scenes using Rosh — a plain-English programming language.
What is Rosh?
Rosh lets you write programs in plain English:
create box called player at 400 300
set player color "blue"
on key "ArrowRight" then set player x to player x + 5
This compiles to a runnable HTML5 canvas app, a Phaser game, or a Three.js 3D scene — depending on the target.
Quick Start
Claude Desktop / Claude Code
Add to your MCP config (~/.claude/mcp.json or Claude Desktop settings):
{
"mcpServers": {
"rosh": {
"command": "uvx",
"args": ["rosh-mcp"],
"env": {
"ROSH_API_KEY": "rosh_k1_your_key_here"
}
}
}
}
Cursor / Windsurf
Same config format — add to your MCP settings file.
Get an API Key
- Create an account at rosh.cloud
- Go to Settings → API Keys
- Create a key with
read,writescopes
Note: All tools require an API key — set
ROSH_API_KEYbefore starting the server.
Tools
| Tool | Description | Auth Required |
|---|---|---|
rosh_docs |
Get the full Rosh language reference | Yes (read) |
rosh_compile |
Compile Rosh code to HTML | Yes (read) |
rosh_publish |
Publish a program to rosh.cloud | Yes (write) |
rosh_list_programs |
List your programs | Yes (read) |
rosh_get_program |
Get program details by ID | Yes (read) |
rosh_update_program |
Update an existing program | Yes (write) |
rosh_delete_program |
Delete a program | Yes (write) |
rosh_hide_program |
Hide a program (moderation) | Yes (moderate) |
rosh_show_program |
Unhide a program | Yes (moderate) |
Example Prompts
Try these with any MCP-capable AI:
- "Build me a space shooter game" — AI reads docs, writes Rosh code, compiles to Phaser
- "Create a 3D rotating sculpture" — compiles to Three.js
- "Make an interactive dashboard with buttons and counters" — compiles to web
- "Show me what Rosh can do" — AI calls
rosh_docsand explores
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
ROSH_API_KEY |
Yes | — | Your rosh.cloud API key |
ROSH_API_BASE |
No | https://rosh.cloud |
API base URL |
Development
git clone https://github.com/rosh-studio/rosh-mcp.git
cd rosh-mcp
pip install -e .
rosh-mcp # runs the stdio server
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rosh_mcp-0.1.1.tar.gz.
File metadata
- Download URL: rosh_mcp-0.1.1.tar.gz
- Upload date:
- Size: 5.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
528ae7d0983273315807f68495c2dd542edd41227bd0798976ab2c3eafe32eaf
|
|
| MD5 |
33ff0ebad6f6c38e202d6108d4993366
|
|
| BLAKE2b-256 |
d88ce5daf66cbf1f4ba4c143a1fb563d9efcf60a46bf9a5e06623329f0251bf3
|
File details
Details for the file rosh_mcp-0.1.1-py3-none-any.whl.
File metadata
- Download URL: rosh_mcp-0.1.1-py3-none-any.whl
- Upload date:
- Size: 6.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d40a690dfda821d897e81129c8946052e49659be0423a02d07349d936d54eff3
|
|
| MD5 |
c2650329af21efdbd82588d371ea3b78
|
|
| BLAKE2b-256 |
73e5ebd145ceaa74ae8783f81a1421629ba037693f7900fb886ed48708da4141
|