Random Tables MCP Server

@MikeORed

Repository

Basic information

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

Random Tables MCP Server 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"
      }
    }
  }
}

Random Tables MCP Server 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

Frequently asked questions

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

Comments

More Other MCP servers

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K