• Blog
  • Docs
  • Pricing
  • We’re hiring!
Log inSign up
dcm31

dcm31

mcp-mythic

Mythic GME MCP - Fate Chart roller and Chaos Factor tracker
Public
Like
mcp-mythic
Home
Code
4
README.md
H
main.ts
setup-meaning-tables.ts
test.ts
Branches
1
Pull requests
Remixes
History
Environment variables
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
Code
/
Search
README.md

Mythic GME MCP Server

A Mythic Game Master Emulator 2nd Edition implementation for solo/GM-less RPGs, exposed as an MCP server.

Multi-tenant: Supply a game_id to namespace your game's state. Each game has its own Chaos Factor, Characters list, Threads list, and Scene history.

Getting Started

Call mythic_instructions for a comprehensive guide on how to run a Mythic adventure using these tools!

Tools

πŸš€ Instructions

ToolDescription
mythic_instructionsFull guide on how to run a Mythic GME solo RPG adventure

🎬 Scene Management

ToolDescription
sceneManage your adventure's scenes
β”” startBegin a new scene with a description (captures current chaos)
β”” noteAdd notes about what happened in the scene
β”” endComplete scene with outcome (in_control or out_of_control) - adjusts chaos
β”” currentView the active scene
β”” listView all scenes
β”” historyView recent scenes with full details

🎲 Core Oracle

ToolDescription
check_sceneRoll d10 vs Chaos Factor: Normal, Altered (with twist), or Interrupted (different scene). Auto-rolls Event Focus on Interrupt.
roll_fateAsk the oracle a yes/no question. Returns Yes/No (possibly Exceptional). Auto-rolls Event Focus on Random Event (doubles).
event_focusRoll Event Focus table + Meaning Table. Auto-rolls Characters/Threads list when relevant.

πŸ“Š Chaos Factor

ToolDescription
get_chaosGet current Chaos Factor (1-9)
set_chaosSet Chaos Factor to a specific value
adjust_chaosIncrement or decrement Chaos Factor by 1

πŸ“‹ Lists

ToolDescription
charactersManage NPCs: add, remove, list, roll. Add same name up to 3x for weighting.
threadsManage plot threads: add, remove, list, roll. Add same name up to 3x for weighting.

πŸ“– Meaning Tables

ToolDescription
meaningRoll on any of 48 Meaning Tables for random inspiration
meaning_tablesList all available Meaning Tables

The Adventure Loop

1. scene start "description"    β†’ Begin a new scene
2. check_scene                  β†’ See if it plays as expected
3. [Play the scene]             
   - roll_fate for questions
   - scene note "what happened"
4. scene end "in_control"       β†’ If PC achieved goals (chaos ↓)
   scene end "out_of_control"   β†’ If things went sideways (chaos ↑)
5. Repeat!

Event Focus + Meaning Tables

When Event Focus is rolled (via event_focus, scene Interrupt, or Fate Random Event), it automatically:

  1. Rolls the Event Focus table to determine what type of event occurs
  2. Rolls on Characters/Threads list if the focus involves NPCs or plot threads
  3. Rolls on a Meaning Table for two-word inspiration:
    • New NPC β†’ Descriptions table (adjectives)
    • All other focuses β†’ Actions table (verb + noun)

Event Focus Table

RollFocusAuto-rolls
1-5Remote EventActions
6-10Ambiguous EventActions
11-20New NPCDescriptions
21-40NPC ActionCharacters + Actions
41-45NPC NegativeCharacters + Actions
46-50NPC PositiveCharacters + Actions
51-55Move Toward ThreadThreads + Actions
56-65Move Away From ThreadThreads + Actions
66-70Close ThreadThreads + Actions
71-80PC NegativeActions
81-85PC PositiveActions
86-100Current ContextActions

Example Output

Scene start and check:

🎬 Scene 1 Started

**Entering the abandoned temple to find the artifact**

Chaos Factor: 5

---

βœ… **Scene Normal**
Roll: 7 vs Chaos 5

Scene proceeds as expected.

Scene end with chaos adjustment:

βœ… **Scene 1 Completed**

Outcome: In Control (PC achieved goals)
Chaos decreased: 5 β†’ 4

Ready for the next scene! Use `scene start` to begin.

Meaning Tables

The meaning tool lets you roll on 48 thematic tables:

  • Core: actions, descriptions
  • Character: character_actions_general, character_actions_combat, character_appearance, character_background, character_conversations, character_descriptors, character_identity, character_motivations, character_personality, character_skills, character_traits_flaws, characters
  • Location: locations, city_descriptors, cavern_descriptors, domicile_descriptors, dungeon_descriptors, forest_descriptors, terrain_descriptors
  • Creatures: creature_abilities, creature_descriptors, animal_actions, alien_species_descriptors, undead_descriptors
  • Story: plot_twists, adventure_tone, cryptic_message, legends, visions_dreams
  • Fantasy: gods, curses, magic_item_descriptors, powers, spell_effects, noble_house
  • Objects: objects, scavenging_results, dungeon_traps
  • Senses: smells, sounds
  • Sci-Fi: starship_descriptors, mutation_descriptors, army_descriptors, civilization_descriptors
  • Misc: names

MCP Endpoint

POST https://dcm31-mcp-mythic.web.val.run

Configure your MCP client to connect to this endpoint. All tools except mythic_instructions, meaning, and meaning_tables require a game_id parameter.

Code
README.md
H
main.ts
setup-meaning-tables.tstest.ts
FeaturesVersion controlCode intelligenceCLIMCP
Use cases
TeamsAI agentsSlackGTM
DocsShowcaseTemplatesNewestTrendingAPI examplesNPM packages
PricingNewsletterBlogAboutCareers
We’re hiring!
Brandhi@val.townStatus
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Open Source Pledge
Terms of usePrivacy policyAbuse contact
Β© 2026 Val Town, Inc.