API per inviare mazzi: manda una lista a Reliquary via REST
Reliquary ha un'API per inviare mazzi in un senso preciso: un programma può mandarle la lista di un mazzo come testo e ricevere un mazzo, con ogni riga che non ha saputo leggere indicata per nome. Non iscrive un mazzo a un torneo, a un organizzatore o a un client online; per un evento dal vivo, la lista di registrazione gratuita trasforma una lista in un PDF da consegnare.
Le chiamate
Ogni strumento del server MCP è anche una chiamata REST, POST /api/v1/tools/<name> con gli argomenti dello strumento in JSON, e GET /api/v1/tools li elenca con le loro descrizioni.
| Chiamata | Cosa fa |
|---|---|
POST /api/v1/tools/import_deck | Crea un mazzo da decklist_text; restituisce le carte aggiunte, i nomi che non ha saputo risolvere e le righe che ha ignorato |
POST /api/v1/decks | Crea un mazzo vuoto, con il suo formato e il suo comandante |
POST /api/v1/decks/{id}/wants | Aggiunge fino a 75 righe alla lista di un mazzo in una sola chiamata, ognuna con la sua quantità |
POST /api/v1/decks/{id}/claim | Riserva per il mazzo le copie che possiedi, e dice quali sono condivise e quali mancano |
GET /api/v1/export/deck/{id} | Il mazzo come semplice testo di lista |
Il testo della lista è fatto di righe semplici: 4 Lightning Bolt (2XM) 123, intestazioni Commander e Sideboard, righe SB:. La guida alle liste elenca ogni formato che legge.
L'accesso
Una richiesta porta un token bearer OAuth, lo stesso accesso che usa un assistente. Il server registra i client su /oauth/register, e tu consenti l'accesso nella pagina di consenso di Reliquary. Disconnettere il client nella pagina del tuo account chiude il suo token alla chiamata successiva.
Cosa non fa
- Iscrivere una lista a un evento, a una piattaforma di tornei o a un client di gioco.
- Eliminare senza chiedere:
delete_deckdescrive soltanto cosa farebbe finché non viene richiamato conconfirm: true, ed eliminare un mazzo non elimina mai le carte. - Nascondere una copia condivisa: una riserva condivisa nomina gli altri mazzi e il posto in cui la carta si trova fisicamente.
Domande
L'API è inclusa nel piano gratuito?
Sì. Un account gratuito contiene cinque mazzi: un sesto risponde PLAN_LIMIT, stato 402, con un link ai prezzi. Le chiamate all'API non sono mai in vendita.
Può leggere un link di Moxfield invece del testo?
import_deck accetta anche il link di un mazzo pubblico su Moxfield, ma quel recupero può fallire. Il testo funziona sempre.
Cosa devo consegnare a un evento?
Quello che chiede l'organizzatore. La lista di registrazione crea un PDF stampabile di una lista con il mazzo principale e la sideboard contati; non è il modulo ufficiale di nessun organizzatore.