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-mcpdsh plugin --profile web add roblox-devforum-mcpAny 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 reports and show Roblox's status tag: confirmed, fixed, cannot-reproduce. |
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 from the live API dump. |
check_api_health |
Check APIs before you ship: removed, deprecated, 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.
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_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. |
GITHUB_TOKEN |
— | Raises the GitHub rate limit for the docs file listing. |
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 serverLicense
MIT