Tarotoo Tarot

npm CI MCP Registry Node License: MIT DOI

A Model Context Protocol server that gives AI assistants — Claude, ChatGPT, Cursor, and any other MCP client — live access to the Tarotoo tarot card meanings dataset: all 78 cards in the Rider–Waite–Smith tradition, with upright/reversed meanings, keywords, love, career, mood and spiritual contexts, planet and zodiac associations, and yes/no values.

Published by Tarotoo: these are the same card meanings that ground the AI readings on Tarotoo.com.

Quick start

Requires Node.js ≥ 18. No installation needed — clients run it via npx.

Claude Code

claude mcp add tarotoo-tarot -- npx -y tarotoo-mcp-server

Claude Desktop — add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "tarotoo-tarot": {
      "command": "npx",
      "args": ["-y", "tarotoo-mcp-server"]
    }
  }
}

Cursor / Windsurf / other MCP clients — same command/args pair in the client's MCP settings.

MCP registry — listed as io.github.Tarotoo-com/tarotoo-mcp-server, so registry-aware clients can discover and install it directly.

Then ask your assistant things like "what does the Three of Swords mean for my career?" or "draw three cards for me" — it will call the tools below.

Tools

Example

tools/call get_card_meaning {"name": "the star"}

{
  "name": "The Star",
  "arcana": "major",
  "element": "Air",
  "planet": "Saturn",
  "zodiac": "Aquarius",
  "yes_no": "yes",
  "keywords_upright": ["hope", "renewal", "healing", "inspiration", "faith"],
  "meaning_upright": "Hope, renewal, healing, inspiration, and faith.",
  "url": "https://tarotoo.com/tarot-card-meanings/the-star"
}

Run from source

git clone https://github.com/Tarotoo-com/tarotoo-mcp-server.git
cd tarotoo-mcp-server
npm install
npm test        # 8-check smoke test: full MCP session over stdio
node server.js  # stdio transport

Dataset

The embedded data/cards.json is built from tarotoo-tarot-dataset (MIT), which is also available on Hugging Face, Kaggle, npm, and PyPI, with citable DOIs: 10.5281/zenodo.21285777 (dataset + dataset paper; concept DOI, always latest) and 10.5281/zenodo.21282132 (full repository/archive: dataset, source files, build scripts, automated validation, software packages, documentation).

Interpretations were created by Tarotoo within the Rider–Waite–Smith tradition, drawing on established sources (A. E. Waite's The Pictorial Key to the Tarot, 1911; attributions per the Golden Dawn's Book T).

License

Code and dataset: MIT. Attribution to Tarotoo (tarotoo.com) is appreciated.

Intended Use

This dataset is intended for educational, research, creative, entertainment, and self-reflection purposes. It should not be used as a substitute for medical, legal, financial, mental-health, or other professional advice.