Skip to main content
Glama
roblox-logics-mcp

roblox-logics-mcp


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 build

Register it with Claude Code:

claude mcp add roblox-logics -- node /absolute/path/to/roblox-logics-mcp/dist/index.js

Other 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

search_logics

Ask in plain words, get ranked one-line summaries.

get_logic

Read one logic, or only the sections you need.

search_code

Find logics using a Luau API, e.g. UpdateAsync.

find_related

Pick up neighbouring parts of the same system.

list_categories

See what is covered.

list_logics

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 tools
get_logicGet a logic write-upA
Read-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 categoriesA
Read-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 categoryA
Read-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 APIA
Read-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 logicsA
Read-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

    A4.5/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers