{
  "markdown": "# Tarotoo Tarot MCP Server\n\n[![npm](https://img.shields.io/npm/v/tarotoo-mcp-server)](https://www.npmjs.com/package/tarotoo-mcp-server)\n[![CI](https://github.com/Tarotoo-com/tarotoo-mcp-server/actions/workflows/test.yml/badge.svg)](https://github.com/Tarotoo-com/tarotoo-mcp-server/actions)\n[![MCP Registry](https://img.shields.io/badge/MCP%20registry-io.github.Tarotoo--com%2Ftarotoo--mcp--server-7b47c9)](https://registry.modelcontextprotocol.io/v0/servers?search=tarotoo)\n[![Node](https://img.shields.io/node/v/tarotoo-mcp-server)](package.json)\n[![License: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](LICENSE)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.21298383.svg)](https://doi.org/10.5281/zenodo.21298383)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that gives AI assistants — Claude, ChatGPT, Cursor, and any other MCP client — live access to the [Tarotoo tarot card meanings dataset](https://github.com/Tarotoo-com/tarotoo-tarot-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.\n\nPublished by [Tarotoo](https://tarotoo.com/open-data): these are the same card meanings that ground the AI readings on Tarotoo.com.\n\n## Quick start\n\nRequires Node.js ≥ 18. No installation needed — clients run it via `npx`.\n\n**Claude Code**\n\n```bash\nclaude mcp add tarotoo-tarot -- npx -y tarotoo-mcp-server\n```\n\n**Claude Desktop** — add to `claude_desktop_config.json` (Settings → Developer → Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"tarotoo-tarot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"tarotoo-mcp-server\"]\n    }\n  }\n}\n```\n\n**Cursor / Windsurf / other MCP clients** — same `command`/`args` pair in the client's MCP settings.\n\n**MCP registry** — listed as [`io.github.Tarotoo-com/tarotoo-mcp-server`](https://registry.modelcontextprotocol.io/v0/servers?search=tarotoo), so registry-aware clients can discover and install it directly.\n\nThen 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.\n\n## Tools\n\n| Tool | Arguments | Returns |\n|---|---|---|\n| `get_card_meaning` | `name` (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) |\n| `list_cards` | `arcana?` (`major`/`minor`), `suit?` (`wands`/`cups`/`swords`/`pentacles`) | Card names, optionally filtered |\n| `search_cards` | `query` (string), `limit?` (1–78, default 10) | Cards matching a theme or keyword, best match first — e.g. `\"heartbreak\"` → Three of Swords |\n| `yes_no_answer` | `name` (string) | The card's `yes`/`no`/`maybe` value with its upright meaning as justification |\n| `draw_cards` | `count?` (1–10, default 1), `allow_reversed?` (boolean) | Random distinct cards with orientation-appropriate meanings — for generating spreads |\n\n## Example\n\n```\ntools/call get_card_meaning {\"name\": \"the star\"}\n```\n\n```json\n{\n  \"name\": \"The Star\",\n  \"arcana\": \"major\",\n  \"element\": \"Air\",\n  \"planet\": \"Saturn\",\n  \"zodiac\": \"Aquarius\",\n  \"yes_no\": \"yes\",\n  \"yes_no_reversed\": \"no\",\n  \"keywords_upright\": [\"hope\", \"renewal\", \"healing\", \"inspiration\", \"faith\"],\n  \"meaning_upright\": \"Hope, renewal, healing, inspiration, faith.\",\n  \"love\": \"hope in love, emotional healing, renewed trust, an inspiring connection\",\n  \"love_reversed\": \"lost faith, discouragement, disconnection, dimmed hope\"\n}\n```\n\nEach card carries both upright and reversed values for keywords, meaning, love, career, mood, spiritual, and yes/no. The example above is abbreviated.\n\n## Run from source\n\n```bash\ngit clone https://github.com/Tarotoo-com/tarotoo-mcp-server.git\ncd tarotoo-mcp-server\nnpm install\nnpm test        # 8-check smoke test: full MCP session over stdio\nnode server.js  # stdio transport\n```\n\n## Dataset\n\nThe embedded `data/cards.json` is built from [tarotoo-tarot-dataset](https://github.com/Tarotoo-com/tarotoo-tarot-dataset) ([MIT](https://github.com/Tarotoo-com/tarotoo-tarot-dataset/blob/main/LICENSE)), which is also available on [Hugging Face](https://huggingface.co/datasets/Tarotoo/tarotoo-tarot-card-meanings), [Kaggle](https://www.kaggle.com/datasets/tarotoo/tarotoo-tarot-card-meanings), [npm](https://www.npmjs.com/package/tarotoo-tarot), and [PyPI](https://pypi.org/project/tarotoo-tarot/), with citable DOIs: [10.5281/zenodo.21285777](https://doi.org/10.5281/zenodo.21285777) (dataset + dataset paper; concept DOI, always latest) and [10.5281/zenodo.21268290](https://doi.org/10.5281/zenodo.21268290) (full repository/archive: dataset, source files, build scripts, automated validation, software packages, documentation; concept DOI, always latest).\n\nInterpretations 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*).\n\n## License\n\nCode and dataset: [MIT](LICENSE). Attribution to Tarotoo (tarotoo.com) is appreciated.\n\n## Intended Use\n\nThis 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.\n",
  "bytes": 5438,
  "sha": "20c6f57cf613a9d577e3fb0a75eab37b2fe205deb6fa04d81e3cbac47ae2af45",
  "repo_slug": "tarotoo-com/tarotoo-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tarotoo_com_tarotoo_mcp_server_fff91f00/readme"
}