Skip to content

I Ching MCP Server by RoxyAPI

by roxyapi.com · remote · no sign-in to list tools · v1.0.1 · published by com.roxyapi

I Ching hexagram casts, 64 hexagram meanings and changing lines for AI agents.

Changes · 3

9 tools: 3 change things and 6 only read.

Scanned Oct 21, 2026

3 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http iching https://roxyapi.com/mcp/iching --header 'X-API-Key: <your-x-api-key>'

Findings

Matches of fixed checks, with the text they matched.

3 warn
  • The server marks "post_iching_daily" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_iching_daily" says "post": a word for a change.

    What this check looks for
  • The server marks "post_iching_daily_cast" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_iching_daily_cast" says "post": a word for a change.

    What this check looks for
  • The server marks "get_iching_cast" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "get_iching_cast" says "get": a word for reading.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

9 tools

Changes things 3Claude Code: ask
  • get_iching_castGenerate an authentic I-Ching reading using the traditional three-coin casting method.1 finding

    Why it is in this group

    • The name "get_iching_cast" says "get": a word for reading.
    • The description's first verb is "generate": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "get_iching_cast" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "get_iching_cast" says "get": a word for reading.

      What this check looks for
    Description, as the server wrote it
    Generate an authentic I-Ching reading using the traditional three-coin casting method. Each of the six lines is determined by virtually tossing three coins, producing values 6-9 where 6 (old yin) and 9 (old yang) are changing lines. Returns the primary hexagram with full interpretation, the line values showing which lines are changing, and if any lines change, the resulting hexagram that the primary transforms into. Optionally provide a seed for reproducible castings. Perfect for divination apps, oracle features, and decision-making tools.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • post_iching_dailyReceive a daily I-Ching hexagram for guidance and reflection.1 finding

    Why it is in this group

    • The name "post_iching_daily" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "post_iching_daily" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_iching_daily" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Receive a daily I-Ching hexagram for guidance and reflection. This endpoint uses seeded randomness to ensure the same seed gets the same hexagram on the same day, perfect for "Hexagram of the Day" features in oracle apps, meditation platforms, and daily wisdom tools. Returns the hexagram with judgment, image, and interpretations for love, career, decisions, and practical advice based on ancient Chinese wisdom from the Book of Changes.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • post_iching_daily_castCast a complete daily I-Ching reading using the traditional three-coin method with seeded randomness.1 finding

    Why it is in this group

    • The name "post_iching_daily_cast" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "post_iching_daily_cast" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_iching_daily_cast" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Cast a complete daily I-Ching reading using the traditional three-coin method with seeded randomness. Unlike the simple daily hexagram, this provides the full casting experience with line values (6-9), changing line positions, and the resulting hexagram if transformation occurs. Same seed + same date = same casting result. Perfect for I-Ching divination apps requiring authentic oracle experience with daily consistency.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
Only reads 6Claude Code: allow
  • get_iching_hexagramsBrowse all 64 I-Ching hexagrams from the Book of Changes with their Chinese names, English translations, and trigram compositions.No findings

    Why it is in this group

    • The name "get_iching_hexagrams" says "get": a word for reading.
    Description, as the server wrote it
    Browse all 64 I-Ching hexagrams from the Book of Changes with their Chinese names, English translations, and trigram compositions. The hexagrams are ordered by the traditional King Wen sequence used in I-Ching divination for 3,000 years. Each hexagram represents a unique life situation combining two trigrams (Heaven, Earth, Thunder, Wind, Water, Fire, Mountain, Lake) into profound wisdom for decision-making and self-understanding.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_iching_hexagrams_lookupFind an I-Ching hexagram by its binary line pattern.No findings

    Why it is in this group

    • The name "get_iching_hexagrams_lookup" says "get": a word for reading.
    Description, as the server wrote it
    Find an I-Ching hexagram by its binary line pattern. Provide 6 digits (0 or 1) representing broken (yin) and solid (yang) lines from bottom to top. Use this for custom divination interfaces where users input their own line configurations, or to find hexagrams matching specific trigram combinations. Example: "111111" returns Hexagram 1 (The Creative), "000000" returns Hexagram 2 (The Receptive).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_iching_hexagrams_numberRetrieve complete I-Ching hexagram details by King Wen sequence number (1-64).No findings

    Why it is in this group

    • The name "get_iching_hexagrams_number" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve complete I-Ching hexagram details by King Wen sequence number (1-64). Returns the full hexagram with Chinese name, English translation, judgment text, image text, modern interpretations for general situations, love, career, and decision-making, plus all six changing line meanings. Use this to display detailed hexagram information after casting or for educational reference.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_iching_hexagrams_randomReceive a random I-Ching hexagram with full interpretation.No findings

    Why it is in this group

    • The name "get_iching_hexagrams_random" says "get": a word for reading.
    Description, as the server wrote it
    Receive a random I-Ching hexagram with full interpretation. Perfect for daily oracle features, meditation prompts, or exploring the Book of Changes. Returns complete hexagram data including judgment, image, interpretations for love/career/decisions, and all six changing line meanings.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_iching_trigramsRetrieve all 8 I-Ching trigrams (bagua), the fundamental building blocks of hexagrams.No findings

    Why it is in this group

    • The name "get_iching_trigrams" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve all 8 I-Ching trigrams (bagua), the fundamental building blocks of hexagrams. Each trigram consists of three lines and represents a primal force of nature: Heaven (Qian), Earth (Kun), Thunder (Zhen), Wind (Xun), Water (Kan), Fire (Li), Mountain (Gen), and Lake (Dui). Understanding trigrams is essential for interpreting hexagram meanings, as each hexagram combines an upper and lower trigram.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_iching_trigrams_idRetrieve a specific I-Ching trigram by its number (1-8) or English name (Heaven, Earth, Thunder, Wind, Water, Fire, Mountain, Lake).No findings

    Why it is in this group

    • The name "get_iching_trigrams_id" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve a specific I-Ching trigram by its number (1-8) or English name (Heaven, Earth, Thunder, Wind, Water, Fire, Mountain, Lake). Returns complete trigram information including Chinese name, pinyin, element associations, core attributes, and symbolic meaning. Use this to understand the component trigrams of any hexagram.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http iching https://roxyapi.com/mcp/iching --header 'X-API-Key: <your-x-api-key>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__iching__get_iching_hexagrams",
      "mcp__iching__get_iching_hexagrams_random",
      "mcp__iching__get_iching_hexagrams_lookup",
      "mcp__iching__get_iching_hexagrams_number",
      "mcp__iching__get_iching_trigrams",
      "mcp__iching__get_iching_trigrams_id"
    ],
    "ask": [
      "mcp__iching__post_iching_daily",
      "mcp__iching__post_iching_daily_cast",
      "mcp__iching__get_iching_cast"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as iching. Review it before you use it.