A high-performance Magic: The Gathering card data retrieval skill powered by the Scryfall API for AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install scryfall-cards
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-cards 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 Card Search?
The Scryfall MTG Card Search skill provides a robust interface for AI agents to interact with the Scryfall API, the industry-standard database for Magic: The Gathering. This integration allows users to query vast amounts of card data, including oracle text, mana costs, legalities, and real-time market pricing. Designed for developers and hobbyists using Openclaw Skills, it simplifies the process of bringing MTG intelligence into automated workflows.
By utilizing this skill, agents can handle complex card lookups ranging from simple name searches to intricate filtered queries based on game mechanics, artist, or rarity. It handles technical requirements like rate limiting and custom headers automatically, ensuring a seamless experience when building card-centric applications.
Scryfall MTG Card Search Use Cases
- Building AI-driven deck-building assistants that suggest cards based on specific mana costs or power/toughness ratios.
- Creating automated price trackers to monitor the market value of specific cards in USD or EUR.
- Developing format-legality checkers to ensure deck lists comply with Standard, Modern, or Commander rules.
- Integrating card art and oracle text references into community chat bots or research tools.
How Scryfall MTG Card Search Works
- The AI agent triggers the skill when a Magic: The Gathering related query is detected, such as a request for a card name or specific attributes.
- The skill constructs a targeted API request using the Scryfall search syntax, supporting either exact matches or fuzzy name lookups.
- A request is sent to the Scryfall API with a specialized User-Agent and a built-in 50-100ms delay to adhere to rate-limiting policies.
- The resulting JSON payload is parsed to extract high-priority fields like oracle text, image URIs, and pricing data.
- For complex cards, such as double-faced or split cards, the skill iterates through the card_faces array to provide complete information.
Scryfall MTG Card Search Setup
To get started with this skill in the context of Openclaw Skills, ensure your environment is configured to execute Python scripts. No API key is required for basic access.
# Search for a card by name
python3 scripts/scryfall_search.py search "lightning bolt"
# Lookup a card using fuzzy matching
python3 scripts/scryfall_search.py named --fuzzy "jac bele"
# Get a random card with a specific filter
python3 scripts/scryfall_search.py random --query "t:dragon"
Ensure your implementation includes the mandatory headers: User-Agent: OpenClawMTGSkill/1.0 and Accept: application/json.
Scryfall MTG Card Search Data Schema & Taxonomy
The skill organizes card data into a structured format for easy extraction. Below are the primary fields prioritized by the Openclaw Skills integration:
| Field | Description | Example |
|---|---|---|
name |
The full name of the card | "Black Lotus" |
mana_cost |
The mana cost including symbols | "{3}" |
oracle_text |
The official rules text of the card | "{T}, Sacrifice Black Lotus: Add..." |
image_uris |
Links to image assets (normal, large, art_crop) | "https://..." |
prices |
Current market value (usd, usd_foil, eur) | "0.99" |
legalities |
Format status (standard, modern, etc.) | "legal" |
Scryfall MTG Card Search Advanced Features
- Advanced search syntax support for filtering by power, toughness, colors, or specific sets (e.g.,
c:red pow=3). - Fuzzy matching engine to resolve partial or misspelled card names into valid objects.
- Built-in pagination support for handling large result sets from broad search queries.
- Comprehensive error handling for 404 (not found), 422 (invalid syntax), and 429 (rate limit) responses within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Scryfall MTG
A professional-grade integration for querying Magic: The Gathering card data, pricing, and imagery via the Scryfall API.
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.
Archon Decentralized Identity
Archon is a comprehensive decentralized identity system providing local node management, DID operations, and secure vault storage for AI agents.
hexmem
A SQLite-powered persistent memory system that gives AI agents structured self-knowledge, identity continuity, and long-term fact retention.
Featured*
