# Bloxforge

> Open-source AI agent toolkit for Roblox Studio

- **Type:** MCP server
- **Install:** `agentstack add mcp-princeofscale-bloxforge`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [princeofscale](https://agentstack.voostack.com/s/princeofscale)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [princeofscale](https://github.com/princeofscale)
- **Source:** https://github.com/princeofscale/bloxforge

## Install

```sh
agentstack add mcp-princeofscale-bloxforge
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

BloxForge
  A local-first MCP toolkit for Roblox Studio.
  Build, inspect, automate, playtest, and debug Roblox experiences from Claude Code, Codex, Cursor, Gemini, or any MCP-compatible client.

  [](https://github.com/princeofscale/bloxforge/actions/workflows/ci.yml)
  [](https://www.npmjs.com/package/@princeofscale/bloxforge)
  [](https://www.npmjs.com/package/@princeofscale/bloxforge?activeTab=versions)
  [](LICENSE)
  [](https://telegram.me/ro_bloxforge)

  [Quick start](#quick-start) · [Tools](docs/tools-reference.md) · [Troubleshooting](docs/troubleshooting.md) · [Official Telegram](https://telegram.me/ro_bloxforge)

---

## Why BloxForge?

- **Local-first:** the MCP server and Studio bridge run on your machine; no BloxForge cloud account or remote telemetry.
- **Agent-ready:** inspect scenes, edit Luau, build UI and terrain, run playtests, simulate input, capture logs, and diagnose failures.
- **Safe by default:** destructive actions use confirmation gates, dry runs, backups, limits, and rollback-friendly workflows.
- **Flexible:** choose a token-lean tool profile or load the full toolkit when the task needs it.
- **Open source:** MIT licensed, with no paid tier.

## Quick start

### 1. Enable Studio HTTP requests

In Roblox Studio, open **Game Settings → Security** and enable **Allow HTTP Requests**.

### 2. Add BloxForge to your AI client

```bash
# Claude Code
claude mcp add bloxforge -- npx -y @princeofscale/bloxforge@latest --auto-install-plugin

# Codex CLI
codex mcp add bloxforge -- npx -y @princeofscale/bloxforge@latest --auto-install-plugin

# Gemini CLI
gemini mcp add bloxforge npx --trust -- -y @princeofscale/bloxforge@latest --auto-install-plugin
```

Cursor users can add the same command to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "bloxforge": {
      "command": "npx",
      "args": ["-y", "@princeofscale/bloxforge@latest", "--auto-install-plugin"]
    }
  }
}
```

Use `@next` instead of `@latest` to test the current release candidate.

> Fully close and reopen Roblox Studio after the plugin is first installed or updated.

### 3. Verify the connection

Start the configured MCP client, open Studio, then run:

```bash
npx -y @princeofscale/bloxforge@latest verify
```

## What you can automate

| Workflow | Examples |
|---|---|
| Inspect | Query the instance tree, properties, scripts, tags, attributes, and dependencies |
| Build | Create instances, UI, terrain, lighting, templates, and reusable models |
| Edit Luau | Read, patch, search, validate, and safely replace script source |
| Test | Start playtests, simulate input, run assertions, and compare episodes |
| Debug | Capture runtime logs, diagnostics, screenshots, memory, and profiler data |
| Integrate | Import/export builds, sync local files, upload assets, and record provenance |

A useful first prompt:

> Inspect this place, build a six-stage obby with checkpoints and a timer, run a playtest, then fix any runtime errors.

## Tool profiles

Select a profile with `--profile ` or `BLOXFORGE_TOOL_PROFILE`:

| Profile | Purpose |
|---|---|
| `core` | Inspection, scripts, and essential editing; token-lean default |
| `builder` | UI, terrain, templates, assets, and scene construction |
| `tester` | Runtime debugging, playtesting, input, and assertions |
| `full` | Every available tool |
| `inspector` | Read-only inspection through `@princeofscale/bloxforge-inspector` |

## Optional Open Cloud access

Most features need no Roblox credentials. Asset uploads and Creator Store access require an optional [Open Cloud API key](https://create.roblox.com/dashboard/credentials?activeTab=ApiKeysTab) with `asset:read` and `asset:write`:

```bash
export ROBLOX_OPEN_CLOUD_API_KEY="your-api-key"
```

Never commit this key or place it in MCP configuration shared with others.

## Documentation

- [Tool reference](docs/tools-reference.md)
- [Architecture](docs/architecture.md)
- [Known limitations](docs/known-limitations.md)
- [Troubleshooting](docs/troubleshooting.md)
- [Security policy](SECURITY.md)

## Community

News, release notes, and project discussion are published in the [official BloxForge Telegram channel](https://telegram.me/ro_bloxforge).

Bug reports and feature requests belong in [GitHub Issues](https://github.com/princeofscale/bloxforge/issues).

## License

[MIT](LICENSE) © BloxForge contributors.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [princeofscale](https://github.com/princeofscale)
- **Source:** [princeofscale/bloxforge](https://github.com/princeofscale/bloxforge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-princeofscale-bloxforge
- Seller: https://agentstack.voostack.com/s/princeofscale
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.