roblox-brain MCP server
Commit Nov 15, 2026Provides Claude with a curated Roblox knowledge base to improve scripting, VFX, UI, and game design through proven practices and Luau examples.
Also known as AkitoDevs/roblox-brain
- Stars
- 6
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 15, 2026
- License
- MIT
What is roblox-brain MCP?
roblox-brain provides Claude with a curated Roblox knowledge base to improve scripting, VFX, UI, and game design through proven practices and Luau examples.
Summary generated from the project's README
About roblox-brain MCP server
Improving Roblox game development through Claude is what roblox-brain enables by providing a curated knowledge base for scripting, VFX, UI, and game design. This plugin works locally within Claude Code and requires Node.js 18 or newer to function. It functions by having Claude search a specialized repository of proven practices and Luau examples before generating code, ensuring that outputs follow current Roblox APIs rather than relying on guesswork.
Developers use this tool to handle complex tasks such as implementing secure data saving with session locking, managing monetization through correct ProcessReceipt logic, and designing responsive UI layouts. The server is designed to be lightweight, using a minimal amount of tokens per session. It also includes an optional feedback loop where filtered, anonymous tips about successful fixes can be shared with the maintainer to improve future knowledge releases.
What you can do with it
- 1Secure monetization implementationAsk Claude to create a developer product purchase system that uses ProcessReceipt to prevent duplicate or lost transactions.
- 2Reliable player data managementRequest a data saving system that utilizes session locking to prevent data loss when players switch servers.
- 3Advanced Luau scriptingHave Claude write complex game mechanics like raycast guns or pathfinding NPCs using modern Luau standards.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableakitodevs/roblox-brain is public and reachablegithub.com/akitodevs/roblox-brain ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/akitodevs/roblox-brain ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubBetter Roblox help from your Claude, for scripting, VFX, UI, lighting, modeling and more.
Install · What you get · How it works · Sharing and privacy · Usage cost
Found a problem? Open an issue and it will get looked at.
What you get
Roblox Brain is a free plugin for Claude. It gives your Claude a curated, generic Roblox knowledge base and checks it before writing Roblox code, so your results start from solid practice instead of guesswork.
| Area | Helps Claude with |
|---|---|
| Scripting | Module structure, remotes and rate limiting, strict typing, memory leaks, performance and streaming, pathfinding NPCs, round loops, ProximityPrompts, tools, raycast guns, sound and music, teleporting between places |
| Data saving | Safe saving with retries and schema migration, session locking, leaderboards |
| Monetization | Game passes, developer products with a correct ProcessReceipt, ethical pricing, paid random item rules, retention and onboarding |
| Security | Validating remotes and auditing free-model kits before reuse |
| VFX | Particles, beams, trails, timing and color so effects read well |
| UI | Responsive layouts, clean menus, animation and polish |
| Lighting | Mood, light direction, glow, color grading and atmosphere |
| Modeling | Shapes, detail, color and building props that look crafted |
| Animation and combat | R6 combat animation, animation events and priority, hit detection and hit feel |
| Game design | Core loops, lobbies, collect and tycoon systems, RNG reveals, icons and thumbnails |
The scripting entries include working Luau examples that follow current Roblox APIs. The knowledge is written in our own words, kept generic, and checked before every release. It never replaces the skills you already have. Claude uses whichever fits the task best.
Example: what changes for a scripting prompt
Prompt: "Add a button that sells 100 coins for Robux." (Shortened, illustrative.)
Before: a common mistake, and an easy one to make without guidance, is to grant the coins when the purchase window closes:
MarketplaceService.PromptProductPurchaseFinished:Connect(function(userId, productId, purchased)
if purchased then addCoins(userId, 100) end -- not proof of payment; can double-grant or lose coins
end)
After, with Roblox Brain: Claude finds monetization/gamepasses-dev-products and grants inside ProcessReceipt, records the purchase id in the player's save, and only reports success once it is saved:
MarketplaceService.ProcessReceipt = function(receipt)
local player = Players:GetPlayerByUserId(receipt.PlayerId)
local profile = player and Data.get(player)
if not profile then return Enum.ProductPurchaseDecision.NotProcessedYet end
if profile.purchases[receipt.PurchaseId] then return Enum.ProductPurchaseDecision.PurchaseGranted end
profile.coins += 100
profile.purchases[receipt.PurchaseId] = true
if not Data.saveNow(player) then return Enum.ProductPurchaseDecision.NotProcessedYet end
return Enum.ProductPurchaseDecision.PurchaseGranted
end
It also points Claude to session-locked saving, so the coins can't be lost or duplicated when the player hops servers.
Install
You need Claude Code and Node.js 18 or newer. There is no npm install step.
Inside Claude Code, run:
/plugin marketplace add AkitoDevs/roblox-brain
/plugin install roblox-brain@roblox-brain
Restart Claude Code, then ask it to build something for Roblox. It looks at the knowledge first.
Prefer a terminal?
claude plugin marketplace add AkitoDevs/roblox-brain
claude plugin install roblox-brain@roblox-brain
Update later:
claude plugin marketplace update roblox-brain
claude plugin update roblox-brain@roblox-brain
Auto-update is off by default for marketplaces like this one. To turn it on once:
- In Claude Code, run
/pluginand open the Marketplaces tab. - Select roblox-brain, then select Enable auto-update.
Claude Code then checks for a new release in the background after you start a session. The new knowledge loads the next time you start Claude Code, or right away with /reload-plugins.
How it works
flowchart TD
A([You ask Claude for Roblox help]) --> B[Roblox Brain searches the knowledge]
B --> C[Claude writes with proven practice]
C -. optional short tip, filtered .-> D[Maintainer reviews]
D -- approved --> E[Better knowledge in the next release]
E --> B
- Ask as usual. When your task is about Roblox, Claude searches the knowledge first.
- Better output. It uses what it finds, plus anything you already have installed.
- Tips flow back. After a task, Claude may share one short, filtered tip about what worked.
- Everyone benefits. The maintainer reviews tips by hand, and approved ideas go into the next release.
Sharing tips and privacy
Sharing is on by default and easy to turn off. The first time you use Roblox Brain in a project, Claude shows a short notice explaining it. Nothing is shared in that project before then.
- What a tip contains: the topic, the problem, the fix and any Roblox API names. That's all.
- What it leaves out: your code, names, ids, links and emails. Tips are filtered on your computer before they are sent, and again on the server.
- You can see everything: each shared tip is saved in your sharing history at
~/.roblox-brain/sent-lessons.md. - Nothing is merged automatically: every tip is reviewed by hand before it can change the knowledge.
Say any of these in Claude Code:
| Say | What happens |
|---|---|
| "turn off Roblox Brain sharing" | Stops sharing everywhere on your computer |
| "turn on Roblox Brain sharing" | Turns it back on |
| "show my shared tips" | Shows your sharing history |
| "delete my shared tips" | Deletes everything you've shared from the maintainer's copy |
The full details, including retention and what happens if the project ever ends, are in PRIVACY.md.
Usage cost
Roblox Brain uses a small amount of your Claude usage. Measured with Claude Code's /context and real sessions:
- In every session: about 350 tokens, whether or not you do Roblox work. The 4 tool definitions (about 600 tokens) load only when Claude first uses one.
- In a Roblox task: one search returns the best match in full plus 2 short excerpts, usually about 700 tokens and never much over 1,200. In our test of a simple shop UI request, a session that searched the knowledge cost about 15% more than the same request without the plugin.
- Kept small on purpose: Claude searches once per task, only for Roblox or Luau work, and never repeats a search. Our tests fail if the always-on part or a search result grows past its limit.
Run /context in Claude Code and look for roblox-brain to see it yourself. Numbers vary with your setup and model, so treat them as estimates.
Contributing
- Found a bug or have an idea? Open an issue.
- Want to help improve the knowledge? Just use the plugin with sharing on. Good tips from real projects are the best source.
- Maintainer notes: how releases, triage and the review loop work are in docs/MAINTAINING.md.
License
MIT, see LICENSE. The knowledge entries in knowledge/ are part of this repository and are included under the same license.
Roblox Brain is an independent community project and is not affiliated with Roblox Corporation.
roblox-brain MCP questions
How do I install roblox-brain?
Inside Claude Code, run /plugin marketplace add AkitoDevs/roblox-brain followed by /plugin install roblox-brain@roblox-brain.
Does using this plugin cost extra?
It uses a small amount of your existing Claude usage, typically around 350 tokens per session and up to 1,200 tokens for a specific Roblox task search.
Is my code shared when tips are sent?
No, tips are filtered to include only the topic, problem, fix, and API names, specifically excluding your code, IDs, and personal information.