
Deckaura Tarot
io.github.gokimediaPublished by GitHub account gokimediav1.0.1Updated Oct 24, 2026
Explore 78 tarot cards with meanings, card draws, spreads, and Deckaura guide links.
Overview
A local MCP server that gives an assistant the full 78-card tarot deck: card meanings, random draws, spreads and yes/no readings.
- What you can do
- Look up upright, reversed, love, career and yes/no meanings for any of the 78 cards, and list the full deck with its resources for the complete dataset and the Deckaura home page. Draw a single random card, optionally with reversals. Run a three-card past, present and future spread. Get a binary yes/no verdict for a specific question.
- When to use it
- Useful when you want an assistant to answer tarot questions, give sample readings or explore card interpretations inside a chat client, rather than looking them up on a website.
- Requirements
- Runs as a local process on the user's machine, installed globally or run ad hoc through npx, so Node.js and npm are needed. Desktop clients only; no authentication, environment variables or headers are declared.
Installation
In SourceWeft
- Open Deckaura Tarot in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
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 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
Or run ad-hoc via npx:
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.
Configure — Claude Desktop
Add to claude_desktop_config.json:
Configure — Cursor / Windsurf
Add to .cursor/mcp.json or ~/.codeium/windsurf/mcp_config.json:
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
Source: README.md at commit 63e2908
Tools
0Version history
1- v1.0.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts