MCP App Store
by KeenEthics
Mahj Trainer icon

Mahj Trainer MCP Server for Claude and ChatGPT

By Jack Wallner

Overview

Mahj Trainer teaches American mah jongg, the game played with the yearly National Mah Jongg League card. Ask for a lesson and get a short interactive card deck on the basics, the tiles, the sections of the card, the Charleston or keep-or-throw judgment, with the tiles drawn on every card. Ask for practice and get a quiz that checks and explains each answer, including Charleston passes you pick by tapping tiles. Share the tiles on your rack and get a coach's read of the sections you lean toward, the three tiles to pass with a reason for each, and what to build on. Name the pass you are making, such as the first pass left or the courtesy pass, and the advice fits it. Ask what a term means, from pung and quint to joker swap and dead hand. Mahj Trainer talks in the card's stable sections and never reproduces card hands, so keep your own card handy for the exact lines. It needs no account, and every tool is read-only. Not affiliated with or endorsed by the National Mah Jongg League.

How to connect

  1. Claude: Open the Mahj Trainer listing in the Claude connectors directory and choose Connect. Claude listing Mahj Trainer exposes 5 tools here.
  2. ChatGPT: Open the Mahj Trainer listing in the ChatGPT app directory and choose Connect. ChatGPT listing Mahj Trainer exposes 5 tools here.

Tools

check_mahjong_answer

ChatGPT
Use this to check the player's typed answer to a question from start_mahjong_practice when the interactive quiz is not visible. Pass the question's id and the player's answer: the choice text, or the three tiles they would pass. Returns whether it is right, the right answer and the explanation.

define_mahjong_term

ChatGPT
Use this when someone asks what an American mah jongg term means, such as pung, kong, quint, soap, exposure, joker swap, hot tile, dead hand, the blind pass or the courtesy pass. Returns the plain-language definition from the Mahj glossary of 36 terms, written to NMJL rules, or says the term is not in it. It covers terms, not full rules such as scoring. Do not use for other mahjong variants.

read_mahjong_rack

ChatGPT
Use this when an American mah jongg player shares the tiles on their rack and asks which section of the card they lean toward or what to pass in the Charleston. Reads the tiles against the stable card sections, shortlists the strongest, and picks a three-tile pass with a reason for each tile. Shows the read in an interactive rack card. Needs at least five tiles; the full 13-tile rack works best. If any entry can't be read it asks for a correction instead of guessing. It never names specific card hands. Do not use for other mahjong variants.

show_mahjong_lesson

ChatGPT
Use this when someone wants to learn or review American mah jongg (NMJL-card style): how the game works, the tiles, the sections of the card, the Charleston, or keep-or-throw judgment. Shows a short card deck with tile pictures, and cards that ask a question let the player answer first. The deck is the lesson, so don't write a second guide in chat. Do not use to list or reproduce the hands on the NMJL card, or for other mahjong variants.

start_mahjong_practice

ChatGPT
Use this when someone wants to practice or be quizzed on American mah jongg: naming tiles, reading which card section a rack is chasing, choosing a Charleston pass, keep-or-throw calls, or table rules. Shows an interactive quiz that checks each answer and explains it. The result holds the questions but not the answers.

check_mahjong_answer

Claude
Use this to check the player's typed answer to a question from start_mahjong_practice when the interactive quiz is not visible. Pass the question's id and the player's answer: the choice text, or the three tiles they would pass. Returns whether it is right, the right answer and the explanation.

define_mahjong_term

Claude
Use this when someone asks what an American mah jongg term means, such as pung, kong, quint, soap, exposure, joker swap, hot tile, dead hand, the blind pass or the courtesy pass. Returns the plain-language definition from the Mahj glossary of 36 terms, written to NMJL rules, or says the term is not in it. It covers terms, not full rules such as scoring. Do not use for other mahjong variants.

read_mahjong_rack

Claude
Use this when an American mah jongg player shares the tiles on their rack and asks which section of the card they lean toward or what to pass in the Charleston. Reads the tiles against the stable card sections, shortlists the strongest, and picks a three-tile pass with a reason for each tile. Shows the read in an interactive rack card. Needs at least five tiles; the full 13-tile rack works best. If any entry can't be read it asks for a correction instead of guessing. It never names specific card hands. Do not use for other mahjong variants.

show_mahjong_lesson

Claude
Use this when someone wants to learn or review American mah jongg (NMJL-card style): how the game works, the tiles, the sections of the card, the Charleston, or keep-or-throw judgment. Shows a short card deck with tile pictures, and cards that ask a question let the player answer first. Do not use to list or reproduce the hands on the NMJL card, or for other mahjong variants.

start_mahjong_practice

Claude
Use this when someone wants to practice or be quizzed on American mah jongg: naming tiles, reading which card section a rack is chasing, choosing a Charleston pass, keep-or-throw calls, or table rules. Shows an interactive quiz that checks each answer and explains it. The result holds the questions but not the answers.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/mahj-trainer"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/mahj-trainer)