2d6mcp

communication MCP Server

AI GM Assistant — system-agnostic 2d6 TTRPG rules engine, dice roller, Discord bot, and MCP server

VerifiedInstall Ready
communicationcommunication
4 views1 stars0 forksv0.7.0NOASSERTION

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 3mo ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
1
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npm install 2d6mcp
66
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (66)

roll_2d6

Roll 2d6 with modifier, compare against target, return effect margin

query_local_byod

Search your locally ingested BYOD files (requires consent)

query_ogl_rules

Search the OGL database for rules, skills, careers, equipment, or tables

OGL_DB_PATH

`data/ogl/cepheus.db`

roll_table

Roll on a named table from any rules system (use `system` param)

BYOD_PATH

—

Tool

Description

sync_byod

Index/re-index all files in your BYOD directory

roll_custom

Roll any dice notation (`3d6`, `1d20`, `4d6+2`)

AGREE_BYOD_USE

`"false"`

parse_character

Parse a character sheet file into structured JSON

Variable

Set via

query_5ecompatible_rules

Search the 5E-compatible database for spells, monsters, classes, feats, and rules

get_byod_chunk

Retrieve full chunk content by file path + chunk index

search_transcript

Full-text search across session transcripts

discord_test_webhook

Send a test message to verify webhook connectivity

BYOD_SYNC_TIMEOUT_MS

`15000`

SESSION_DB_PATH

`~/.2d6mcp/sessions.db`

API_URL

`wrangler.toml`

list_byod_files

List all indexed files with chunk counts and status

session_summarize

Generate an AI summary for a session via MLX LLM

discord_add_webhook

Add a Discord webhook with name, URL, tags

BYOD_CHUNK_OVERLAP

`400`

ORCUS_DB_PATH

`data/orcus/orcus.db`

DISCORD_CLIENT_ID

`wrangler secret put`

clear_byod

Delete the BYOD index to start fresh

session_list

List all recorded game sessions

discord_post

Post messages to Discord webhooks with smart routing

BYOD_CHUNK_SIZE

`8000`

SR5E_DB_PATH

`data/5ecompatible/5ecompatible-srd.db`

DISCORD_PUBLIC_KEY

`wrangler secret put`

roll_d20

Roll d20 with modifier, advantage/disadvantage, AC/DC comparison, critical hits and fumbles

query_orcus_rules

Search the Orcus 4e-compatible database for classes, monsters, feats, and rules

synthesize_ruling

Synthesize a rules ruling using local MLX LLM with OGL/DW/BRP/5E-compatible/BYOD citations

transcribe_audio

Transcribe an audio file using local MLX Whisper

Command

Description

BYOD_CONTENT_CACHE_PATH

`data/byod/content_cache.db`

STT_BACKEND

`mlx`

WEB_URL

`wrangler.toml`

query_brp_rules

Search the Basic Roleplaying database for characteristics, skills, professions, weapons, armor, spot rules

sync_file

Index a single file by relative path

get_session_context

Get recent transcript segments and rulings

discord_list_webhooks

List all configured webhooks

BYOD_MAX_CHUNKS_PER_FILE

`500`

MLX_LLM_MODEL

`mlx-community/Llama-3.2-3B-Instruct-4bit`

JWT_SECRET

`wrangler secret put`

session_end

End the active game session

delete_session

Permanently delete a session and all its data

BRP_DB_PATH

`data/brp/basic-roleplaying.db`

DISCORD_BOT_TOKEN

`wrangler secret put`

roll_damage

Roll damage dice with optional type (`"2d6+3 fire"`, `"1d8 piercing"`)

session_start

Start a new game session for transcript logging and rulings tracking

clear_transcription

Reset transcription progress

DW_DB_PATH

`data/dw/dungeon-world.db`

roll_percentile

Roll d100 with BRP-style roll-under, critical success, and fumble detection

resolve_from_context

Take recent session transcript, detect rules question, synthesize ruling

list_transcriptions

List in-progress audio transcriptions

LLM_BACKEND

`mlx`

Mode

Description

query_dw_rules

Search the Dungeon World database for moves, classes, spells, equipment, monsters, GM tools

inspect_byod_file

Show chunk structure for a specific indexed file

log_transcript

Log a transcript segment to the current session

discord_remove_webhook

Remove a stored Discord webhook by name

BYOD_MAX_FILES

`2000`

MLX_WHISPER_MODEL

`mlx-community/whisper-large-v3-turbo`

DISCORD_CLIENT_SECRET

`wrangler secret put`