Deckaura Tarot
Explore 78 tarot cards with meanings, card draws, spreads, and Deckaura guide links.
Open source Open in the app JSON README (API)
About
Explore 78 tarot cards with meanings, card draws, spreads, and Deckaura guide links.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- gokimedia
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Stars
- 2
- Forks
- 2
- Last push
- 2026-08-27T16:49:05Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:51
- Updated
- 2026-08-29 03:02:51
- Origin id
io.github.gokimedia/tarot-mcp-server
README
# Tarot MCP Server
[](https://www.npmjs.com/package/@deckaura/tarot-mcp-server)
[](https://modelcontextprotocol.io)
[](https://smithery.ai/servers/gokimedia/tarot)
[](https://lobehub.com/mcp/gokimedia-tarot-mcp-server)
[](LICENSE)
A [Model Context Protocol](https://modelcontextprotocol.io) 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](https://deckaura.com)** — 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](https://github.com/gokimedia/tarot-mcp-server/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](https://deckaura.com/blogs/guide/tarot-card-meanings), 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](https://deckaura.com/pages/daily-tarot-card)
- [Random Tarot Card Generator](https://deckaura.com/pages/random-tarot-card)
- [Tarot Birth Card Calculator](https://deckaura.com/pages/tarot-birth-card-calculator)
- [Full Tarot Reading](https://deckaura.com/pages/tarot-reading)
- [78 Card Meanings Database](https://deckaura.com/blogs/guide/tarot-card-meanings)
## License
MIT © [Deckaura](https://deckaura.com)
## 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