Tarotoo 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/reversed meanings, keywords, love, career, mood, and spiritual contexts, and yes/no values.

Published by Tarotoo as part of its AI transparency initiative: these are the same card meanings that ground the AI readings on Tarotoo.com.

Tools

| Tool | Description | | ------------------ | --------------------------------------------------------------------- | | get_card_meaning | Full meaning of a card by name (tolerates minor name variants) | | list_cards | List card names, filterable by arcana or suit | | search_cards | Search cards by theme or keyword, e.g. "new beginnings", "heartbreak" | | yes_no_answer | A card's yes/no/maybe value for yes-or-no readings | | draw_cards | Randomly draw 1–10 distinct cards, optionally reversed, with meanings |

Usage

Requires Node.js 18+.

Claude Desktop / Claude Code

Add to your MCP configuration (claude_desktop_config.json, or claude mcp add):

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

From a local clone

git clone https://github.com/Tarotoo-com/tarotoo-mcp-server.git
cd tarotoo-mcp-server
npm install
node server.js

The server communicates over stdio.

Dataset

The embedded data/cards.json comes from tarotoo-tarot-dataset (MIT-licensed), also available on Hugging Face Kaggle, npm, and PyPI. Interpretations are grounded in A. E. Waite's The Pictorial Key to the Tarot (1911, public domain), written in Tarotoo's editorial voice.

License

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

For entertainment and self-reflection purposes

Tarot readings are for entertainment and self-reflection only — not medical, legal, financial, or mental-health advice.