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 cardsdraw_random_card — Single card draw with optional reversalsthree_card_spread — Past / Present / Future readingyes_no_reading — Binary verdict for specific questionslist_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:
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.
Add to claude_desktop_config.json:
{
"mcpServers": {
"tarot": {
"command": "npx",
"args": ["-y", "@deckaura/tarot-mcp-server"]
}
}
}
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.
If you prefer a web-based experience, Deckaura offers free tools:
License
MIT © Deckaura
Links