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

bash

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

Or run ad-hoc via npx:

bash

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:

bash

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:

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:

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.