API & MCP
Everything a person can do on Doppelkopf Score Calculator, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://playcardsdoppelkopfscore.usefulweb.app/api/v1/calculate– run Doppelkopf Score CalculatorGET https://playcardsdoppelkopfscore.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Doppelkopf Score Calculator
Scores one game of Doppelkopf by the tournament rules of the Deutscher Doppelkopf-Verband: who won (121 for Re, 120 for Kontra, shifted by announcements and Absagen), the plus-minus points for winning, against the Queens of Clubs, under 90/60/30, Schwarz, Re/Kontra (+2 each), every Absage, reaching 120/90/60/30 against an Absage, and the special points Fox caught, Karlchen and Doppelkopf in normal games. A soloist scores three times. The Playcards app scores every game with the same function.
| Field | Type | Default | Description |
|---|---|---|---|
solo | boolean | false | Solo (Re is one player) |
reAugen | integer | 121 | Card points of the Re party. Kontra has 240 minus this. |
reTricks | integer | 6 | Tricks won by Re |
kontraTricks | integer | 6 | Tricks won by Kontra |
reAnnounce | select (0, 1, 2, 3, 4, 5) | "0" | Highest announcement of Re |
kontraAnnounce | select (0, 1, 2, 3, 4, 5) | "0" | Highest announcement of Kontra |
reFox | integer | 0 | Foxes caught by Re |
reKarlchen | integer | 0 | Karlchen for Re (last trick won with the Jack of Clubs) |
reDoppelkopf | integer | 0 | Doppelköpfe won by Re (tricks with 40+ points) |
kontraFox | integer | 0 | Foxes caught by Kontra |
kontraKarlchen | integer | 0 | Karlchen for Kontra |
kontraDoppelkopf | integer | 0 | Doppelköpfe won by Kontra |
Example request
Re wins with 150, Re announced, one fox caught
curl -X POST https://playcardsdoppelkopfscore.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"reAugen":150,"reTricks":8,"kontraTricks":4,"reAnnounce":"1","reFox":1}'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://playcardsdoppelkopfscore.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
playcards_doppelkopf_score - Local stdio connector:
node src/mcp-stdio.ts --tool=playcards-doppelkopf-score
{
"mcpServers": {
"playcards-doppelkopf-score": { "type": "http", "url": "https://playcardsdoppelkopfscore.usefulweb.app/mcp" }
}
}