Open Data & Developer Resources
Tarotoo publishes its tarot card meanings as an open, machine-readable dataset for developers, researchers, AI applications, and other data users.
The dataset can be explored online, downloaded, cited, integrated into applications, used in research and AI workflows, or adapted for commercial and non-commercial projects.
22 fields per card
MIT License
DOI registered
Rider–Waite–Smith
The Open Dataset
Tarotoo Tarot Card Meanings is a structured dataset covering all 78 tarot
cards, with upright and reversed meanings, keywords, love, career, mood,
and spiritual interpretations, planetary and zodiac associations, and
yes/no values.
Hugging Face
Browse all 78 cards in the interactive dataset viewer or load the dataset directly into supported data and machine-learning workflows.
Zenodo
Permanent archive of the dataset. The stable Concept DOI resolves to the latest release.
Kaggle
Dataset mirror for exploration, notebooks, analysis, and data-science workflows.
Accompanying
Research Paper
Read the structured analysis of the dataset, including its coverage,
upright and reversed meaning patterns, and a complete 78-card cheat-sheet appendix.
A Structured Analysis of All 78 Tarot Cards
The accompanying paper examines the dataset’s structure and completeness and includes a 78-card cheat sheet.
Developer Tools &
Packages
Connect compatible AI clients to the dataset through MCP, or install the
dataset and lookup utilities directly in JavaScript or Python projects.
MCP
Tarotoo MCP Server
Connect compatible AI assistants, development tools, and other Model
Context Protocol clients to Tarotoo’s structured tarot card meanings.
Official registry identifier:
io.github.Tarotoo-com/tarotoo-mcp-server
npm
tarotoo-mcp-server
Run the Tarotoo MCP server directly through npm:
npx -y tarotoo-mcp-server
JavaScript
tarotoo-tarot
Install the complete dataset with lookup utilities for JavaScript and
Node.js projects:
npm install tarotoo-tarot
Python
tarotoo-tarot
Install the complete dataset with lookup utilities for Python projects:
pip install tarotoo-tarot
Full Open-Source
Repository
Explore the complete GitHub repository containing the dataset files, editable source data, build scripts, automated validation, documentation, software packages, and version history.
Full Repository
GitHub
Complete dataset repository with source files, build scripts, automated validation, software packages, documentation, and version history.
Intended Use & Limitations
This dataset is intended for tarot applications, educational and historical research, data analysis, software development, creative projects, and the grounding or evaluation of AI systems that work with tarot-related content. It may also be adapted and incorporated into commercial and non-commercial projects in accordance with the MIT License.
Tarot interpretations are symbolic and subjective. The dataset does not provide factual predictions, psychological assessments, or medical, legal, financial, or other professional advice. Developers should present its content with appropriate context and should not use it to make high-stakes decisions or deterministic claims about individuals or future events.
How Tarotoo Uses the Dataset
Tarotoo’s structured tarot readings use a deterministic form of retrieval-augmented generation (RAG). The selected cards identify the exact dataset records to retrieve, and the relevant meanings are supplied to the AI model as structured grounding context. This direct lookup is well suited to a fixed collection of tarot cards and does not require embeddings, semantic search, or a vector database. Read the technical integration overview to learn how the process works.
Explore the Dataset on Tarotoo.com
Browse all 78 card meanings in an interactive, reader-friendly format with animated cards. View the Full List
How the Dataset Was Created
Methodology
Historical sources
References
- Waite, A. E. (1911). The Pictorial Key to the Tarot. William Rider & Son. — Historical reference for Rider–Waite–Smith card meanings and symbolism.
- Mathers, S. L. MacGregor, and Felkin, H. (late nineteenth century). Book T: The Tarot. — Historical reference for suit elements, Major Arcana base attributions, and planet–sign decan correspondences for numbered Minor Arcana cards.
License & Citation
The Tarotoo dataset, MCP server, and software packages are released under the MIT License.
They may be used, copied, modified, distributed, and incorporated into commercial and non-commercial projects, subject to the terms of the license.
Tarotoo (2026).
Tarotoo Tarot Card Meanings: A Complete 78-Card Structured Dataset (Version 2.0.0) [Dataset].
Zenodo.
https://doi.org/10.5281/zenodo.21514483
