Log inSubmit server

Deckaura Tarot README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the Deckaura Tarot listing page.

Back to Deckaura Tarot View source on GitHub

Tarot MCP Server

npm MCP Smithery LobeHub License: MIT

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

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

Or run ad-hoc via npx:

Terminal
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:

Terminal
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:

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:

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:

License

MIT © Deckaura

Links