# Shelem Scorekeeping

> Shelem Scorekeeping is a free MCP server for games and play. Score hands of the Persian card game Shelem with exact integer arithmetic. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/khaleghika/shelem-mcp
- **MCP Registry name:** io.github.khaleghika/shelem-scorekeeping
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

Keeping score in Shelem is fiddly: bids, Mak, sweeps, failed bids and a rule that changes how a defending team scores once it reaches 1000. This server lets an assistant read the bids and results from conversation while the tool does every score change, so the model never does arithmetic.

It runs locally over stdio, with no network access, database or stored state, and exposes a single tool with typed input and structured output. The engine uses only the Python standard library and no floating point. A hand that is missing a fact or contradicts itself returns an error naming the field rather than a guessed score. Each result includes new totals, the changes per team, whether the game has finished and a plain-English explanation.

The rules covered include normal bids of 100 to 165 in steps of 5, Mak, sweeps worth twice the bid, failed bids that cost the bid or double it when defenders take 85 or more, Shelem and sar-shelem at 330 points, the 1000-point rule and a win at 1165. The assistant keeps running totals, because the server is stateless.

## Features

- **Deterministic scoring:** Integer-only arithmetic means the same hand always gives the same result.
- **Strict validation:** Contradictory or incomplete hands return an error naming the field.
- **Readable explanations:** Every hand comes with a plain-English account of how points were scored.
- **Full rule coverage:** Mak, sweep, failed bids, Shelem, the 1000-point rule and the 1165 win.
- **Fully local:** Runs over stdio with no network access, database or state.
- **Persian rules docs:** The scoring rules are documented in English and Persian.

## Good for

- Score a hand during a family game night
- Check whether a team has reached 1165
- Re-score a game after correcting an earlier hand
- Learn how the 1000-point rule applies

## Install

### Claude Code (Terminal)

```sh
claude mcp add shelem-scorekeeping -- uvx shelem-scorekeeping-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shelem-scorekeeping": {
      "command": "uvx",
      "args": [
        "shelem-scorekeeping-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shelem-scorekeeping": {
      "command": "uvx",
      "args": [
        "shelem-scorekeeping-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "shelem-scorekeeping": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shelem-scorekeeping-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shelem-scorekeeping": {
      "command": "uvx",
      "args": [
        "shelem-scorekeeping-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shelem-scorekeeping": {
      "command": "uvx",
      "args": [
        "shelem-scorekeeping-mcp"
      ]
    }
  }
}
```

## Tools

- `calculate_shelem_score`: Scores one hand from the bid, outcome and previous team totals.

## FAQ

### How do I install it?

Run uvx shelem-scorekeeping-mcp, or pip install shelem-scorekeeping-mcp; Python 3.10 or newer is needed.

### Does it keep the running score?

No. The server is stateless and the assistant passes the totals before each hand.

### What is the tool called?

calculate_shelem_score.

### Can the score go negative?

Yes, totals are not capped and negatives are allowed.

### Is Shelem Scorekeeping free?

Yes. Shelem Scorekeeping is free to use.

### How do I add Shelem Scorekeeping to Claude Code?

Run this command in your terminal: claude mcp add shelem-scorekeeping -- uvx shelem-scorekeeping-mcp

### What are the best alternatives to Shelem Scorekeeping?

The closest alternatives to Shelem Scorekeeping are Digimon, Disney, Clash Royale, 82-0 Dream MCP and 27-0 MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Digimon](https://ai-powered.com/mcp/digimon): Digimon is a freemium MCP server for games and play.
- [Disney](https://ai-powered.com/mcp/disney): Disney is a freemium MCP server for games and play.
- [Clash Royale](https://ai-powered.com/mcp/clash-royale): Clash Royale is a freemium MCP server for games and play.
- [82-0 Dream MCP](https://ai-powered.com/mcp/82-0-dream-mcp): 82-0 Dream MCP is a free MCP server for games and play.
- [27-0 MCP](https://ai-powered.com/mcp/27-0-mcp-2): 27-0 MCP is a free MCP server for games and play.
- [Wynncraft](https://ai-powered.com/mcp/wynncraft): Wynncraft is a freemium MCP server for games and play.
- [Gamechalk Score Keeper](https://ai-powered.com/mcp/gamechalk-score-keeper): Gamechalk Score Keeper is an MCP server for games and play.
- [OSRS Calc MCP](https://ai-powered.com/mcp/osrs-calc-mcp): OSRS Calc MCP is an open-source MCP server for games and play.

---
Source: https://ai-powered.com/mcp/shelem-scorekeeping
