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.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Codelf

unbug

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

14.2K

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K