roblox-logics-mcp
Provides sourced Roblox game-development knowledge, including tools to search logics, retrieve detailed write-ups, search code examples by Luau API, find related systems, and browse categories and logics.
Ask your assistant "how do I save player data without losing items?" and it finds the real mechanism, the pitfalls and the source links. Every logic is written up from DevForum threads, Creator Docs or GitHub repos, with links back.
Works with Claude Code, Cursor and any MCP client.
Free vs Full
Free | Full | |
Logics | 50 | 600+ |
Categories | 8 core | 19 |
Runs | Locally | Hosted, nothing to install |
Updates | Occasional | Every new logic, for life |
Price | Free | €7 one-time |
Free categories: data persistence, networking & security, combat, monetization, UI/UX, NPC & AI, performance, libraries. The full edition adds movement, physics & VFX, world systems, game loops, tooling, audio, avatars, animation, input, social and live-ops.
Related MCP server: robloxstudio-mcp
Install
git clone https://github.com/EL4CTEO/roblox-logics-mcp.git
cd roblox-logics-mcp
npm install
npm run buildRegister it with Claude Code:
claude mcp add roblox-logics -- node /absolute/path/to/roblox-logics-mcp/dist/index.jsOther clients (.mcp.json, Cursor, Claude Desktop):
{
"mcpServers": {
"roblox-logics": {
"command": "node",
"args": ["/absolute/path/to/roblox-logics-mcp/dist/index.js"]
}
}
}Tools
Tool | Use it to |
| Ask in plain words, get ranked one-line summaries. |
| Read one logic, or only the sections you need. |
| Find logics using a Luau API, e.g. |
| Pick up neighbouring parts of the same system. |
| See what is covered. |
| Browse one category. |
Search returns summaries only, so browsing is cheap. Your assistant only pays for the full write-up it picks.
Adding a logic
Logics are markdown files at logics/<category>/<id>.md. See docs/AUTHORING.md for the format, then run npm run validate and npm run build:index.
License
Code: MIT. Content is community-sourced and summarized in our own words, with links to the originals. Always check the cited sources before shipping code.
Brickwise is an independent project, not affiliated with, endorsed by or sponsored by Roblox Corporation or the Luau team. Roblox and Luau are trademarks of Roblox Corporation.
Available Tools
6 toolsget_logicGet a logic write-upARead-only
Fetch the full write-up for one logic: the problem it solves, the numbered mechanism, illustrative Luau, pitfalls and source links. Call it only with an id returned by search_logics, list_logics or find_related — ids are not guessable. This is the expensive call: pass sections to pull just what you need (e.g. ['how-it-works'] to understand the mechanism, ['code'] to see the Luau).
Inputs: id (required), sections.
list_categoriesList logic categoriesARead-only
Show the categories of the Roblox logics knowledge base with a one-line blurb and how many logics each holds. Call this first when you do not know which area a problem belongs to, or to check whether the database covers a topic at all. Cheap (~500 tokens). Do NOT call it before every search — if you already have a concrete question, go straight to search_logics.
Inputs: no named parameters.
list_logicsList logics in a categoryARead-only
List every logic in one category as id + title + summary. Use it to browse when the request is vague ('what data-persistence patterns do you have?') or after search_logics came back empty. For a specific question, search_logics is cheaper and better targeted.
Inputs: category (required).
search_codeFind logics using a Luau APIARead-only
Find logics whose example code uses a specific Luau symbol or Roblox API — 'UpdateAsync', 'BindToClose', 'ProcessReceipt', 'RaycastParams', 'task.defer'. Returns a short snippet with surrounding lines. This is a literal substring match over code blocks, not prose search: use search_logics for conceptual questions.
Inputs: symbol (required), limit.
search_logicsSearch Roblox logicsARead-only
Primary entry point. Search the knowledge base for how to build a Roblox system — 'stop exploiters firing remotes', 'save player data safely', 'melee hitbox that feels fair on high ping'. Returns metadata only (id, title, category, difficulty, summary) so browsing is cheap; follow up with get_logic(id) for the full write-up. Use search_code instead when you are looking for a specific Luau API such as UpdateAsync or BindToClose.
Inputs: query (required), tags, limit, category, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools are cleanly separated: get_logic fetches, search_code does literal code matching, and find_related traverses links. The only friction is the trio list_categories / list_logics / search_logics, which all touch browsing, but the descriptions explicitly state when to use each, largely resolving the overlap.
Every tool is snake_case with a predictable verb_noun shape (list_categories, search_logics, get_logic, search_code, find_related). No camelCase or vague single-word names, so the pattern is fully consistent.
Six tools is well-scoped for a read-only knowledge base: browse, search, code-search, fetch, and relate. Each tool earns its place with no redundant or filler operations.
The surface covers the full read lifecycle: discover categories, search concepts, search code, fetch full detail, and explore related entries. Minor gaps like tag-based filtering or citation export exist, but core workflows have no dead ends.
Related MCP Connectors
Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.
Governed, auditable knowledge your team curates for its AI assistants, self-hostable
Shared knowledge base for AI agents. Semantic search across agents, no setup required — just a URL.
Provide your AI coding tools with token-efficient access to up-to-date technical documentation for…
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables AI agents to intelligently search and retrieve Roblox documentation through semantic search and vector embeddings, providing natural language access to complete Roblox Creator Documentation.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to explore Roblox Studio game structure, read and edit scripts, and perform bulk changes locally and safely.MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants like Claude and Gemini to Roblox Studio, enabling game structure exploration, script editing, UI generation, style extraction, and bulk changes locally and safely.4 npmMIT
- AlicenseNot gradedqualityDmaintenanceBridges AI assistants to Roblox Studio with 51 tools for exploring, editing, and automating game development, all locally via HTTP polling.1,057 npm7MIT