Skip to main content

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

  1. Create an account at rosh.cloud
  2. Go to Settings → API Keys
  3. Create a key with read,write scopes

Note: All tools require an API key — set ROSH_API_KEY before 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_docs and 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

Metadata

Release files for rosh-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rosh-mcp 0.1.1
File Size Uploaded Provenance Actions
rosh_mcp-0.1.1.tar.gz 5.0 kB Without provenance Details for rosh_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for rosh-mcp 0.1.1
File Interpreter ABI Platform Actions
rosh_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for rosh_mcp-0.1.1-py3-none-any.whl

Total release size: 11.2 kB

Release files / rosh_mcp-0.1.1.tar.gz

Download URL rosh_mcp-0.1.1.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
528ae7d0983273315807f68495c2dd542edd41227bd0798976ab2c3eafe32eaf
BLAKE2b-256 checksum
How to use checksums
d88ce5daf66cbf1f4ba4c143a1fb563d9efcf60a46bf9a5e06623329f0251bf3
Upload date
Uploaded using Trusted Publishing?
What is 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}

Release files / rosh_mcp-0.1.1-py3-none-any.whl

Download URL rosh_mcp-0.1.1-py3-none-any.whl
Size 6.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d40a690dfda821d897e81129c8946052e49659be0423a02d07349d936d54eff3
BLAKE2b-256 checksum
How to use checksums
73e5ebd145ceaa74ae8783f81a1421629ba037693f7900fb886ed48708da4141
Upload date
Uploaded using Trusted Publishing?
What is 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}

Security for rosh-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page