Skip to content
MCP server

MahjongHandbook — American NMJL, MCR & Riichi Mahjong Scoring Rules Engine

Answer Mahjong rules questions across American NMJL, Chinese MCR and Japanese Riichi

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mahjonghandbook.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mahjonghandbook.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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/mcp

Enter 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.

Full Grok Bot setup guide

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.

How AIPoweredBot checks servers