A professional-grade integration for querying Magic: The Gathering card data, pricing, and imagery via the Scryfall API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install scryfall-card
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install scryfall-card using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Scryfall MTG?
The Scryfall MTG skill provides a robust interface for AI agents to interact with the expansive Scryfall database, which is widely considered the gold standard for Magic: The Gathering data. By incorporating this skill into your ecosystem of Openclaw Skills, your agent gains the ability to perform complex queries across thousands of cards, retrieve high-quality imagery, and access real-time market pricing.
This tool is specifically engineered for developers building deck-building assistants, collection management tools, or research agents that require precise card details. It handles the nuances of the Scryfall API, including its powerful search syntax, allowing for highly specific filtering by color, mana cost, oracle text, and format legality.
Scryfall MTG Use Cases
- Searching for specific Magic: The Gathering cards by name, type, or complex attributes.
- Retrieving real-time market prices in USD, EUR, and TIX for card collection valuation.
- Verifying card legality across formats like Standard, Modern, Commander, and Pauper.
- Fetching random cards based on specific thematic filters like creature type or set.
- Accessing card imagery for visual representation within chat interfaces powered by Openclaw Skills.
How Scryfall MTG Works
- The AI agent identifies a request related to Magic: The Gathering within the Openclaw Skills framework.
- The skill constructs an API request based on the user's intent, using either full-text search, exact name lookup, or fuzzy matching.
- The request is dispatched to the Scryfall API with a mandatory User-Agent header and built-in rate limiting of 50-100ms between calls.
- The skill receives the JSON response and parses the card object, extracting essential fields like oracle text, mana cost, and image URIs.
- The formatted data is returned to the agent to provide a comprehensive answer to the user.
Scryfall MTG Setup
To deploy this tool within your collection of Openclaw Skills, ensure you have Python 3.x installed and follow these steps to test the implementation:
# Navigate to your local skill directory
cd skills/scryfall-mtg
# Test a basic card search
python3 scripts/scryfall_search.py search "lightning bolt"
# Search for a card using an exact name match
python3 scripts/scryfall_search.py named --exact "Black Lotus"
# Get a random card with a specific filter
python3 scripts/scryfall_search.py random --query "t:dragon"
Scryfall MTG Data Schema & Taxonomy
The Scryfall MTG skill organizes data into structured objects that are easily consumed by Openclaw Skills. The following fields are prioritized in the data output:
| Field | Description |
|---|---|
name |
The official name of the Magic card |
mana_cost |
The mana symbols required to cast the spell |
type_line |
The full type line including card types and subtypes |
oracle_text |
The official rules text for the card |
image_uris |
A collection of links to various image sizes (small, normal, large) |
prices |
Current pricing data for non-foil, foil, and digital versions |
legalities |
A status map for all major MTG game formats |
Scryfall MTG Advanced Features
- Full support for the Scryfall Search Syntax, allowing queries like
c:red pow=3orf:standard. - Fuzzy name matching to provide accurate results even with typos or partial card names.
- Double-faced card support via automatic detection and traversal of the
card_facesarray. - Built-in rate limiting (max 10 requests per second) to maintain high reliability within Openclaw Skills.
- Autocomplete endpoint integration for building responsive search suggestions in agent-led UIs.
SKILL.md
Loading
Related Openclaw Skills
Scryfall MTG Search
A comprehensive search and retrieval skill for Magic: The Gathering card data using the professional Scryfall API.
Santi's Custom Welcome Assistant
A personalized entry-point skill designed for system verification and customized greeting workflows on dedicated server environments.
Macro Pipeline
A robust framework for executing multi-step project roadmaps and QA pipelines autonomously using a heartbeat-driven execution model.
Tweet Writer
An AI-powered writing assistant that researches and generates viral X content using proven copywriting frameworks and algorithm-first strategies.
Scryfall MTG Card Search
A high-performance Magic: The Gathering card data retrieval skill powered by the Scryfall API for AI agents.
Archon Decentralized Identity
Archon is a comprehensive decentralized identity system providing local node management, DID operations, and secure vault storage for AI agents.
Featured*
