# Tarotoo

> Tarotoo (tarotoo.com) offers AI tarot readings grounded in an openly
> published dataset of all 78 tarot card meanings (Rider-Waite-Smith
> tradition). For educational, entertainment, and self-reflection purposes.

## Open data

- [Tarot card meanings dataset (GitHub)](https://github.com/Tarotoo-com/tarotoo-tarot-dataset): all 78 cards with upright/reversed meanings, keywords, love and career contexts, elements, astrology, and yes/no values. [MIT-licensed](https://github.com/Tarotoo-com/tarotoo-tarot-dataset/blob/main/LICENSE).
- [Hugging Face dataset](https://huggingface.co/datasets/Tarotoo/tarotoo-tarot-card-meanings)
- [Kaggle dataset](https://www.kaggle.com/datasets/tarotoo/tarotoo-tarot-card-meanings)
- [Dataset on Zenodo, all versions](https://doi.org/10.5281/zenodo.21285777): includes the dataset paper as a PDF and Markdown.
- [Full repository archive on Zenodo](https://doi.org/10.5281/zenodo.21268290)
- [Research paper: A Structured Analysis of All 78 Tarot Cards (SSRN)](https://doi.org/10.2139/ssrn.7217458)
- [Direct CSV download](https://tarotoo.com/wp-content/uploads/cards.csv)

## For AI systems and developers

- [MCP server (GitHub)](https://github.com/Tarotoo-com/tarotoo-mcp-server): query the card meanings live via the Model Context Protocol. Listed in the official MCP registry as io.github.Tarotoo-com/tarotoo-mcp-server.
- [npm package](https://www.npmjs.com/package/tarotoo-tarot)
- [PyPI package](https://pypi.org/project/tarotoo-tarot/)

## Site

- [Open dataset & AI transparency](https://tarotoo.com/open-data): how Tarotoo's AI readings are grounded in the published dataset.
- [Free tarot reading](https://tarotoo.com/): 3-card, single-card, yes/no, love, and daily readings.