Skip to main content
Glama

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. A small native binary (Rust): starts instantly, uses ~6 MB of RAM.

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

No Node.js? Download the binary for your system from the latest release, or build it with cargo install --git https://github.com/EL4CTEO/roblox-devforum-mcp, then use it directly:

claude mcp add roblox-devforum -- /path/to/roblox-devforum-mcp

Related MCP server: Chlorpromazine MCP Server

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 (or a docs URL) 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.

ROBLOX_DEVFORUM_MCP_BINARY

—

npm only: run this binary instead of the bundled one.

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

Needs Rust 1.99+.

cargo build --release   # target/release/roblox-devforum-mcp
cargo test              # offline unit and tool tests
npm run inspect         # MCP Inspector against the release build

Releases: push a vX.Y.Z tag and CI builds every binary, publishes to npm and attaches the binaries to the GitHub release. See CHANGELOG.md.

License

MIT

Available Tools

11 tools
check_api_healthCheck Roblox APIs for deprecationA
Read-only

Batch-check Roblox APIs before you ship Luau that uses them. Pass entries like "Humanoid.MoveTo", "BodyVelocity", "Enum.Material.Neon", "task.wait" or "wait" and each is verified against the live API dump and the official docs: does it still exist, is it spelled with the right case, is it deprecated (with the official replacement where the docs give one), is it locked behind a security level normal scripts cannot use, and does it yield. Use this whenever you are about to write or review Roblox code — models often reproduce APIs that Roblox retired years ago.

Inputs: members (required), max_tokens.

get_engine_apiLook up the Roblox engine APIA
Read-only

Authoritative signature lookup from the live Roblox API dump: a class's properties, methods, events and callbacks with parameter types, security level, deprecation and thread safety. Use this to confirm a method exists, check whether it is deprecated or server-only, or find the right member name before writing Luau.

Inputs: name (required), filter, max_tokens, member_types, +1 more.

get_repliesPage through thread repliesA
Read-only

Fetch a page of replies from a DevForum topic in post order. Use after get_thread when the answer is buried further down a long thread.

Inputs: page, limit, topic, topic_id, +1 more.

get_threadRead a DevForum threadA
Read-only

Read a DevForum topic as Markdown: the original post plus the most useful replies, with the accepted answer hoisted to the top. Accepts a topic id or a full DevForum URL. Code blocks are preserved. Use get_replies to page through the rest.

Inputs: topic, topic_id, max_posts, max_tokens.

get_weekly_recapRead a Roblox Weekly RecapA
Read-only

Read any Roblox Weekly Recap, current or historical. Roblox publishes one every Friday summarising what shipped that week: betas, engine updates, Marketplace and Studio changes. Use week to step back through the archive (0 = newest, 1 = the week before, …), before to jump to the recap covering a past date, or list to see the archive index. To find when a specific feature or regression landed, list the archive and read the recaps around that date.

Inputs: list, week, limit, before, +1 more.

get_whats_newWhat Roblox shipped recentlyA
Read-only

A digest of recent Roblox platform changes: the official Weekly Recap, engine Release Notes, and Announcements. Use this when a game regressed for no obvious reason ("this worked last week"), when checking whether a Roblox update explains new behaviour, or when the user asks what is new on the platform. Returns the latest Weekly Recap body plus everything else published inside the time window.

Inputs: days, limit, max_tokens, include_recap_body.

list_categoriesList DevForum categories and tagsA
Read-only

List the DevForum category tree and the most-used tags. Call this when you are unsure which category or tag slug to pass to search_devforum, search_bugs, or list_recent.

Inputs: tag_limit, include_tags.

list_recentList recent or top DevForum topicsA
Read-only

Browse a category or tag without a search query. Use release-notes / announcements to check whether a recent Roblox update explains a regression, or scripting-support to see what is breaking for others right now.

Inputs: tag, limit, period, listing, +2 more.

search_bugsSearch Roblox bug reportsA
Read-only

Search only the DevForum bug-report categories (engine, Studio, cloud services, mobile, website, Creator Hub, purchasing). Use this to answer "is this a known Roblox bug or is it my code?" — a hit means somebody reported the same symptom, with its category, last-activity date and whether a reply was marked as the solution. Roblox does not tag reports with a public triage state, so read the thread with get_thread to see whether staff actually answered.

Inputs: query (required), area, after, limit, +1 more.

search_creator_docsSearch official Roblox documentationA
Read-only

Find and read pages from Roblox's official creator documentation (create.roblox.com/docs). Call with query to list matching pages, then call again with path from a result to read that page in full. Use this for intended behaviour, limits and quotas, and guide-level explanations — pair it with search_devforum for what actually happens in production.

Inputs: path, limit, query, max_tokens.

search_devforumSearch the Roblox DevForumA
Read-only

Full-text search across the Roblox Developer Forum. Use this first when a Roblox bug, error message, or engine behaviour needs community context: paste the literal error string (e.g. "502: API Services rejected request") or a symptom description. Results are re-ranked to favour solved and recent threads. Follow up with get_thread on the topic_id you want to read.

Inputs: query (required), tags, after, limit, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools target clearly distinct intents: official docs vs. DevForum search vs. bug reports vs. thread reading vs. API lookup vs. recap browsing. There are some overlaps — search_bugs is a constrained form of search_devforum, get_whats_new overlaps with get_weekly_recap and list_recent, and check_api_health overlaps with get_engine_api — but the descriptions make the intended boundaries fairly clear.

    Naming Consistency5/5

    All tool names use snake_case and follow a predictable verb-first pattern: search_*, list_*, get_*, and check_*. The naming is consistent throughout and each name maps cleanly to a resource or action.

    Tool Count5/5

    Eleven tools is well-scoped for a Roblox documentation/community/API research server. Each tool appears to earn its place, covering search, browsing, thread retrieval, API verification, and release tracking without excessive surface area.

    Completeness5/5

    The surface covers the apparent domain comprehensively: official docs search/read, DevForum category discovery, full-text and bug-specific search, thread and reply retrieval, recent browsing, API existence/signature checks, and weekly recap/what's-new history. No obvious lifecycle gap or dead end is apparent.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers