デッキ送信 API: RESTでデッキリストをReliquaryに送る
Reliquaryには、ある意味でのデッキ送信APIがあります。プログラムからデッキリストをテキストで送るとデッキが返り、読めなかった行はすべて示されます。大会、主催者、オンラインクライアントにデッキを登録するものではありません。紙の大会には、無料のデッキ登録用紙でリストを提出用のPDFにできます。
呼び出し
MCPサーバーのすべてのツールはRESTの呼び出しでもあります。POST /api/v1/tools/<name> にツールの引数をJSONで渡し、GET /api/v1/tools で説明付きの一覧が得られます。
| 呼び出し | すること |
|---|---|
POST /api/v1/tools/import_deck | decklist_text からデッキを作り、追加したカード、特定できなかった名前、無視した行を返す |
POST /api/v1/decks | フォーマットと統率者を指定して空のデッキを作る |
POST /api/v1/decks/{id}/wants | 1回の呼び出しでデッキのリストに最大75行を、それぞれの枚数付きで追加する |
POST /api/v1/decks/{id}/claim | 所有するカードをデッキのために確保し、どれが共有でどれが不足かを返す |
GET /api/v1/export/deck/{id} | デッキをプレーンなデッキリストのテキストで返す |
デッキリストのテキストはプレーンな行です。4 Lightning Bolt (2XM) 123、Commander と Sideboard の見出し、SB: の行など。読み取れる形式はすべてデッキリストのガイドにあります。
サインイン
リクエストにはOAuthのBearerトークンを付けます。アシスタントと同じサインインです。サーバーは /oauth/register でクライアントを登録し、あなたはReliquary自身の同意ページでアクセスを許可します。アカウントページでクライアントの接続を解除すると、次の呼び出しでそのトークンは無効になります。
しないこと
- 大会、大会プラットフォーム、ゲームクライアントへのリストの登録。
- 確認なしの削除。
delete_deckはconfirm: true付きでもう一度呼ばれるまで、何をするかを説明するだけです。デッキを削除してもカードは削除されません。 - 共有のカードを隠すこと。共有の確保は、他のデッキと、カードが実際にある場所を示します。
よくある質問
APIは無料プランで使えますか？
はい。無料アカウントはデッキを5個まで持てます。6個目は PLAN_LIMIT（ステータス402）を返し、料金へのリンクが付きます。APIの呼び出しが有料になることはありません。
テキストの代わりにMoxfieldのリンクを読めますか？
import_deck は公開されたMoxfieldのデッキリンクも受け付けますが、その取得は失敗することがあります。テキストなら必ず使えます。
大会では何を提出すればいいですか？
主催者が求めるものです。デッキ登録用紙は、メインデッキとサイドボードの枚数を数えた印刷用PDFを作りますが、どの主催者の公式用紙でもありません。