I Ching Hexagram MCP

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Public, read-only MCP over the complete 64-hexagram I Ching corpus. Deterministic lookup only.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "I Ching Hexagram MCP": {
      "url": "https://mcp.iching.rocks/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• search_hexagrams read-only

  Deterministic literal/keyword search over a closed whitelist of hexagram text fields (not semantic). Case-, diacritic-, and traditional/simplified Chinese-insensitive. Optional fields, order, and limit (default 10, max 64). Texts are an original IChing.Rocks translation; vocabulary from classic English translations (Wilhelm/Baynes, Legge, Blofeld) may not match literally. Data © IChing.Rocks — attribution is a condition of the license terms: https://iching.rocks/mcp-terms.

  Parameters:

  • query (required) — string — Literal text to match (max 200 chars). Case-, diacritic-, and traditional/simplified Chinese-insensitive.
  • limit — ['integer', 'null'] — Max results, 1-64. Default 10.
  • order — ['string', 'null'] — Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen.
  • fields — ['array', 'null'] — Whitelisted field paths to search; defaults to the documented default set.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

• get_hexagrams read-only

  Batch hexagram lookup by King Wen numbers (max 16 ids per call). Optional include level: summary, core (default), lines, full. Data © IChing.Rocks — attribution is a condition of the license terms: https://iching.rocks/mcp-terms.

  Parameters:

  • ids (required) — array — Hexagram numbers, 1-64 (King Wen), no duplicates, max 16 per call.
  • include — ['string', 'null'] — Detail level, each nesting the previous: summary = identity, essence, url; core (default) = adds trigrams, judgment, image; lines = adds the six line texts; full = adds symbolic meaning and final comment.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

• list_hexagrams read-only

  Compact index of all 64 I Ching hexagrams (id, name, pinyin, characters, essence, trigrams, url). Optional order: kingwen (default), mawangdui, eightpalaces, binary. This is the summary index only; get_hexagram (or get_hexagrams) returns full detail for a known number, get_all_hexagrams returns the full dataset in one call, and search_hexagrams finds hexagrams by text. Data © IChing.Rocks — attribution is a condition of the license terms: https://iching.rocks/mcp-terms.

  Parameters:

  • order — ['string', 'null'] — Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

• get_server_info read-only

  Build identity of the running iching.rocks MCP server: name, semantic version, git revision, protocol, and canonical MCP endpoint. Identity only — returns no hexagram data.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

• get_reading_context read-only

  Deterministic reading context for a primary hexagram (1-64) and 0-6 ascending changing lines. Empty changing_lines returns the primary hexagram only; one or more changing lines add the resulting hexagram, the transition, and the changing-line texts. No divination is performed. Data © IChing.Rocks — attribution is a condition of the license terms: https://iching.rocks/mcp-terms.

  Parameters:

  • primary_id (required) — integer — Primary hexagram number, 1-64 (King Wen).
  • changing_lines (required) — array — Changing line numbers (1-6), strictly ascending, no duplicates. Empty for an unchanging reading.
  • include — ['string', 'null'] — Detail level, each nesting the previous: summary = identity, essence, url; core (default) = adds trigrams, judgment, image; lines = adds the six line texts; full = adds symbolic meaning and final comment.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

• get_trigram read-only

  One of the eight trigrams by exactly one identifier: binary (e.g. 010), english (e.g. Fire), chinese (pinyin, e.g. Li), symbolic (e.g. Radiance), or element (Chinese character, e.g. 火). This returns a single trigram; list_trigrams returns all eight. Data © IChing.Rocks — attribution is a condition of the license terms: https://iching.rocks/mcp-terms.

  Parameters:

  • binary — ['string', 'null'] — Three-bit trigram binary, e.g. 010 (canonical identifier).
  • chinese — ['string', 'null'] — Pinyin romanization, e.g. Li. (This field holds pinyin; the Chinese character lives in element.)
  • element — ['string', 'null'] — Chinese element character, e.g. 火.
  • english — ['string', 'null'] — English name, e.g. Fire.
  • symbolic — ['string', 'null'] — Symbolic name, e.g. Radiance.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

• get_all_hexagrams read-only

  The full 64-hexagram dataset in one call (bulk; stricter rate limit). Optional order: kingwen (default), mawangdui, eightpalaces, binary. Data © IChing.Rocks — attribution is a condition of the license terms: https://iching.rocks/mcp-terms.

  Parameters:

  • order — ['string', 'null'] — Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

• list_trigrams read-only

  All eight trigrams with font, binary, pinyin, symbolic name, english name, element character, and function. Data © IChing.Rocks — attribution is a condition of the license terms: https://iching.rocks/mcp-terms.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

• get_hexagram read-only

  One hexagram by King Wen number (1-64). Optional include level: summary, core (default), lines, full. Sibling tools cover the other cases: get_hexagrams for several numbers at once, get_all_hexagrams for the entire set, search_hexagrams to find hexagrams by text, and get_reading_context for a changing-line reading. Data © IChing.Rocks — attribution is a condition of the license terms: https://iching.rocks/mcp-terms.

  Parameters:

  • id (required) — integer — Hexagram number, 1-64 (King Wen).
  • include — ['string', 'null'] — Detail level, each nesting the previous: summary = identity, essence, url; core (default) = adds trigrams, judgment, image; lines = adds the six line texts; full = adds symbolic meaning and final comment.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

• list_sequences read-only

  Describes the four canonical hexagram orderings (kingwen, mawangdui, eightpalaces, binary) with their 64-entry sequences. Data © IChing.Rocks — attribution is a condition of the license terms: https://iching.rocks/mcp-terms.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.