Nyan Parlor MCP

Provides real random tarot draws, I Ching casting, and BaZi charts to AI assistants like ChatGPT and Claude. It uses cryptographic randomness for cards and an astronomical engine for charts, allowing agents to perform readings without hallucinating card selections or miscalculating astrological data.

Visit Nyan Parlor

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Community listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by Nyan Parlor

MCP endpoint (Streamable HTTP)

https://www.tarotoper.com/mcp

Vendor documentation

What you can do with it

Draw three tarot cards for a specific question
Show a BaZi chart based on birth details
Cast an I Ching hexagram about a decision
Perform a Celtic Cross tarot spread

Source and maintenance

Community listingRegistry 0.2.0

mcp-registry: io.github.nyan-parlor/nyan-parlor-mcp@0.2.0 Source repository Project website

Maintenance checked: Nov 1, 2026, 8:44 AM UTC

Protocol and capabilities

Server: nyan-parlor 0.2.0
MCP protocol: 2025-06-18
Tools: 6 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Tools for tarot, I Ching, BaZi (Four Pillars) and the Chinese zodiac from Nyan Parlor (tarotoper.com). Always draw cards with draw_tarot_cards and cast hexagrams with cast_i_ching instead of inventing them, then look up meanings with get_tarot_card_meaning / get_hexagram. When reading, answer the user's question first, then explain how each card or line supports it. Include the page links the tools return so the user can read more. When the user writes in Japanese, pass language: "ja" so names, meanings and links come back in Japanese, and answer in Japanese.

Tools

6 advertised

draw_tarot_cards — Draw tarot cards

Advertised by the server during the last successful anonymous check.

Draw tarot cards at random from a full 78-card Rider–Waite–Smith deck (cryptographically random, no repeats). Returns each card with its position, upright/reversed orientation, keywords and a link to its full meaning. Use this instead of inventing cards when a user asks for a tarot reading.

draw_tarot_cards input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "count": {
      "type": "integer",
      "default": 3,
      "maximum": 10,
      "minimum": 1,
      "description": "How many cards to draw (1–10). 1 = single card / yes-no, 3 = past-present-future."
    },
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "question": {
      "type": "string",
      "maxLength": 500,
      "description": "The question being asked (echoed back only; not stored)."
    },
    "positions": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 10,
      "description": "Optional position names in order, e.g. [\"Past\", \"Present\", \"Future\"]."
    },
    "allow_reversed": {
      "type": "boolean",
      "default": true,
      "description": "Whether cards can come up reversed."
    }
  },
  "additionalProperties": false
}

get_tarot_card_meaning — Tarot card meaning

Advertised by the server during the last successful anonymous check.

Look up the meaning of a tarot card: keywords, upright and reversed meaning, love, feelings, career and money readings, and whether it leans yes or no. Accepts names like "The Tower", "3 of Cups", "Queen of Swords" or "ace of coins".

get_tarot_card_meaning input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "card"
  ],
  "properties": {
    "card": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Card name, e.g. \"The Moon\", \"Five of Wands\", 「月」 or 「ワンドの5」."
    },
    "topic": {
      "enum": [
        "general",
        "love",
        "feelings",
        "career",
        "money",
        "all"
      ],
      "type": "string",
      "default": "all",
      "description": "Which aspect to return."
    },
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "orientation": {
      "enum": [
        "upright",
        "reversed",
        "both"
      ],
      "type": "string",
      "default": "both"
    }
  },
  "additionalProperties": false
}

cast_i_ching — Cast an I Ching hexagram

Advertised by the server during the last successful anonymous check.

Cast an I Ching reading with the traditional three-coin method (six tosses, bottom line first). Returns the primary hexagram, any changing lines and the relating (transformed) hexagram, with links to each hexagram's meaning. Use this instead of making up a hexagram.

cast_i_ching input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "question": {
      "type": "string",
      "maxLength": 500,
      "description": "The question being asked (echoed back only; not stored)."
    }
  },
  "additionalProperties": false
}

get_hexagram — I Ching hexagram meaning

Advertised by the server during the last successful anonymous check.

Look up one of the 64 I Ching hexagrams by number (1–64), English name ("The Wanderer"), Chinese character (旅), Japanese name (火山旅) or pinyin (ambiguous pinyin like "lu" returns the candidates). Returns its essence, judgment, image, love and career readings, guidance and the six line texts.

get_hexagram input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "hexagram"
  ],
  "properties": {
    "lines": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 6,
        "minimum": 1
      },
      "maxItems": 6,
      "description": "Changing line numbers to highlight (1 = bottom)."
    },
    "hexagram": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "Number 1–64, English name, Japanese name or pinyin."
    },
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    }
  },
  "additionalProperties": false
}

bazi_chart — BaZi (Four Pillars) chart

Advertised by the server during the last successful anonymous check.

Calculate a BaZi / Four Pillars of Destiny chart from a birth date, optional birth time and the birthplace time zone. Uses solar-term boundaries (the year changes at the Start of Spring, Li Chun) via an astronomical calendar engine. Returns the four pillars with Ten Gods, the Day Master, five-element balance, luck pillars and the coming years.

bazi_chart input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "birth_date",
    "timezone"
  ],
  "properties": {
    "gender": {
      "enum": [
        "male",
        "female"
      ],
      "type": "string",
      "description": "Needed only for the direction of the luck pillars."
    },
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "minLength": 3,
      "description": "IANA time zone of the birthplace, e.g. \"America/New_York\" or \"Asia/Shanghai\"."
    },
    "birth_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Gregorian birth date, YYYY-MM-DD (local date at the birthplace)."
    },
    "birth_time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}$",
      "description": "Local clock time HH:mm. Omit if unknown (gives a three-pillar chart)."
    }
  },
  "additionalProperties": false
}

chinese_zodiac — Chinese zodiac sign and 2027 forecast

Advertised by the server during the last successful anonymous check.

Find a person's Chinese zodiac animal from a birth year or date (handles the Lunar New Year and Start of Spring boundaries for January–February births) and return the 2027 Year of the Fire Goat forecast for that sign: love, career, money and a tip.

chinese_zodiac input schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "birth_date"
  ],
  "properties": {
    "language": {
      "enum": [
        "en",
        "ja"
      ],
      "type": "string",
      "default": "en",
      "description": "Output language. Use \"ja\" when the user writes in Japanese: Japanese card / hexagram names, meanings and links to the Japanese pages. Otherwise \"en\"."
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "minLength": 3,
      "description": "IANA time zone of the birthplace (e.g. \"America/New_York\"). Only matters for births near the Start of Spring in early February."
    },
    "birth_date": {
      "type": "string",
      "pattern": "^\\d{4}(-\\d{2}-\\d{2})?$",
      "description": "Birth year (YYYY) or full date (YYYY-MM-DD). A full date is needed to be exact for January–February births."
    }
  },
  "additionalProperties": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 654 ms
95th percentile latency: 654 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 9:16 AM UTC · probe · passed · 654 ms · metadata changed · 6 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http nyan-parlor-mcp https://www.tarotoper.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add nyan-parlor-mcp --url https://www.tarotoper.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable nyan-parlor-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "nyan-parlor-mcp": {
      "url": "https://www.tarotoper.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "nyan-parlor-mcp": {
      "type": "streamableHttp",
      "url": "https://www.tarotoper.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start nyan-parlor-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "nyan-parlor-mcp": {
      "type": "http",
      "url": "https://www.tarotoper.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http nyan-parlor-mcp https://www.tarotoper.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "nyan-parlor-mcp": {
      "url": "https://www.tarotoper.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "nyan-parlor-mcp": {
      "serverUrl": "https://www.tarotoper.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Nyan Parlor MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows