@runestone-labs/tarot-mcp

@runestone-labs/tarot-mcp

MCP server for Runestone Tarot. Exposes tarot readings as MCP tools so Claude Desktop, Cursor, Continue, Cline, Goose, and any other MCP-aware client can draw readings on behalf of their users.

Registry name: io.github.runestone-labs/tarot-mcp

Public docs:

• MCP landing page: https://www.runestonetarot.com/mcp
• Public AI API: https://www.runestonetarot.com/openapi.json
• LLM context file: https://www.runestonetarot.com/llms.txt

Install

npm install -g @runestone-labs/tarot-mcp

Or run directly with npx:

npx -y @runestone-labs/tarot-mcp

Configure

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "runestone-tarot": {
      "command": "npx",
      "args": ["-y", "@runestone-labs/tarot-mcp"]
    }
  }
}

Restart Claude Desktop. The tools (draw_reading, list_cards, list_spreads) appear in the tool picker.

Cursor / Continue / other MCP clients

Use the same command: "npx" + args: ["-y", "@runestone-labs/tarot-mcp"] pattern in whatever config file your client uses.

JSON config

{
  "mcpServers": {
    "runestone-tarot": {
      "command": "npx",
      "args": ["-y", "@runestone-labs/tarot-mcp"]
    }
  }
}

Tools

Tool	Purpose
draw_reading	Draw cards for a spread and return the interpretation + deeplink
list_cards	Full 78-card catalog with upright + reversed meanings
list_spreads	Available spread layouts (single, three-card, etc.)

draw_reading accepts an optional question, a spread (single, three-card, situation-action-outcome, celtic-cross), and an optional caller-supplied cards array for reproducible draws. When cards is omitted, the server draws fresh.

The response always includes a deeplink URL — surface it to your user as a clickable link so they can view the reading rendered visually on runestonetarot.com.

Discovery

This package includes a server.json manifest for the official MCP Registry. The package metadata also includes mcpName so the registry can verify that the npm package matches the published server metadata.

Useful discovery terms: MCP tarot server, AI tarot reading, tarot card meanings, Claude Desktop tarot, Cursor MCP tarot, Custom GPT tarot API.

Development

The server is a thin wrapper over https://www.runestonetarot.com/api/v1/*. To point at a local dev server while iterating:

RUNESTONE_TAROT_API=http://localhost:3000 npx tsx src/index.ts

npm install
npm run build
npm start

License

MIT