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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rosh_mcp-0.1.1.tar.gz (5.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rosh_mcp-0.1.1-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

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

Hashes for rosh_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 528ae7d0983273315807f68495c2dd542edd41227bd0798976ab2c3eafe32eaf
MD5 33ff0ebad6f6c38e202d6108d4993366
BLAKE2b-256 d88ce5daf66cbf1f4ba4c143a1fb563d9efcf60a46bf9a5e06623329f0251bf3

See more details on using hashes here.

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

Hashes for rosh_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d40a690dfda821d897e81129c8946052e49659be0423a02d07349d936d54eff3
MD5 c2650329af21efdbd82588d371ea3b78
BLAKE2b-256 73e5ebd145ceaa74ae8783f81a1421629ba037693f7900fb886ed48708da4141

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page