CSB: Parse deck text
csb_parse_deck_textParse plain-text decklists into Magic: The Gathering cards using Commander Spellbook to identify cards from text entries.
Instructions
Parse a plain-text decklist into cards using Commander Spellbook.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Plain-text deck list, e.g. '1x Sol Ring' per line |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| main | Yes | ||
| commanders | No |
Implementation Reference
- src/mcp-server.ts:433-436 (handler)The main handler function for the csb_parse_deck_text tool, which calls CSB.parseCardListFromText to parse the deck text and returns structured content.
async ({ text }: { text: string }) => { const res = (await CSB.parseCardListFromText(text)) as any; return { structuredContent: res } as any; } - src/mcp-server.ts:418-424 (schema)Input schema (deck text string) and output schema (arrays of cards with quantities for main and optional commanders).
const csbParseDeckInput = { text: z.string().min(1).describe("Plain-text deck list, e.g. '1x Sol Ring' per line") } as const; const csbParseDeckOutput = { main: z.array(z.object({ card: z.string(), quantity: z.number().int().positive() })), commanders: z.array(z.object({ card: z.string(), quantity: z.number().int().positive() })).optional() } as const; - src/mcp-server.ts:425-437 (registration)Registers the csb_parse_deck_text tool in the MCP server with schema, description, and handler function.
server.registerTool( "csb_parse_deck_text", { title: "CSB: Parse deck text", description: "Parse a plain-text decklist into cards using Commander Spellbook.", inputSchema: csbParseDeckInput, outputSchema: csbParseDeckOutput }, async ({ text }: { text: string }) => { const res = (await CSB.parseCardListFromText(text)) as any; return { structuredContent: res } as any; } ); - src/csb.ts:110-110 (helper)CSB client method that performs POST request to CSB API endpoint /card-list-from-text with the deck text.
parseCardListFromText: (text: string) => postText("/card-list-from-text", text), - src/csb.ts:71-107 (helper)Helper function postText used by CSB methods to send POST requests to CSB API with rate limiting and retries.
async function postText(path: string, body: string) { const base = process.env.CSB_BASE_URL || DEFAULT_BASE_URL; const url = new URL(path, base); const maxRetries = Number(process.env.CSB_MAX_RETRIES || 3); const retryBaseMs = Number(process.env.CSB_RETRY_BASE_MS || 250); for (let attempt = 0; attempt <= maxRetries; attempt++) { await acquireSlot(); const res = await fetch(url, { method: "POST", headers: { "Content-Type": "text/plain", "User-Agent": "scryfall-mcp/0.1 (commanderspellbook client)" }, body }); if (res.status === 429) { const retryAfter = Number(res.headers.get("Retry-After") || 0); const backoff = retryAfter > 0 ? retryAfter * 1000 : retryBaseMs * Math.pow(2, attempt); if (attempt < maxRetries) { await sleep(backoff); continue; } } if (!res.ok) { const text = await res.text().catch(() => ""); throw new Error(`CSB request failed: ${res.status} ${res.statusText} - ${text}`); } return res.json() as Promise<unknown>; } throw new Error("CSB request failed after retries"); }