roblox-devforum-mcp

Give your AI coding agent the Roblox DevForum and official creator docs — check if a bug is already known, read the accepted answer, and verify APIs before writing Luau.

GitHub

Try this MCPSponsored

Documentation

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

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