API & MCP

Everything a person can do on Skat Game Value Calculator, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://playcardsskatgamevalue.usefulweb.site/api/v1/calculate – run Skat Game Value Calculator
GET https://playcardsskatgamevalue.usefulweb.site/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Skat Game Value Calculator

Works out the value of a Skat game by the International Skat Order: base value of the suit or Grand times the multiplier (matadors with or without, game, Hand, Schneider, announced, Schwarz, announced, Ouvert), or the fixed Null values 23/35/46/59. Enter your bid to see whether the game covers it, the highest bid it covers and — with the declarer’s card points — whether the game is won and what it scores. The Playcards app uses the same engine for its score sheet.

Inputs of Skat Game Value Calculator
Field	Type	Default	Description
`game`	select (D, H, S, C, grand, null)	"C"	Game
`matadorsWith`	select (with, without)	"with"	Matadors
`matadors`	integer	2	Number of matadors. Consecutive top trumps you hold (with) or miss (without), counting the Skat. Grand: at most 4.
`hand`	boolean	false	Hand game (Skat not picked up)
`schneider`	boolean	false	Schneider reached (90+ or 30 or less)
`schneiderAnnounced`	boolean	false	Schneider announced (Hand only)
`schwarz`	boolean	false	Schwarz reached (one side took every trick)
`schwarzAnnounced`	boolean	false	Schwarz announced (Hand only)
`ouvert`	boolean	false	Ouvert (cards open)
`bid`	integer	0	Your bid. 0 = no bid check. Bids are game values from 18 upwards.
`declarerPoints`	text	—	Declarer’s card points incl. Skat (optional). With points the tool says whether the game is won and what it scores.
`scoring`	select (isko, seeger)	"isko"	Score sheet

Example request

Clubs with 2, Hand — bid 48

curl -X POST https://playcardsskatgamevalue.usefulweb.site/api/v1/calculate -H 'content-type: application/json' -d '{"game":"C","matadorsWith":"with","matadors":2,"hand":true,"bid":48}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://playcardsskatgamevalue.usefulweb.site/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: playcards_skat_game_value
Local stdio connector: node src/mcp-stdio.ts --tool=playcards-skat-game-value

{
  "mcpServers": {
    "playcards-skat-game-value": { "type": "http", "url": "https://playcardsskatgamevalue.usefulweb.site/mcp" }
  }
}