---
slug: "pi-roblox-studio-tools"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/eiei114/pi-roblox-studio-tools@main/README.md"
repo: "https://github.com/eiei114/pi-roblox-studio-tools"
source_file: "README.md"
branch: "main"
---
# Pi Roblox Studio Tools

[![CI](https://github.com/eiei114/pi-roblox-studio-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/eiei114/pi-roblox-studio-tools/actions/workflows/ci.yml)
[![Publish](https://github.com/eiei114/pi-roblox-studio-tools/actions/workflows/publish.yml/badge.svg)](https://github.com/eiei114/pi-roblox-studio-tools/actions/workflows/publish.yml)
[![npm version](https://img.shields.io/npm/v/pi-roblox-studio-tools.svg)](https://www.npmjs.com/package/pi-roblox-studio-tools)
[![npm downloads](https://img.shields.io/npm/dm/pi-roblox-studio-tools.svg)](https://www.npmjs.com/package/pi-roblox-studio-tools)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Pi package](https://img.shields.io/badge/pi-package-purple.svg)](https://pi.dev/packages)
[![npm Provenance](https://img.shields.io/badge/npm-Provenance-blue.svg)](docs/release.md)
<a href="https://buymeacoffee.com/ekawano114m"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" width="217" height="60"></a>

> On-demand Roblox Studio MCP tools for Pi without a long-running MCP server.

## What this is

Pi Roblox Studio Tools adds Pi-native tools for working with Roblox Studio MCP while avoiding an always-on MCP server process.

The package locates the official `StudioMCP` command on Windows and macOS. MCP tools spawn StudioMCP only when a Pi tool call needs it, then shut it down after the request.

## Features

- Cross-platform StudioMCP path detection for Windows and macOS
- Pi command: `/roblox-studio-mcp-status`
- Pi tool: `roblox_studio_mcp_status` with initialize probe
- Distinguishes missing StudioMCP from installed-but-not-callable states
- No persistent MCP process by default
- TypeScript-first Pi package structure

## Install

Install the published npm package with Pi:

```bash
pi install npm:pi-roblox-studio-tools
```

Install into the current project instead of your user Pi settings:

```bash
pi install npm:pi-roblox-studio-tools -l
```

Or install from GitHub:

```bash
pi install git:github.com/eiei114/pi-roblox-studio-tools
```

Try it without permanently installing:

```bash
pi -e npm:pi-roblox-studio-tools
```

## Quick start

Try this package locally:

```bash
pi -e .
```

Then run:

```txt
/roblox-studio-mcp-status
```

The agent can also call:

```txt
roblox_studio_mcp_status
```

Status output reports whether StudioMCP was found and whether initialize succeeded.

## StudioMCP paths

Windows:

```txt
%LOCALAPPDATA%\Roblox\mcp.bat
%LOCALAPPDATA%\Roblox Studio\StudioMCP.exe
```

macOS:

```txt
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
~/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
```

## Package contents

| Path | Purpose |
|---|---|
| `extensions/` | Pi TypeScript extension entrypoints |
| `lib/` | Shared StudioMCP discovery and one-shot stdio MCP client helpers |
| `skills/` | Agent Skill for Roblox Studio MCP workflow guidance |
| `docs/` | Architecture, release, and setup docs |

## Development

```bash
npm install
npm run ci
npm pack --dry-run
```

`npm run ci` runs typecheck, tests, and `npm run pack:check` (`npm pack --dry-run`). Run `npm pack --dry-run` directly when you only need to verify the published tarball contents.

## Release

This package uses npm Trusted Publishing with GitHub Actions OIDC, so no
`NPM_TOKEN` is required.

```bash
npm version patch
git push
```

On `main`, a `package.json` version bump triggers auto-release, which creates
the tag and dispatches `publish.yml`.

See [`docs/release.md`](https://github.com/eiei114/pi-roblox-studio-tools/blob/HEAD/docs/release.md) for setup details.

## Security

Pi packages can execute code with your local permissions. Review extensions before installing third-party packages.

This package is designed to avoid a long-running MCP process. Studio mutation tools run without confirmation UI, so review tool names and arguments carefully.

For vulnerability reporting, see [`SECURITY.md`](https://github.com/eiei114/pi-roblox-studio-tools/blob/HEAD/SECURITY.md).

## Links

- npm: https://www.npmjs.com/package/pi-roblox-studio-tools
- GitHub: https://github.com/eiei114/pi-roblox-studio-tools
- Issues: https://github.com/eiei114/pi-roblox-studio-tools/issues

## License

MIT