roblox-devforum-mcp

roblox-devforum-mcp

An MCP server that gives an AI coding agent the Roblox Developer Forum and the official creator docs.

When your agent hits a Roblox bug, it can check whether Roblox already has it triaged, read the accepted answer, and confirm the API before writing Luau.

No API key, no login, no setup. A small native binary (Rust): starts instantly, uses ~6 MB of RAM.

Install

claude mcp add roblox-devforum -- npx -y roblox-devforum-mcp

DeepSeek Harness:

dsh plugin --profile web add roblox-devforum-mcp

Any other MCP client:

{
  "mcpServers": {
    "roblox-devforum": {
      "command": "npx",
      "args": ["-y", "roblox-devforum-mcp"]
    }
  }
}

No Node.js? Download the binary for your system from the latest release, or build it with cargo install --git https://github.com/EL4CTEO/roblox-devforum-mcp, then use it directly:

claude mcp add roblox-devforum -- /path/to/roblox-devforum-mcp

Tools

Tool	What it does
search_devforum	Search the forum. Filters for category, tag, solved-only, likes and date. Pass several phrasings to run them at once.
search_bugs	Search only the bug-report categories, so a hit means somebody reported the same symptom.
get_thread	Read a topic as Markdown, accepted answer first, code blocks intact.
get_replies	Page through a long thread.
list_recent	Latest or top topics in a category or tag.
list_categories	Every category and tag slug the filters accept.
search_creator_docs	Search the docs by page content; pass path (or a docs URL) to read a page in full.
get_engine_api	Signatures, security levels and deprecations for classes, enums, datatypes and Luau libraries.
check_api_health	Check APIs before you ship: removed, deprecated, wrong case, security-gated, yielding.
get_whats_new	Recent platform changes — for "this worked last week".
get_weekly_recap	Any Roblox Weekly Recap, current or historical.

Every tool is read-only, returns Markdown with source URLs, and stays inside a token budget.

[answered] beside a result means a reply was marked as the solution — by whoever opened the thread, not by Roblox. Roblox does not publish a triage state, so read the thread to see whether staff replied.

Example

"My DataStore:SetAsync keeps failing with 502: API Services rejected request. Is this on Roblox's end?"

The agent runs search_bugs on the error text, get_thread on the best hit, then check_api_health before touching your code.

Configuration

All optional.

Variable	Default	Purpose
DEVFORUM_CACHE_TTL	300	Search cache lifetime, in seconds.
DEVFORUM_TIMEOUT_MS	12000	Per-request timeout.
DEVFORUM_DEADLINE_MS	24000	Total time one request may spend, retries included.
DEVFORUM_MAX_RETRIES	3	Retries on 429 and 5xx.
DEVFORUM_CONCURRENCY	4	Simultaneous requests to the DevForum.
DEVFORUM_CDN_CONCURRENCY	8	Simultaneous requests to GitHub-hosted docs.
DEVFORUM_DOCS_SCAN	14	Doc pages scored per search.
DEVFORUM_CACHE_DIR	OS temp dir	Where the API dump and docs index are cached.
DEVFORUM_BASE_URL	https://devforum.roblox.com	Point at another Discourse instance.
ROBLOX_DEVFORUM_MCP_BINARY	—	npm only: run this binary instead of the bundled one.

A bad value is ignored, with a note on stderr, and the default is used.

Data sources

devforum.roblox.com (public Discourse API), Roblox/creator-docs, and the Roblox-Client-Tracker API dump.

Not affiliated with or endorsed by Roblox Corporation.

Development

Needs Rust 1.99+.

cargo build --release   # target/release/roblox-devforum-mcp
cargo test              # offline unit and tool tests
npm run inspect         # MCP Inspector against the release build

Releases: push a vX.Y.Z tag and CI builds every binary, publishes to npm and attaches the binaries to the GitHub release. See CHANGELOG.md.

License

MIT