A comprehensive search and retrieval skill for Magic: The Gathering card data using the professional Scryfall API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mtg-edh-deckbuilder
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 mtg-edh-deckbuilder 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 Search?
The Scryfall MTG Search skill empowers AI agents to access a massive database of Magic: The Gathering information. It provides a structured interface to query the Scryfall API for card names, oracle text, mana costs, and current market pricing.
This integration for Openclaw Skills allows developers to build specialized agents that can assist with deck construction, rules clarification, and financial tracking within the MTG ecosystem. It handles the technical complexities of API communication, including mandatory rate limiting and header management, to provide a seamless data retrieval experience.
Scryfall MTG Search Use Cases
- Searching for specific card text or abilities to clarify game mechanics.
- Retrieving real-time market prices in USD, EUR, or Tix for card trading.
- Finding high-resolution card artwork for visual identification and deck lists.
- Filtering cards by format legality, such as Standard, Commander, or Modern.
- Automating card discovery for deck-building suggestions based on mana curve or power level.
How Scryfall MTG Search Works
- The AI agent detects a trigger word such as Magic, MTG, or a specific card name within a prompt.
- The Openclaw Skills module prepares a query using the Scryfall search syntax (e.g., color, type, or set code).
- The skill executes a GET request to the Scryfall API core endpoints, ensuring a 50-100ms delay to respect rate limits.
- The API returns a detailed JSON object containing the card metadata, image URIs, and legalities.
- The skill processes the response, prioritizing essential fields like oracle text and price before presenting the data to the agent.
Scryfall MTG Search Setup
To get started with this skill within Openclaw Skills, ensure you have the Python scripts configured in your environment.
Run search commands directly via the CLI:
python3 scripts/scryfall_search.py search "lightning bolt"
For custom implementations, ensure your requests include the required User-Agent headers:
headers = {
"User-Agent": "OpenClawMTGSkill/1.0",
"Accept": "application/json"
}
Scryfall MTG Search Data Schema & Taxonomy
The skill organizes card data into a structured format following the Scryfall object model. Below are the primary fields indexed:
| Field | Description |
|---|---|
| name | The full name of the card |
| mana_cost | The mana symbols required to cast the spell |
| type_line | The card's types, subtypes, and supertypes |
| oracle_text | The official text of the card updated to current rules |
| image_uris | Links to various sizes of the card artwork |
| prices | Current market values for foil and non-foil versions |
| legalities | Dictionary of game formats and the card's legality status |
Scryfall MTG Search Advanced Features
- Fuzzy matching capabilities that allow for partial name lookups to find cards even with typos.
- Advanced search syntax support for complex queries like color identity (c:red) or power/toughness ratios.
- Support for multi-faced cards, automatically handling the card_faces array for flip and double-sided cards.
- Random card generation with filter parameters to facilitate variety in deck-building prompts.
- Detailed error handling to manage 429 rate limits and 404 card-not-found scenarios gracefully.
SKILL.md
Loading
Related Openclaw Skills
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.
Keywords Everywhere SEO Research
A CLI-powered SEO toolset for keyword research, competitor analysis, and backlink tracking using the Keywords Everywhere API.
Scryfall MTG
A professional-grade integration for querying Magic: The Gathering card data, pricing, and imagery via the Scryfall API.
Scryfall MTG Card Search
A high-performance Magic: The Gathering card data retrieval skill powered by the Scryfall API for AI agents.
METADATA
Featured*
