<p align="center"><img src="assets/logo.svg" width="96" alt="Brickwise logo"></p>

<h1 align="center">Brickwise — Free Edition</h1>

<p align="center">An MCP server that gives your AI assistant sourced Roblox game-development knowledge, so it stops guessing.</p>

<p align="center"><a href="https://brickwise.dev"><b>Get the full edition (600+ logics) →</b></a></p>

---

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.

## Install

```bash
git clone https://github.com/EL4CTEO/roblox-logics-mcp.git
cd roblox-logics-mcp
npm install
npm run build
```

Register it with Claude Code:

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

Other clients (`.mcp.json`, Cursor, Claude Desktop):

```json
{
  "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`](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.