Random Tables MCP Server

Name: Random Tables MCP Server
Author: MikeORed

@MikeORed

Repository

About Random Tables MCP Server

MCP server for generating dynamic random tables for tabletop RPGs with nested templates and weighted probabilities

#tabletop-gaming #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "random-tables": {
      "type": "stdio",
      "command": "node",
      "args": [
        "C:\\path\\to\\mcp-random-tables\\dist\\index.js"
      ],
      "env": {
        "CAN_USE_RESOURCE": "false"
      }
    }
  }
}

Tools

Create a new random table with optional initial entries

Roll on a specific table and returns the result

Update an existing table (name, description, entries)

List available tables with metadata

Get details of a specific table

Overview

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).