{"openapi":"3.1.0","info":{"title":"Tarocchi API","version":"0.1.0","description":"A fully local, hand-curated rules reference for the Tarot-card TRICK-TAKING CARD GAME family: French Tarot, Austrian Tarock (Konigrufen), Italian Tarocchi (Tarocchino Bolognese) and Swiss Troccas. Covers game rules, bidding/contract systems, trump hierarchies, deck composition, scoring, a cross-variant glossary, side-by-side variant comparison, and beginner tips. Not about tarot divination or fortune-telling.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://tarocchi.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/tarocchi/docs"},"termsOfService":"https://connectorbay.com/tarocchi/terms"},"servers":[{"url":"https://tarocchi.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/tarocchi/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/game_rules":{"post":{"operationId":"game_rules","summary":"Full rules overview for one Tarot-card trick-taking variant: players, deck summary, setup and deal,","description":"Full rules overview for one Tarot-card trick-taking variant: players, deck summary, setup and deal,\n    bidding overview, trump overview, scoring overview, special cards, beginner tips and a history note. Use\n    for \"how do you play French Tarot\", \"explain the rules of Konigrufen\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variant":{"description":"A Tarot-card game variant's name or alias.","examples":["French Tarot","Konigrufen","Tarocchino Bolognese","Troccas"],"minLength":1,"title":"Variant","type":"string"}},"required":["variant"],"title":"game_rulesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/term_glossary":{"post":{"operationId":"term_glossary","summary":"Defines terms used across the Tarot-card game family and its four variants — Excuse, Skus, Matto,","description":"Defines terms used across the Tarot-card game family and its four variants — Excuse, Skus, Matto,\n    bout/oudler, Pagat, Mond, chien, talon, poignee, chelem, Konigrufen, Rufkonig, Bettel, Papi/Mori,\n    Tarocchino, and general trick-taking vocabulary. Use for \"what does 'oudler' mean\", \"what's a poignee\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list every term.","title":"Term"}},"title":"term_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/bidding_system":{"post":{"operationId":"bidding_system","summary":"The bidding/contract structure for one variant: named contracts (or fixed-partnership shape where a","description":"The bidding/contract structure for one variant: named contracts (or fixed-partnership shape where a\n    variant has no competitive auction), what each contract requires, and how they compare in risk/reward.\n    Use for \"what are the French Tarot bid levels\", \"does Tarocchino Bolognese have bidding\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variant":{"description":"A Tarot-card game variant's name or alias.","examples":["French Tarot","Austrian Tarock","Italian Tarocchi"],"minLength":1,"title":"Variant","type":"string"}},"required":["variant"],"title":"bidding_systemArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/trump_hierarchy":{"post":{"operationId":"trump_hierarchy","summary":"One variant's trump ranking: how many trumps, the ranking ladder, the top and bottom trump, and any","description":"One variant's trump ranking: how many trumps, the ranking ladder, the top and bottom trump, and any\n    special trump/Fool-type cards (the Excuse, Skus, Matto) and their role. Use for \"what's the highest trump\n    in French Tarot\", \"what is the Skus\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variant":{"description":"A Tarot-card game variant's name or alias.","examples":["French Tarot","Konigrufen","Troccas"],"minLength":1,"title":"Variant","type":"string"}},"required":["variant"],"title":"trump_hierarchyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/scoring_summary":{"post":{"operationId":"scoring_summary","summary":"One variant's scoring: card point values, the taker's/declarer's target (and how it shifts with bouts","description":"One variant's scoring: card point values, the taker's/declarer's target (and how it shifts with bouts\n    or Honours held, where documented), contract multipliers, and named bonuses (petit au bout, poignee,\n    chelem, Pagat Ultimo, ...). Use for \"how many points do you need to win French Tarot\", \"what's petit au\n    bout worth\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variant":{"description":"A Tarot-card game variant's name or alias.","examples":["French Tarot","Austrian Tarock","Tarocchino Bolognese"],"minLength":1,"title":"Variant","type":"string"}},"required":["variant"],"title":"scoring_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/variant_comparison":{"post":{"operationId":"variant_comparison","summary":"Side-by-side comparison of two named variants: deck size, trump count, partnership style, bidding","description":"Side-by-side comparison of two named variants: deck size, trump count, partnership style, bidding\n    style and scoring style. Use for \"compare French Tarot and Konigrufen\", \"how is Tarocchino different from\n    French Tarot\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"a":{"description":"First variant's name or alias.","examples":["French Tarot"],"minLength":1,"title":"A","type":"string"},"b":{"description":"Second variant's name or alias.","examples":["Konigrufen"],"minLength":1,"title":"B","type":"string"}},"required":["a","b"],"title":"variant_comparisonArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/deck_composition":{"post":{"operationId":"deck_composition","summary":"One variant's full deck makeup: total card count, suits, ranks and face cards, trump count and range,","description":"One variant's full deck makeup: total card count, suits, ranks and face cards, trump count and range,\n    and any special extra card (Excuse/Skus/Matto). Use for \"what's in a French Tarot deck\", \"how many cards\n    are in a Tarocchino Bolognese deck\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variant":{"description":"A Tarot-card game variant's name or alias.","examples":["French Tarot","Tarocchino Bolognese","Troccas"],"minLength":1,"title":"Variant","type":"string"}},"required":["variant"],"title":"deck_compositionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"A curated shortlist of tips for a new player of one variant, or general tips that apply across the","description":"A curated shortlist of tips for a new player of one variant, or general tips that apply across the\n    whole Tarot-card game family when called with no variant. Use for \"tips for a beginner playing French\n    Tarot\", \"how do I get started with this whole card game family\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A Tarot-card game variant's name or alias; omit for general cross-variant tips.","title":"Variant"}},"title":"beginner_tipsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/variant_list":{"post":{"operationId":"variant_list","summary":"Every Tarot-card game variant covered by this reference, with region, player count and a one-line","description":"Every Tarot-card game variant covered by this reference, with region, player count and a one-line\n    summary each. Use for \"what Tarot card game variants do you cover\", \"list the tarot trick-taking games\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"variant_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}