Repository avatar
Developer Tools
v0.2.8
active

mcp

io.github.luaward/mcp

Luau script protection, licensing, live Roblox in-game QA, and Windows Computer Use.

Documentation

Luaward logo

Luaward Official AI Plugin

Luau script protection, licensing, and live Roblox in-game and Studio QA for Claude, Antigravity, Gemini CLI, Codex, and MCP agents

Protect, build, test in a live Roblox session, inspect GUI and remotes, and sync with Roblox Studio directly from your coding agent.

Overview

The Luaward plugin connects Antigravity to your Luaward workspace over Luaward's hosted MCP server (https://luaward.com/mcp) using OAuth 2.1, and pairs two specialized skills (luaward-workspace and luaward-live-qa) plus workspace safety rules (rules/AGENTS.md).

  • Workspace & Protection: create and deploy protected Luau scripts (fast, balanced, max), stage drafts (publish: false), test builds, promote/roll back live versions (promote_build), manage license keys/HWID resets, and resolve player error reports.
  • Live Game QA & Profiling: inspect connected sessions, run isolated tests (run_and_collect with clean_env and resource cleanup via cleanup_run), profile FPS/memory (benchmark_session), inspect UI handles (gui_snapshot), and interact safely (ui_controls).
  • Windows Desktop & Visual QA (Optional Hybrid Bridge): combine Luaward Cloud (https://luaward.com/mcp) and local file_path script loading with @luaward/mcp (npx -y @luaward/mcp) on Windows for hardware Win32 input (os_click, desktop_mouse, desktop_keyboard), OS PNG screenshots and visual diffs (desktop_screenshot, compare_screens), window/process control (desktop_launch, desktop_window, desktop_ui_tree).

Quick start

1. Install the plugin

From Antigravity Customizations -> Plugins (once published to the Marketplace), find Luaward and click Install. Or install directly from a local checkout:

agy plugin validate .
agy plugin install .

2. Connect your Luaward account (OAuth 2.1)

Installing the plugin enables its skills and rules. Sign in to unlock Luaward Cloud MCP tools.

  1. Open Agent settings -> Customizations.
  2. Click Authenticate next to the luaward MCP server entry in the Luaward plugin.
  3. Sign in to your Luaward account in the browser and authorize your workspace.
  4. Copy the authorization code if prompted, paste it into the authentication field in settings, and click Submit.

Antigravity refreshes OAuth access tokens automatically. You can also generate a personal scoped MCP token (lwm_...) anytime at dash.luaward.com/dashboard/ai.

3. Optional: Enable Windows Desktop Bridge (@luaward/mcp)

If you develop on Windows and want hardware Win32 mouse/keyboard automation, window management, OS screenshots, and local file_path script loading, add @luaward/mcp to your local MCP config alongside your standalone Potassium or Roblox Studio MCP configs (if used):

{
  "mcpServers": {
    "luaward": {
      "command": "npx",
      "args": ["-y", "@luaward/mcp@0.2.8"],
      "env": {
        "LUAWARD_MCP_TOKEN": "lwm_YOUR_48_HEX_TOKEN"
      }
    }
  }
}

4. Try it out

Ask Antigravity:

List my Luaward projects, scripts, and connected live Roblox game sessions.

Or try:

  • Run a live in-game QA check on my Roblox session and inspect GUI controls and remotes.
  • Diff my open Roblox Studio place against the live game and mirror missing remotes or GUI.
  • Deploy a draft build from my script, test it in-game, and promote it when clean.

Troubleshooting

Installed, but Luaward tools do not appear

Check that the Luaward plugin is enabled in Agent settings -> Customizations, then click Authenticate on the luaward MCP server entry (or check that your workspace has an active session/token).

Browser OAuth finished, but Antigravity is still waiting

Copy the authorization code shown after approving access on luaward.com/oauth, paste it into the authentication prompt inside Antigravity settings, and click Submit.

Live game tools return "no game is connected"

Connect a live game session from the Luaward Dashboard ("Test in game"), or run the workspace pair snippet inside your connected Roblox executor session.

Links & Development

NPM
@luaward/mcp
Install Command
npm install @luaward/mcp

Remote