Skip to content
MCP server

Shelem Scorekeeping

Score hands of the Persian card game Shelem with exact integer arithmetic

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About Shelem Scorekeeping

Shelem Scorekeeping is a free MCP server for games and play. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add shelem-scorekeeping -- uvx shelem-scorekeeping-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shelem-scorekeeping": {
      "command": "uvx",
      "args": [
        "shelem-scorekeeping-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shelem-scorekeeping": {
      "command": "uvx",
      "args": [
        "shelem-scorekeeping-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Free

Free package on PyPI

Shelem Scorekeeping 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.

How AIPoweredBot checks servers