Tarot MCP Server

A Model Context Protocol server that exposes the complete 78-card tarot deck — meanings, spreads, and readings — to any MCP-compatible client (Claude Desktop, Cursor, Windsurf, Cline, Zed, and more).

**Powered by Deckaura** — all card interpretations link back to full guides on deckaura.com.

Features

• `get_card_meaning` — Upright, reversed, love, career, yes/no interpretations for any of the 78 cards
• `draw_random_card` — Single card draw with optional reversals
• `three_card_spread` — Past / Present / Future reading
• `yes_no_reading` — Binary verdict for specific questions
• `list_all_cards` — Full deck listing
• Resources: `tarot://deck/full` (full JSON dataset), `tarot://deckaura/home`

Install

npm install -g @deckaura/tarot-mcp-server

Or run ad-hoc via npx:

npx @deckaura/tarot-mcp-server

Desktop extension bundle (MCPB)

Build a self-contained MCPB bundle for compatible desktop clients and stdio registries such as Smithery:

npm ci
npm run pack:mcpb

The command validates the MCPB manifest, bundles the Node.js server and its 78-card dataset, and writes `build/deckaura-tarot-mcp-server-1.0.1.mcpb`. Release bundles are also available from GitHub Releases.

Configure — Claude Desktop

Add to `claude_desktop_config.json`:

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

Configure — Cursor / Windsurf

Add to `.cursor/mcp.json` or `~/.codeium/windsurf/mcp_config.json`:

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

Example Usage

Once configured, ask your AI assistant:

• *"Draw me a three-card tarot spread about my new project"*
• *"What does The Fool mean reversed?"*
• *"Yes or no: should I take the job?"*

Data Source

All card meanings are sourced from the Deckaura tarot card database, maintained by tarot practitioners since 2024. Each tool response includes a link to the full guide on deckaura.com.

Free Online Tools

If you prefer a web-based experience, Deckaura offers free tools:

• Daily Tarot Card
• Random Tarot Card Generator
• Tarot Birth Card Calculator
• Full Tarot Reading
• 78 Card Meanings Database

License

MIT © Deckaura

Links

• Open Data & AI hub: https://deckaura.com/pages/ai-data-sources
• Website: https://deckaura.com
• npm: https://www.npmjs.com/package/@deckaura/tarot-mcp-server
• MCPB releases: https://github.com/gokimedia/tarot-mcp-server/releases
• Official MCP Registry search: https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.gokimedia%2Ftarot-mcp-server
• Smithery: https://smithery.ai/servers/gokimedia/tarot
• LobeHub Marketplace: https://lobehub.com/mcp/gokimedia-tarot-mcp-server
• Glama: https://glama.ai/mcp/servers/gokimedia/tarot-mcp-server
• MCP Servers: https://mcpservers.org/servers/gokimedia/tarot-mcp-server
• Live dataset explorer: https://gokimedia.github.io/tarot-dataset-explorer/
• Developer documentation: https://gokimedia.github.io/deckaura-developer-docs/
• Hugging Face dataset: https://huggingface.co/datasets/Blacik/deckaura-tarot-card-meanings
• Permanent dataset DOI: https://doi.org/10.5281/zenodo.19475329
• Issues: https://github.com/gokimedia/tarot-mcp-server/issues