Random Tables MCP Server

What is Random Tables MCP Server?

An MCP (Model Context Protocol) server for managing and rolling on random‑table assets used in tabletop RPGs. It follows a hexagonal architecture (ports & adapters) and lets you create, update, and roll on tables with template linking and weighted entries.

How to use Random Tables MCP Server?

Install manually by cloning the repository, running npm install and npm build, then point your MCP client (e.g., Claude Desktop) to dist/index.js over stdio. The server exposes tools (create_table, roll_on_table, update_table, list_tables, get_table) and resources (table://{tableId}, tables://). Toggle between the two access models by setting the CAN_USE_RESOURCE environment variable.

Key features of Random Tables MCP Server

• Create and update random tables with optional entries
• Roll on any table and get instant results
• Link tables together using a template system
• Define range‑based entries for dice‑driven tables
• Weight entries to fine‑tune probabilities
• Switch between MCP Resources or Tools access model

Use cases of Random Tables MCP Server

• Generate random encounters for tabletop RPGs
• Create dynamic treasure and item drops
• Build complex NPCs with personality traits and equipment
• Generate story prompts and plot hooks

FAQ from Random Tables MCP Server

What does the server do?

It provides a drop‑in random‑table engine for tabletop RPGs, allowing you to create, roll on, and chain tables together via templates, all through the Model Context Protocol.

How do I install Random Tables MCP Server?

Clone the repository, run npm install and npm run build, then configure your MCP client (e.g., Claude Desktop) to launch dist/index.js as a stdio server. The server is not yet published to npm.

Can I choose between MCP Resources and Tools?

Yes. Set the CAN_USE_RESOURCE environment variable to true to use Resources (table://), otherwise the server uses Tools (get_table). Default is false (Tools).

What are the system requirements?

Node.js v20 or higher and npm are required. The server runs locally via stdio.

Where is table data stored?

Data is stored in the directory specified by the DATA_DIR environment variable, defaulting to ./data.