API pro odeslání decku: pošli decklist do Reliquary přes REST
Reliquary má API pro odeslání decku v jednom smyslu: program mu pošle decklist jako text a dostane zpátky deck, s každým řádkem, který se nepodařilo přečíst, jmenovitě. Deck neposílá na turnaj, organizátorovi ani do online klienta; pro papírový turnaj udělá bezplatný registrační list ze seznamu PDF k odevzdání.
Volání
Každý nástroj MCP serveru je zároveň volání REST, POST /api/v1/tools/<name> s argumenty nástroje jako JSON, a GET /api/v1/tools je všechny vypíše i s popisy.
| Volání | Co dělá |
|---|---|
POST /api/v1/tools/import_deck | Vytvoří deck z decklist_text; vrátí přidané karty, názvy, které nedokázal dohledat, a řádky, které přeskočil |
POST /api/v1/decks | Vytvoří prázdný deck s formátem a commanderem |
POST /api/v1/decks/{id}/wants | Přidá do seznamu decku až 75 řádků jedním voláním, každý s počtem |
POST /api/v1/decks/{id}/claim | Rezervuje pro deck kopie, které máš, a řekne, které jsou sdílené a které chybí |
GET /api/v1/export/deck/{id} | Deck jako prostý text decklistu |
Text decklistu jsou prosté řádky: 4 Lightning Bolt (2XM) 123, nadpisy Commander a Sideboard, řádky SB:. Návod k decklistu vypisuje všechny formáty, které umí přečíst.
Přihlášení
Požadavek nese OAuth bearer token, stejné přihlášení, jaké používá asistent. Server registruje klienty na /oauth/register a přístup povolíš na vlastní stránce souhlasu Reliquary. Odpojení klienta na stránce účtu ukončí jeho token při dalším volání.
Co neudělá
- Nepošle seznam na turnaj, na turnajovou platformu ani do herního klienta.
- Nesmaže nic bez ptaní:
delete_deckjen popíše, co by udělal, dokud ho nezavoláš znovu sconfirm: true, a smazání decku nikdy nesmaže karty. - Neskryje sdílenou kopii: sdílená rezervace jmenuje ostatní decky a to, kde karta fyzicky je.
Otázky
Je API v bezplatném plánu?
Ano. Bezplatný účet pojme pět decků: šestý odpoví PLAN_LIMIT, status 402, s odkazem na ceník. Volání API se nikdy neprodávají.
Umí místo textu přečíst odkaz na Moxfield?
import_deck vezme i veřejný odkaz na deck na Moxfieldu, ale jeho stažení může selhat. Text funguje vždy.
Co mám odevzdat na turnaji?
Cokoli si organizátor řekne. Registrační list udělá ze seznamu PDF k tisku se spočítaným hlavním deckem a sideboardem; není to oficiální formulář žádného organizátora.