Roblox Studio MCP Server

Quick start · Tools · Troubleshooting · Official Telegram

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.

Related MCP server: Melo

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

# 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:

{
  "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:

npx -y @princeofscale/bloxforge@latest verify

What you can automate

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 <name> or BLOXFORGE_TOOL_PROFILE:

Optional Open Cloud access

Most features need no Roblox credentials. Asset uploads and Creator Store access require an optional Open Cloud API key with asset:read and asset:write:

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

• Architecture

• Known limitations

• Troubleshooting

• Security policy

Community

News, release notes, and project discussion are published in the official BloxForge Telegram channel.

Bug reports and feature requests belong in GitHub Issues.

License

MIT © BloxForge contributors.