MCP Roblox Docs

🚀 MCP Roblox Docs

A comprehensive MCP (Model Context Protocol) server providing complete Roblox ecosystem documentation. Query API references, FastFlags, Open Cloud REST API, Luau language docs, and DevForum - all from your AI assistant.

✨ Features

• Always Up-to-Date: Automatically syncs from Roblox's official sources
• 27 Specialized Tools: Complete coverage of the Roblox ecosystem
• Full-Text Search: Search across 850+ classes, 35,000+ members, 14,000+ FastFlags, 865 Cloud API endpoints
• DataTypes & Libraries: 44 DataTypes (Vector3, CFrame, etc.) and 11 Luau standard libraries
• Multi-Language: Supports 15 languages including English, Indonesian, Japanese, Korean, Chinese
• DevForum Integration: Search community discussions with intelligent caching
• Open Cloud API: Full REST API documentation with auth, parameters, and response schemas
• FastFlags Reference: Search and explore 14,000+ engine flags
• Luau Language Docs: Complete language reference and globals
• Zero Cost: 100% free, no API keys required
• Optimized: Lazy loading, in-memory caching, DevForum result caching
• Fast Sync: Parallel downloads (7 - 10x faster), retry logic, HTTP compression

📦 Installation

🚀 Quick Start (Recommended)

The easiest way to use this MCP server is via uvx:

uvx mcp-roblox-docs

No installation, no setup - it just works!

📂 From Source

git clone https://github.com/nhattamgithub/mcp-roblox-docs
cd mcp-roblox-docs
uv sync
uv run mcp-roblox-docs

⚙️ Configuration

🖥️ Claude Desktop

Add to your Claude Desktop config:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "roblox-docs": {
      "command": "uvx",
      "args": ["mcp-roblox-docs"]
    }
  }
}

💻 Cursor / Other MCP Clients

{
  "mcpServers": {
    "roblox-docs": {
      "command": "uvx",
      "args": ["mcp-roblox-docs"]
    }
  }
}

Or if running from source:

{
  "command": "uv",
  "args": ["--directory", "/path/to/mcp-roblox-docs", "run", "mcp-roblox-docs"]
}

🛠️ Available Tools (27 Total)

🌟 Core API Tools

🚀 Extended API Tools

🚩 FastFlags Tools

🌐 Luau Globals Tools

☁️ Open Cloud API Tools

📚 Luau Language Tools

📊 DataType Tools

📖 Library Tools

📜 MCP Resources (v3.3.0+)

Resources provide direct URI-based access to documentation:

📝 MCP Prompts (v3.3.0+)

Prompts provide reusable workflow templates:

💻 Usage Examples

🔍 Search for APIs

User: How do I animate something smoothly?
AI: [uses roblox_search("tween animation")]
→ TweenService, TweenBase, Tween, EasingStyle...

📋 Get Class Info

User: Tell me about TweenService
AI: [uses roblox_get_class("TweenService")]
→ Complete class info with Create(), GetValue(), SmoothDamp() methods
   Category: Animation, Preferred Parent: game

⚠️ Check Deprecation

User: Is BodyPosition deprecated?
AI: [uses roblox_check_deprecated("BodyPosition")]
→ Yes, deprecated. Use AlignPosition (constraint-based) instead.

🚩 Search FastFlags

User: What flags control physics?
AI: [uses roblox_search_fflags("physics")]
→ FIntPhysicsMaxSteps, DFFlagPhysicsDebug, FFlagPhysicsOptimized...

☁️ Get Cloud API Endpoint

User: How do I publish a message to a topic?
AI: [uses roblox_search_cloud_api("publish message")]
→ POST /v1/universes/{universeId}/topics/{topic}
   Auth: API Key with messaging-service:publish scope

🌐 Get Luau Globals

User: What built-in functions does Luau have?
AI: [uses roblox_get_luau_globals()]
→ print, warn, error, typeof, select, pairs, ipairs, next...

📚 Luau Language Docs

User: How do type annotations work in Luau?
AI: [uses roblox_get_luau_topic("type-annotations")]
→ Complete guide on type syntax, generics, type inference...

🔍 Search DevForum

User: How do people optimize memory in Roblox?
AI: [uses roblox_search_devforum("memory optimization")]
→ Links to relevant community discussions (cached for 1 hour)

📊 Get DataType Info

User: How do I create a Vector3?
AI: [uses roblox_get_datatype("Vector3")]
→ Vector3.new(x, y, z), Vector3.one, Vector3.zero
   Properties: X, Y, Z, Magnitude, Unit
   Methods: Cross, Dot, Lerp, Angle...

📖 Get Library Function

User: How does math.clamp work?
AI: [uses roblox_get_library_function("math", "clamp")]
→ math.clamp(x, min, max): number
   Returns x clamped between min and max

📊 Data Sources

All data is fetched from free, public sources:

📈 Data Stats

🌍 Supported Languages

Switch documentation language with roblox_sync(language="id-id"):

• en-us - English (default)
• id-id - Indonesian
• ja-jp - Japanese
• ko-kr - Korean
• zh-cn - Chinese (Simplified)
• zh-tw - Chinese (Traditional)
• de-de - German
• es-es - Spanish
• fr-fr - French
• it-it - Italian
• pt-br - Portuguese (Brazil)
• ru-ru - Russian
• th-th - Thai
• tr-tr - Turkish
• vi-vn - Vietnamese

🗄️ Cache Location

Data is cached in your system's standard cache directory:

• Windows: %LOCALAPPDATA%\mcp-roblox-docs\
• macOS: ~/Library/Caches/mcp-roblox-docs/
• Linux: ~/.cache/mcp-roblox-docs/

Cache is automatically updated when Roblox releases new API versions.

💻 Development

# Clone the repository
git clone https://github.com/nhattamgithub/mcp-roblox-docs
cd mcp-roblox-docs

# Install dependencies
uv sync

# Run the server locally
uv run mcp-roblox-docs

# Test tool count
uv run python -c "from src.server import mcp; print('Tools:', len(mcp._tool_manager._tools))"

# Build for distribution
uv build

# Publish to PyPI
uv publish

📝 Changelog

v3.3.0 (2026-01-25)

Full MCP Primitives Implementation

• Added MCP Resources (5 resource templates):
  • roblox://class/{name} - Direct access to class documentation
  • roblox://enum/{name} - Direct access to enum values
  • roblox://datatype/{name} - Direct access to datatype docs
  • roblox://library/{name} - Direct access to library docs
  • roblox://luau/{topic} - Direct access to Luau language docs
• Added MCP Prompts (4 workflow templates):
  • explain-api - Explain a Roblox API class in detail
  • debug-deprecation - Help migrate from deprecated APIs
  • code-review - Review Roblox Luau code
  • learn-service - Learn about a Roblox service
• Added 2 - minute timeout for sync operations
• Now implements all 3 MCP primitives: Tools, Resources, and Prompts

v3.2.0 (2026-01-25)

MCP Best Practices & Quality Improvements

• Added roblox_health tool for server status, stats, and diagnostics
• Wired up input validation in all 17 tools that accept user input
• Added configurable logging via MCP_ROBLOX_DOCS_LOG_LEVEL env var
• Added py.typed marker file for PEP 561 compliance
• Improved DevForum disk cache to clean up expired entries on save
• Fixed duplicate regex patterns in loader
• Updated USER_AGENT to match current version
• Now 27 tools total

v3.1.0 (2026-01-25)

Developer Experience & Search Improvements

• Fuzzy search with typo tolerance (e.g., "Tweenservce" → "TweenService")
• Persistent DevForum cache (survives server restarts)
• Added fuzzy parameter to roblox_search tool (default: True)
• Fixed TypedDict type hints in formatter for better type safety
• Added pytest test suite (56 tests for validation, search, cache)
• Added dev dependencies: pytest, pytest-asyncio

v3.0.1 (2026-01-25)

• Fixed changelog year (2025 -> 2026)

v3.0.0 (2026-01-25)

Performance & Reliability Release

• Parallel downloads with semaphore (7 - 10x faster sync)
• Retry logic with exponential backoff (3 attempts)
• HTTP compression support (gzip, deflate)
• Pre-compiled regex patterns (faster parsing)
• DataTypes/Libraries now searchable via roblox_search
• DevForum rate limiting (prevents 429 errors)
• Input validation module for security

v2.1.0 (2026-01-25)

• Added DataTypes documentation (44 types: Vector3, CFrame, Color3, UDim2, TweenInfo, etc.)
• Added Luau Libraries documentation (11 libraries: math, string, table, task, etc.)
• Added 5 new tools: roblox_get_datatype, roblox_list_datatypes, roblox_get_library, roblox_get_library_function, roblox_list_libraries
• Expanded from 21 to 26 tools

v2.0.0 (2026-01-25)

• Added FastFlags support (14,000+ flags from FVariables.txt)
• Added Luau globals (87 built-in functions/types)
• Added Open Cloud REST API (865 endpoints from openapi.json)
• Added Luau language documentation (20 topics)
• Added class metadata (categories, icons, preferred parents)
• Added DevForum caching (1 hour TTL)
• Enhanced deprecation alternatives (40+ class, 30+ member mappings)
• Expanded from 11 to 21 tools

v1.0.1

• Initial stable release
• Core API documentation tools
• DevForum search integration
• Multi-language support

📄 License

MIT License - see LICENSE for details.

👏 Credits

• Roblox-Client-Tracker by MaximumADHD
• Roblox Creator Docs by Roblox
• MCP Protocol by Anthropic