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 and accompanying paper. The stable Concept DOI resolves to the latest release.
Kaggle
Dataset mirror for exploration, notebooks, analysis, and data-science workflows.
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 uses deterministic lookup to retrieve the published meanings for selected cards and supplies the relevant information to the AI model as structured grounding context. This is a simple form of retrieval-augmented generation (RAG) that does not require embeddings or vector search. 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
All interpretive text was created by Tarotoo within the Rider–Waite–Smith tradition, drawing on established tarot sources — primarily A. E. Waite’s The Pictorial Key to the Tarot (1911). Planet and zodiac correspondences follow classical rulerships and the decan system documented in the Golden Dawn’s Book T, with widely adopted modern associations used for a small number of cards that do not have traditional planetary assignments. Yes/no values draw on widely used modern interpretive conventions and input from tarot experts we have collaborated with, based on each card’s upright meaning. Each card was reviewed for consistency in tone, terminology, and structure across the complete deck.
References
Card meanings and correspondences are informed by established works associated with the Rider–Waite–Smith tradition and related Western esoteric systems:
- Waite, A. E. (1911). The Pictorial Key to the Tarot. William Rider & Son. — Primary source for card meanings.
- Hermetic Order of the Golden Dawn (c. 1888–1897). Book T: The Tarot. — Astrological and elemental attributions.
- Mathers, S. L. MacGregor (1888). The Tarot: Its Occult Signification, Use in Fortune-Telling, and Method of Play.
- Papus (1889). The Tarot of the Bohemians.
- Ouspensky, P. D. (1913). The Symbolism of the Tarot.
- Thierens, A. E. (1930). General Book of the Tarot.
These works were selected for their historical importance and continuing influence on modern tarot interpretation.
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
