MCP App Store
by KeenEthics
American Mahjong Hand Helper icon

American Mahjong Hand Helper MCP Server for ChatGPT

By The Open Apps, Inc.

Overview

Jokerly is a helper for American mahjong, for the moments at the table when the counting gets hard. Share your rack, as a photo or typed, and Jokerly counts how many tiles away you are from every hand on your card. Each hand shows the tiles it still needs and where a joker can stand in, so you can see at a glance which hands are alive. In the Charleston, Jokerly tries every set of three tiles in your rack and suggests the pass that keeps you closest to your nearest hands. It never passes a joker, and on the last pass of a Charleston it tells you when a blind pass would save a tile you need. In the card you can mark the pass as done, add the tiles you got back and see the next pass. Wondering whether you can take that joker? Jokerly checks the swap against the standard rules: the joker must be in an exposure, it must be your turn, and your tile must be the one the joker stands for. With your rack, it also says whether the swap brings you closer to a hand. Bring your own card. Jokerly includes no league's card. Type or photograph the hands on the card your table plays, and Jokerly saves them for you alone; they are never shared or combined with anyone else's. Until you do, Jokerly uses its own practice hands so you can try it. The answers come from a rules engine: jokers count only in groups of three or more, every suit and number a hand allows is tried, exposures must match a hand, and concealed hands drop out once you have exposed. Limits: - American mahjong only, with 14-tile hands written in Jokerly's simple notation (each card line once). - ChatGPT reads your photos; Jokerly lists every tile it received, and you can tap a tile in the card to fix a misread one. - Standard rules; your table may play house rules. - Jokerly keeps no score and handles no money. - Not affiliated with any mahjong league or card publisher. - Say "Delete my Jokerly card" to delete your saved hands at any time.

How to connect

  1. ChatGPT: Open the American Mahjong Hand Helper listing in the ChatGPT app directory and choose Connect. ChatGPT listing American Mahjong Hand Helper exposes 6 tools here.

Tools

check_joker_swap

ChatGPT
Use this when the user asks whether they may swap (exchange, redeem) a tile for a joker, or take a joker from their own or someone else's exposure. Checks the standard American mahjong rules: the joker must be in an exposure on the table, it must be the user's turn after drawing or calling, and the tile offered must be the natural tile the joker stands for. With the user's rack, it also says whether the swap brings them closer to a hand. Read-only.

check_rack

ChatGPT
Use this when the user shows or lists their American mahjong (mah jongg, 'mahj') rack, as a photo or typed tiles, and asks how close they are, how many tiles away each hand is, which line on their card to go for, or what they still need. Counts how many tiles away the rack is from every hand on the user's card (or the hands they picked), with jokers allowed only in groups of three or more, and returns the closest hands with the tiles each still needs. A rack photo is read into tile codes before the call; the result lists the tiles as read, so the user can catch a misread. Read-only.

remove_card_hands

ChatGPT
Use this when the user asks to remove hands from their saved card (by #), or to delete their whole saved card (all: true), which is everything Jokerly keeps about them. Removed hands can't be restored; the user would have to save them again. Removing a hand that is already gone changes nothing.

save_card_hands

ChatGPT
Use this when the user types or photographs the hands (lines) on THEIR OWN mahjong card, the card their table plays this year, and wants Jokerly to check against them. Adds the hands to this user's private card (not shared or pooled with other users), exactly as the user's card or message shows them; Jokerly has no copy of any published card. Jokerly notation: the card line's groups separated by spaces, 14 tiles in all. Symbols: 1-9 numbers, F flower, N E W S winds, D dragon, R red dragon, G green dragon, 0 Soap (the white dragon used as zero). After each group of numbers or D comes a suit tag a, b or c: the same letter means the same suit and different letters mean different suits (on a printed card each color is one tag). D with a tag is the dragon that goes with that suit. A token of different symbols is a run of singles, like 2026a or NEWS. A hand with no tags at all uses one suit. Examples: 'FF 2222a 4444b 6666c', '11a 222a 3333a 444a 55a', 'NNNN EEE WWW SSSS'. Hands already saved are skipped, so repeating a call adds nothing twice. Lines that don't parse come back with the problem, and the rest are saved.

show_card_hands

ChatGPT
Use this when the user wants to see the hands Jokerly will check against: the hands they saved from their own card (hand_source 'mine', the default), or Jokerly's practice hands (hand_source 'practice'), with each hand's for picking or removing hands. Read-only.

suggest_charleston_pass

ChatGPT
Use this when the user asks what to pass, which three tiles to give away, whether to blind pass, or what to keep in the American mahjong (mah jongg) Charleston (right, across or left, first or second Charleston, or the courtesy pass). Tries every set of three tiles from the rack and returns the one that keeps the rack closest to the user's hands (jokers stay in the rack), with why each tile goes and, on the last pass of a Charleston, whether a blind pass would save a useful tile. Read-only.

Capabilities

InteractiveWrites

Example Prompts

Click any prompt to copy it.

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/jokerly-american-mahjong"><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/jokerly-american-mahjong)