English Français العربية

Tarotoo Tarot

Official registry Search and web

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package tarotoo-mcp-server
Claude Code 
claude mcp add tarotoo-tarot -- npx -y tarotoo-mcp-server@2.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tarotoo-tarot": {
            "command": "npx",
            "args": [
                "-y",
                "tarotoo-mcp-server@2.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Tarotoo Tarot MCP Server
  2. Quick start
  3. Tools
  4. Example
  5. Run from source
  6. Dataset
  7. License
  8. Intended Use

Tarotoo Tarot MCP Server

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

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

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

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). 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.

Frequently asked questions

What is Tarotoo Tarot?

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

How do I install Tarotoo Tarot?

It runs on your machine. In Claude Code: claude mcp add tarotoo-tarot -- npx -y tarotoo-mcp-server@2.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Tarotoo Tarot need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Tarotoo Tarot open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Tarotoo Tarot?

It is published by Tarotoo-com. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.