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