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.

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"]
    }
  }
}

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 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.

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

npm install && npm run build
npm test          # offline unit and server tests
npm run inspect   # MCP Inspector against the built server

License

MIT