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

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

• Website: https://deckaura.com
• npm: https://www.npmjs.com/package/@deckaura/tarot-mcp-server
• MCP Registry: https://modelcontextprotocol.io/servers
• Issues: https://github.com/gokimedia/tarot-mcp-server/issues