@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.

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.

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.

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