API para enviar mazos: manda una lista de mazo a Reliquary por REST
Reliquary tiene una API para enviar mazos en cierto sentido: un programa le manda una lista de mazo como texto y recibe un mazo, con cada línea que no pudo leer nombrada. No inscribe un mazo en un torneo, ante un organizador ni en un cliente online; para un evento en papel, la hoja de registro gratuita convierte una lista en un PDF para entregar.
Las llamadas
Cada herramienta del servidor MCP es también una llamada REST, POST /api/v1/tools/<name> con los argumentos de la herramienta en JSON, y GET /api/v1/tools las lista con sus descripciones.
| Llamada | Qué hace |
|---|---|
POST /api/v1/tools/import_deck | Crea un mazo a partir de decklist_text; devuelve las cartas añadidas, los nombres que no pudo resolver y las líneas que ignoró |
POST /api/v1/decks | Crea un mazo vacío, con su formato y su comandante |
POST /api/v1/decks/{id}/wants | Añade hasta 75 líneas a la lista de un mazo en una llamada, cada una con su cantidad |
POST /api/v1/decks/{id}/claim | Reserva para el mazo las copias que tienes, y dice cuáles están compartidas y cuáles faltan |
GET /api/v1/export/deck/{id} | El mazo como lista de mazo en texto plano |
La lista de mazo son líneas de texto plano: 4 Lightning Bolt (2XM) 123, encabezados Commander y Sideboard, líneas SB:. La guía de listas de mazo recoge cada forma que lee.
Inicio de sesión
Una petición lleva un token bearer de OAuth, el mismo inicio de sesión que usa un asistente. El servidor registra clientes en /oauth/register, y tú das acceso en la página de consentimiento de Reliquary. Desconectar el cliente en la página de tu cuenta anula su token en la siguiente llamada.
Lo que no hará
- Inscribir una lista en un evento, una plataforma de torneos o un cliente de juego.
- Borrar sin preguntar:
delete_decksolo describe lo que haría hasta que se le llama de nuevo conconfirm: true, y borrar un mazo nunca borra cartas. - Ocultar una copia compartida: una reserva compartida nombra los otros mazos y el lugar donde está físicamente la carta.
Preguntas
¿La API está en el plan gratuito?
Sí. Una cuenta gratuita tiene cinco mazos: un sexto responde PLAN_LIMIT, estado 402, con un enlace a los precios. Las llamadas a la API nunca se venden.
¿Puede leer un enlace de Moxfield en vez de texto?
import_deck también acepta un enlace público a un mazo de Moxfield, pero esa descarga puede fallar. El texto siempre funciona.
¿Qué debo entregar en un evento?
Lo que pida el organizador. La hoja de registro crea un PDF imprimible de una lista con su mazo principal y su banquillo contados; no es el formulario oficial de ningún organizador.