RoDocsMCP

Typed scraper and MCP server for the Roblox Creator Hub API Reference and Guides.

Provides MCP-compatible AI assistants with structured access to Roblox API + Creator Hub guides.

MCP Setup

{
  "mcpServers": {
    "rodocs": {
      "command": "npx",
      "args": ["-y", "rodocsmcp", "--stdio"]
    }
  }
}

MCP Tools

| Tool | Description | | ------------------------- | ------------------------ | | get_api_reference | Fetch API entry | | get_many_api_references | Batch fetch (max 20) | | list_api_names | List classes/enums | | find_api_name | Resolve closest API name | | search_guides | Search Creator Guides | | get_guide | Fetch guide content | | list_guides | List available guides |

CLI

Usage

npx rodocsmcp TweenService
npx rodocsmcp --list
npx rodocsmcp --find tweenserv
npx rodocsmcp --search-guide "data store"
npx rodocsmcp --guide docs/scripting/data-stores.md
npx rodocsmcp --stdio

Commands

| Command | Description | | ------------------------ | ---------------- | | <topic> | Show API docs | | --list | List API names | | --find <query> | Resolve API name | | --search-guide <query> | Search guides | | --guide <path> | Fetch guide | | --stdio | Start MCP server |

Programmatic API

import {
  scrapeTopic,
  scrapeMany,
  scrapeIndex,
  findClosestApiName,
} from "rodocsmcp";

await scrapeTopic("Actor");
await scrapeMany(["Vector3", "CFrame"]);
await scrapeIndex();
await findClosestApiName("tweenserv");

Build from Source

Requirements: Node.js >= 20.10.0, pnpm >= 10

git clone https://github.com/iamthebestts/RoDocs-MCP
cd RoDocs-MCP
pnpm install

Development

pnpm dev

Build

pnpm build

Run built CLI

node dist/cli.js TweenService
node dist/cli.js --stdio

Quality

pnpm typecheck
pnpm check
pnpm test

How it works

• API Reference: Extracted from __NEXT_DATA__ on Creator Hub (no DOM scraping)
• Guides: Fetched and indexed from Creator Hub docs
• Search: BM25 ranking with alias normalization
• Cache: In-memory TTL (10 min)

Contributing

See CONTRIBUTING.md.

License

MIT