
mcp
io.github.luaward/mcp
Luau script protection, licensing, live Roblox in-game QA, and Windows Computer Use.
Documentation
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_collectwithclean_envand resource cleanup viacleanup_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 localfile_pathscript 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.
- Open Agent settings -> Customizations.
- Click Authenticate next to the
luawardMCP server entry in the Luaward plugin. - Sign in to your Luaward account in the browser and authorize your workspace.
- 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
- Workspace MCP Docs: luaward.com/docs/ai-tools/workspace-mcp
- NPM Hybrid Bridge (
@luaward/mcp): npmjs.com/package/@luaward/mcp - Release & Marketplace Guide: RELEASING.md
@luaward/mcpnpm install @luaward/mcp