Welcome to Scrollrack.gg Documentation

Scrollrack.gg is a high-speed deck validation platform for trading card games (TCGs), currently supporting Magic: The Gathering (MTG) and Yu-Gi-Oh! with a simple, powerful API.

🚀 Quick Start

# Validate a Commander deck
curl -X POST https://scrollrack.topdeck.gg/api/validate \
  -H "Content-Type: application/json" \
  -d '{
    "game": "mtg",
    "format": "commander",
    "list": "~~Commanders~~\n1 Atraxa, Praetors Voice\n\n~~Mainboard~~\n99 Forest"
  }'

📘 Core Concepts

Deck Validation

Scrollrack validates decklists against format-specific rules, checking:

• Card legality in the chosen format
• Deck size requirements
• Card quantity limits
• Required deck sections

Decklist Formatting

Decklists use a simple text format with section markers:

~~Mainboard~~
4 Lightning Bolt
20 Mountain

~~Sideboard~~
3 Blood Moon

Section markers use double tildes (~~Section Name~~) to define different parts of your deck.

🎮 Supported Games

Currently supported games:

• Magic: The Gathering
• Yu-Gi-Oh!

🔍 Magic: The Gathering Features

• Full multi-language support for card names in all Scryfall-supported languages
• Support for all official formats
• Detailed format-specific validation
• Recognition of split cards and alternate names
• Validation against current ban lists
• Section-based validation (Mainboard, Sideboard, Commanders)

🔍 Yu-Gi-Oh! Features

• Support for Edison and Goat formats
• Extra Deck validation
• Main Deck, Side Deck, and Extra Deck sections
• Card legality validation for specific formats
• Minimum deck size enforcement (40 cards)

📋 Supported Formats

MTG Pre-configured formats:

• Commander: 100-card singleton format with 1-2 commanders
• Pauper Commander: 100-card singleton format with 1-2 commanders, commons only

MTG Default rules (applied to standard, modern, legacy, etc.):

• 60 card minimum mainboard
• 15 card maximum sideboard
• Maximum 4 copies of any non-basic land card

Yu-Gi-Oh! Supported formats:

• Edison: Historical format with 40+ card minimum, 15 card Side/Extra Deck maximum
• Goat: Historical format with 40+ card minimum, 15 card Side/Extra Deck maximum

⚙️ How It Works

Scrollrack processes decklists in the following steps:

1. Parse the decklist: Text is parsed into sections with cards and quantities
2. Normalize card names: Names are standardized for matching
3. Database lookup: Cards are verified against game-specific databases
4. Rule checking: Format-specific rules are applied
5. Response generation: Results are formatted as JSON

📬 API Reference

The Scrollrack API provides a simple RESTful interface for deck validation.

See the detailed API Reference for request/response formats, examples, and error handling.

🧪 Try It Live

Test the validation API with our interactive web interface:

• MTG Deck Validator - Paste a decklist and see validation results
• Yu-Gi-Oh! Deck Validator - Paste a decklist and see validation results

Our live demo is available at: https://scrollrack.topdeck.gg/

💻 Integration Examples

JavaScript

async function validateDeck(decklist) {
  const response = await fetch('https://scrollrack.topdeck.gg/api/validate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      game: 'mtg',
      format: 'modern',
      list: decklist
    })
  });
  
  return await response.json();
}

Python

import requests

def validate_deck(decklist):
    response = requests.post(
        'https://scrollrack.topdeck.gg/api/validate',
        json={
            'game': 'mtg',
            'format': 'modern',
            'list': decklist
        }
    )
    
    return response.json()