# unreadable.gg

> unreadable.gg turns Luau bytecode back into readable source. You can use it on the site, from an executor, over HTTP or over MCP. It aims for the same program, and its `faithful` preset aims for the same bytes. Where it can't be sure, it marks the spot or refuses that function instead of guessing.

The API and the MCP server default to `faithful`. The site starts on `balanced`. The executor client defaults to `balanced`.

The MCP server at POST https://api.unreadable.gg/mcp is stateless, speaks only revision 2026-07-28, and refuses clients that send initialize.

Every connection gets 100 free decompiles a day, with no key or account. Errors and refused decompiles don't count, except `timed-out`.

Send the compiled file as the request body; the response is JSON with the source, a verdict, notes and the setting it was made with:

```sh
curl https://api.unreadable.gg/v1/decompile \
  -H "Content-Type: application/octet-stream" \
  --data-binary @module.luac -o result.json
```

## Docs

- [Everything in one file](https://unreadable.gg/llms-full.txt): every page below, joined.
- [Docs overview](https://unreadable.gg/docs.md): a quickstart, what the verdicts mean, and the presets in a sentence.
- [API](https://unreadable.gg/docs/api.md): the request (the file as it is, or base64 in JSON), the response, options, note codes, error codes, limits, the free tier, keys and accounts, and the decompiler version.
- [Readability](https://unreadable.gg/docs/readability.md): the presets (faithful by default), faithful layout, and what each readability switch prints.
- [Stream](https://unreadable.gg/docs/stream.md): `wss://api.unreadable.gg/v1/stream`, many decompiles over one WebSocket, and the executor client at https://unreadable.gg/decompile.lua.
- [Agents](https://unreadable.gg/docs/agents.md): llms.txt and markdown pages, the OpenAPI schema, and the MCP server (`POST https://api.unreadable.gg/mcp`, stateless, its tools and handles; `POST /v1/handles` takes the file from disk and answers a handle, so its bytes never pass through the model).
- [OpenAPI schema](https://api.unreadable.gg/v1/openapi.json): the whole request and response schema.

## About

- [Luau decompiler](https://unreadable.gg/luau.md): what it reads (Luau bytecode versions 1 to 14, the pre-release format, RSB1-wrapped modules, and place files opened in the tab), what you get back, and how sure it is.
- [Lua versions](https://unreadable.gg/versions.md): which Lua versions are read today (only Luau).
- [Changelog](https://unreadable.gg/changelog.md): every release, newest first, by its decompiler version, with a title and what changed.
- [Privacy](https://unreadable.gg/privacy.md): what's kept, for how long, and who handles it.
- [Terms](https://unreadable.gg/terms.md): the rules for using the site and the API.