MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine
Answer Mahjong rules questions across American NMJL, Chinese MCR and Japanese Riichi
- Pricing
- Free
- Platforms
- API
- Runs
- Remotely
- Version
- 1.0.2
- Listing updated
- 5 days ago
Similar MCP servers
About MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine
MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine is a free MCP server for games and play. It runs as a hosted remote server, so there is nothing to install locally.
Rather than a general rules dump, the four tools each answer a narrow question and say what they should not be used for. The comparison tool contrasts tile deck sizes of 136, 144 and 152, hand length and minimum fan or point thresholds across American, Chinese MCR, Japanese Riichi and Hong Kong play, and warns against using it for Charleston steps, Joker legality or furiten.
The Charleston tool returns the passing directions of right, across and left, blind pass rules and the courtesy pass negotiation. The Joker tool checks whether a Joker can stand in a meld of one to six tiles and covers exposed Joker swaps on a live turn. The Riichi tool evaluates temporary and discard furiten restrictions and whether a hand has the required yaku independent of dora.
The endpoint is read-only with no key, and the README also lists an OpenAPI file and llms.txt files.
Install
Run in a terminal
claude mcp add --transport http mcp https://mahjonghandbook.com/api/mcpAdd to Settings → Connectors → Add custom connector
https://mahjonghandbook.com/api/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mahjonghandbook.com/api/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mahjonghandbook.com/api/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"serverUrl": "https://mahjonghandbook.com/api/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://mahjonghandbook.com/api/mcpEnter a Name (for example "MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"type": "http",
"url": "https://mahjonghandbook.com/api/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- lookup_mahjong_scoring_rules
- Compares ruleset structures across regional Mahjong variants
- lookup_american_charleston_sequence
- Returns Charleston passing directions and courtesy pass steps
- check_nmjl_joker_legality
- Checks whether a Joker can substitute in a meld
- check_riichi_furiten_and_yaku
- Evaluates furiten restrictions and the yaku requirement
What it does
- Regional rule comparison
- Deck size, hand length and entry thresholds across four rulesets.
- Charleston sequence
- Passing directions, blind pass and courtesy pass steps.
- Joker legality
- Checks Joker substitution in melds of one to six tiles.
- Riichi checks
- Furiten restrictions and the one-yaku requirement.
- Scope guidance
- Each tool states what it should not be used for.
Good for
- Settle a Charleston dispute at the table
- Check if a Joker can complete an exposed meld
- Verify a Riichi hand is not furiten
- Compare American and MCR scoring thresholds
Pricing
Free
Free public endpoint
Prices change. Check mahjonghandbook.com before you buy.
MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine FAQ
Which variants are covered?
American NMJL, Chinese Official MCR with 81 fan, Japanese Riichi and Hong Kong.
Is it read-only?
Yes, with four read-only tools and no API key.
Does the comparison tool cover furiten?
No. The README says to use the Riichi tool for that.
Is there an OpenAPI spec?
Yes, at mahjonghandbook.com/openapi.json.
Is MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine free?
Yes. MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine is free to use.
How do I add MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp https://mahjonghandbook.com/api/mcp
What are the best alternatives to MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine?
The closest alternatives to MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine are Shelem Scorekeeping, 符文戰場新手指南, 27-0 MCP, DolfDarts Dart Game Encyclopedia and Lumichess.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

