{
  "markdown": "# Tarot MCP Server\n\n[![npm](https://img.shields.io/npm/v/@deckaura/tarot-mcp-server)](https://www.npmjs.com/package/@deckaura/tarot-mcp-server)\n[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)\n[![Smithery](https://img.shields.io/badge/Smithery-gokimedia%2Ftarot-6c47ff)](https://smithery.ai/servers/gokimedia/tarot)\n[![LobeHub](https://img.shields.io/badge/LobeHub-gokimedia--tarot--mcp--server-8b5cf6)](https://lobehub.com/mcp/gokimedia-tarot-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nA [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).\n\n**Powered by [Deckaura](https://deckaura.com)** — all card interpretations link back to full guides on deckaura.com.\n\n## Features\n\n- `get_card_meaning` — Upright, reversed, love, career, yes/no interpretations for any of the 78 cards\n- `draw_random_card` — Single card draw with optional reversals\n- `three_card_spread` — Past / Present / Future reading\n- `yes_no_reading` — Binary verdict for specific questions\n- `list_all_cards` — Full deck listing\n- Resources: `tarot://deck/full` (full JSON dataset), `tarot://deckaura/home`\n\n## Install\n\n```bash\nnpm install -g @deckaura/tarot-mcp-server\n```\n\nOr run ad-hoc via npx:\n\n```bash\nnpx @deckaura/tarot-mcp-server\n```\n\n## Desktop extension bundle (MCPB)\n\nBuild a self-contained MCPB bundle for compatible desktop clients and stdio registries such as Smithery:\n\n```bash\nnpm ci\nnpm run pack:mcpb\n```\n\nThe 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).\n\n## Configure — Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"tarot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@deckaura/tarot-mcp-server\"]\n    }\n  }\n}\n```\n\n## Configure — Cursor / Windsurf\n\nAdd to `.cursor/mcp.json` or `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"tarot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@deckaura/tarot-mcp-server\"]\n    }\n  }\n}\n```\n\n## Example Usage\n\nOnce configured, ask your AI assistant:\n\n- *\"Draw me a three-card tarot spread about my new project\"*\n- *\"What does The Fool mean reversed?\"*\n- *\"Yes or no: should I take the job?\"*\n\n## Data Source\n\nAll 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.\n\n## Free Online Tools\n\nIf you prefer a web-based experience, Deckaura offers free tools:\n\n- [Daily Tarot Card](https://deckaura.com/pages/daily-tarot-card)\n- [Random Tarot Card Generator](https://deckaura.com/pages/random-tarot-card)\n- [Tarot Birth Card Calculator](https://deckaura.com/pages/tarot-birth-card-calculator)\n- [Full Tarot Reading](https://deckaura.com/pages/tarot-reading)\n- [78 Card Meanings Database](https://deckaura.com/blogs/guide/tarot-card-meanings)\n\n## License\n\nMIT © [Deckaura](https://deckaura.com)\n\n## Links\n\n- **Open Data & AI hub:** https://deckaura.com/pages/ai-data-sources\n- **Website:** https://deckaura.com\n- **npm:** https://www.npmjs.com/package/@deckaura/tarot-mcp-server\n- **MCPB releases:** https://github.com/gokimedia/tarot-mcp-server/releases\n- **Official MCP Registry search:** https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.gokimedia%2Ftarot-mcp-server\n- **Smithery:** https://smithery.ai/servers/gokimedia/tarot\n- **LobeHub Marketplace:** https://lobehub.com/mcp/gokimedia-tarot-mcp-server\n- **Glama:** https://glama.ai/mcp/servers/gokimedia/tarot-mcp-server\n- **MCP Servers:** https://mcpservers.org/servers/gokimedia/tarot-mcp-server\n- **Live dataset explorer:** https://gokimedia.github.io/tarot-dataset-explorer/\n- **Developer documentation:** https://gokimedia.github.io/deckaura-developer-docs/\n- **Hugging Face dataset:** https://huggingface.co/datasets/Blacik/deckaura-tarot-card-meanings\n- **Permanent dataset DOI:** https://doi.org/10.5281/zenodo.19475329\n- **Issues:** https://github.com/gokimedia/tarot-mcp-server/issues\n",
  "bytes": 4428,
  "sha": "37a18dd966b835b67622a7d4ccae643081dc4f006861e7c5d5331ef733065696",
  "repo_slug": "gokimedia/tarot-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gokimedia_tarot_mcp_server_1dc51bfa/readme"
}