MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine
RemoteAbout MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine
MahjongHandbook is a read-only MCP server for scoring rules and play procedures across American NMJL, Chinese MCR, Japanese Riichi, and Hong Kong Mahjong. It is for players and developers checking regional rules, tile legality, or win conditions.
Key features
- 01Compare regional scoring-rule structures
- 02Retrieve American Charleston passing steps
- 03Check NMJL Joker meld legality
- 04Evaluate Riichi Furiten and Yaku conditions
Use cases
- 01Compare tile counts and scoring thresholds
- 02Review tile passing before an American Mahjong game
- 03Check whether a Joker substitution is legal
- 04Verify Furiten restrictions and the 1-Yaku win condition
MCP support
It provides four read-only tools to MCP clients through a remote streamable HTTP endpoint. No API key is required.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mahjonghandbook.com/api/mcpclaude mcp add --transport http com-mahjonghandbook https://mahjonghandbook.com/api/mcp{"mcpServers":{"com-mahjonghandbook":{"type":"http","url":"https://mahjonghandbook.com/api/mcp"}}}Open in Cursor{"servers":{"com-mahjonghandbook":{"type":"http","url":"https://mahjonghandbook.com/api/mcp"}}}Open in VS Code{"mcpServers":{"com-mahjonghandbook":{"type":"http","url":"https://mahjonghandbook.com/api/mcp"}}}{"mcpServers":{"com-mahjonghandbook":{"serverUrl":"https://mahjonghandbook.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEMahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine
Query American NMJL, Chinese Official MCR (81 Fan) & Japanese Riichi Mahjong scoring rules.
- Official Workbench: https://mahjonghandbook.com
- Remote MCP Endpoint:
https://mahjonghandbook.com/api/mcp(streamable-http, read-only, no API key required) - Public OpenAPI 3.0: https://mahjonghandbook.com/openapi.json
- LLM Context: https://mahjonghandbook.com/llms.txt · https://mahjonghandbook.com/llms-full.txt
Tools Provided (4 Read-Only Tools)
| Tool Name | Summary |
|---|---|
lookup_mahjong_scoring_rules | Compare high-level regional ruleset structures (tile deck size 136 vs 144 vs 152, hand length, and minimum Fan/point entry thresholds) across American, Chinese MCR, Japanese Riichi, and Hong Kong Mahjong. Do not use for Charleston passing steps, NMJL Joker meld legality, or Riichi Furiten checks. |
lookup_american_charleston_sequence | Retrieve exact pre-game tile passing directions (Right, Across, Left), blind pass rules, and Courtesy Pass negotiation steps prior to the first discard in American Mahjong. |
check_nmjl_joker_legality | Validate whether an American Mahjong Joker tile can legally substitute inside a specific meld size (1 to 6 tiles) and retrieve exposed Joker live-turn swap rules. |
check_riichi_furiten_and_yaku | Evaluate Japanese Riichi Mahjong discard/temporary Furiten Ron restrictions and verify whether a hand satisfies the mandatory 1-Yaku win condition independent of Dora. |
Connect in 10 Seconds
Claude Code
claude mcp add --transport http mahjonghandbook https://mahjonghandbook.com/api/mcp
Cursor / Claude Desktop / Windsurf (mcp.json)
{
"mcpServers": {
"mahjonghandbook": {
"type": "streamable-http",
"url": "https://mahjonghandbook.com/api/mcp"
}
}
}
Agent Skill (skills.sh)
npx -y skills@latest add AbigailDavised/mahjonghandbook-mcp -y
License
MIT © MahjongHandbook
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.