Tarotoo Tarot

io.github.Tarotoo-comPublished by GitHub account Tarotoo-comv2.0.0Updated Oct 24, 2026

All 78 tarot card meanings (Rider-Waite-Smith): lookup, search, yes/no answers, and random draws.

VerifiedSTDIODesktop only

Overview

AI-generated overview

Gives an assistant the full 78-card Rider-Waite-Smith tarot dataset: card meanings, keywords, love/career/mood/spiritual contexts, and yes/no values.

What you can do
  • Look up one card's full record, with forgiving name matching
  • List cards filtered by arcana or suit
  • Search cards by theme or keyword, best match first
  • Get a card's yes, no or maybe value with justification
  • Draw random distinct cards, optionally reversed, for spreads
When to use it
Useful when you want an assistant to answer tarot questions, explain card meanings, or generate spreads for entertainment, self-reflection, creative writing or teaching, using a fixed published dataset rather than improvised interpretations.
Requirements
Runs locally over stdio via npx; needs Node.js 18 or newer. No account, API key, environment variable or header is required. Desktop MCP clients only.
Before you install
Read-only reference data with no credentials or write actions. The publisher states it is for educational, research, creative, entertainment and self-reflection purposes and is not a substitute for medical, legal, financial or mental-health advice.

Installation

In SourceWeft

  1. Open Tarotoo Tarot in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Tarotoo Tarot MCP Server

[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 and reversed meanings and keywords, upright and reversed love, career, mood and spiritual contexts, planet and zodiac associations, and upright and reversed 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

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

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

json
{  "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

ToolArgumentsReturns
get_card_meaningname (string)Full record for one card — meanings, keywords, love/career/mood/spiritual (upright and reversed), planet, zodiac, yes/no. Name matching is forgiving ("fool" → The Fool)
list_cardsarcana? (major/minor), suit? (wands/cups/swords/pentacles)Card names, optionally filtered
search_cardsquery (string), limit? (1–78, default 10)Cards matching a theme or keyword, best match first — e.g. "heartbreak" → Three of Swords
yes_no_answername (string)The card's yes/no/maybe value with its upright meaning as justification
draw_cardscount? (1–10, default 1), allow_reversed? (boolean)Random distinct cards with orientation-appropriate meanings — for generating spreads

Example

tools/call get_card_meaning {"name": "the star"}
json
{  "name": "The Star",  "arcana": "major",  "element": "Air",  "planet": "Saturn",  "zodiac": "Aquarius",  "yes_no": "yes",  "yes_no_reversed": "no",  "keywords_upright": ["hope", "renewal", "healing", "inspiration", "faith"],  "meaning_upright": "Hope, renewal, healing, inspiration, faith.",  "love": "hope in love, emotional healing, renewed trust, an inspiring connection",  "love_reversed": "lost faith, discouragement, disconnection, dimmed hope"}

Each card carries both upright and reversed values for keywords, meaning, love, career, mood, spiritual, and yes/no. The example above is abbreviated.

Run from source

bash
git clone https://github.com/Tarotoo-com/tarotoo-mcp-server.gitcd tarotoo-mcp-servernpm installnpm test        # 8-check smoke test: full MCP session over stdionode server.js  # stdio transport

Dataset

The embedded data/cards.json is built from tarotoo-tarot-dataset (MIT). The same data is published in several places:

ResourceLink
Dataset source and docsTarotoo-com/tarotoo-tarot-dataset
Dataset homepagetarotoo.com/open-data
Hugging FaceTarotoo/tarotoo-tarot-card-meanings
Kaggletarotoo/tarotoo-tarot-card-meanings
npm packagetarotoo-tarot
PyPI packagetarotoo-tarot
Citable DOI, dataset and paper10.5281/zenodo.21285777
Citable DOI, whole repository10.5281/zenodo.21268290
This server's own DOI10.5281/zenodo.21298382

Both dataset DOIs are concept DOIs and always resolve to the newest version.

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.

Source: README.md at commit 88e56e0

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v2.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts