# 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. Answer Mahjong rules questions across American NMJL, Chinese MCR and Japanese Riichi. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://mahjonghandbook.com
- **Repository:** https://github.com/abigaildavised/mahjonghandbook-mcp
- **MCP Registry name:** com.mahjonghandbook/mcp
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mahjonghandbook.com/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mahjonghandbook.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mahjonghandbook.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mahjonghandbook.com/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mahjonghandbook.com/api/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mahjonghandbook.com/api/mcp"
    }
  }
}
```

## Tools

- `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

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

## Alternatives

- [Shelem Scorekeeping](https://ai-powered.com/mcp/shelem-scorekeeping): Shelem Scorekeeping is a free MCP server for games and play.
- [符文戰場新手指南](https://ai-powered.com/mcp/listing-30): 符文戰場新手指南 is a free MCP server for games and play.
- [27-0 MCP](https://ai-powered.com/mcp/27-0-mcp): 27-0 MCP is a free MCP server for games and play.
- [DolfDarts Dart Game Encyclopedia](https://ai-powered.com/mcp/dolfdarts-dart-game-encyclopedia): DolfDarts Dart Game Encyclopedia is a free MCP server for games and play.
- [Lumichess](https://ai-powered.com/mcp/lumichess): Lumichess is a free MCP server for games and play.
- [SnackTurn](https://ai-powered.com/mcp/snackturn): SnackTurn is a free MCP server for games and play.
- [Tailorgame public tools](https://ai-powered.com/mcp/tailorgame-public-tools): Tailorgame public tools is a free MCP server for games and play.

---
Source: https://ai-powered.com/mcp/mahjonghandbook-american-nmjl-mcr-and-riichi-mahjong-scoring
