roblox-devforum-mcp
Models & DataEL4CTEO/roblox-devforum-mcp
MCP server providing Roblox Developer Forum and creator docs search, bug status, API health checks, and more for AI coding agents.
- ai
- ai-agents
- claude
- claude-code
- deepseek-harness
- developer-tools
- devforum
- dsh
- dsh-plugin
- game-development
- llm
- luau
- mcp
- mcp-server
- model-context-protocol
- nodejs
- roblox
- roblox-development
- roblox-studio
- typescript
Verification and compatibility
This section shows evidence collected by the catalog. Undeclared information is labeled as unknown.
- Current-version compatibility
- Verified on the catalog Harness version
- Declared Harness range
- Not declared
- Declared platforms
- Not declared
- Profiles
- web
- Build approval
- No requirement detected
- Permissions
- Not declared
- External services
- Not declared
- Telemetry
- Unknown
This is not a security endorsement. Review source, permissions, and configuration before installing.
View evidence and scope
Verification covers only the named source, version, and Harness environment. It does not guarantee future compatibility.
roblox-devforum-mcp@1.2.5- The plugin completed a load check in an isolated environment.
README
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 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 server
License
MIT
