I Ching Hexagram MCP

rocks.ichingPublished by iching.rocksOfficial publisherv1.12.35Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

A remote, read-only MCP server that gives an assistant deterministic lookup over the 64 I Ching hexagrams, trigrams and reading contexts.

What you can do
Search hexagrams by literal keyword across whitelisted text fields, with optional field, order and limit filters, and list the compact index of all 64 hexagrams in four canonical orderings or describe those orderings themselves. Fetch one hexagram, a batch of up to 16, or the full 64-hexagram dataset, each with optional detail levels from summary to full. Build a reading context from a primary hexagram and zero to six changing lines, returning the resulting hexagram and transition texts without performing divination. Look up individual trigrams by binary, English, pinyin, symbolic or element identifier, or list all eight with their attributes. Report the server's build identity and version.
When to use it
Useful when an assistant needs accurate, citable I Ching text — hexagram names, characters, trigrams, line texts and changing-line transitions — for study, reference or interpretation, rather than free-form generation. Also handy for browsing the corpus in different traditional orderings.
Requirements
A remote streamable HTTP endpoint; no package, runtime, account, API key or header is declared. Network access to the endpoint is needed, and the bulk full-dataset call is subject to a stricter rate limit.
Before you install
Read-only and deterministic; no divination is performed, so results are reference text only. The data is licensed by IChing.Rocks and attribution is stated as a condition of the license terms, so check those terms before republishing content.

Installation

In SourceWeft

  1. Open I Ching Hexagram MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/rocks.iching%2Fhexagram-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "i-ching-hexagram": {
      "type": "http",
      "url": "https://mcp.iching.rocks/mcp"
    }
  }
}

Tools

10

search_hexagrams

Search Hexagrams

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.

Parameterslimitorderqueryrequiredfields

get_hexagrams

Get Hexagrams (Batch)

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.

Parametersidsrequiredinclude

list_hexagrams

List Hexagrams

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.

Parametersorder

get_server_info

Get Server Info

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.

Takes no parameters.

get_reading_context

Get Reading Context

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.

Parametersincludeprimary_idrequiredchanging_linesrequired

get_trigram

Get Trigram

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.

Parametersbinarychineseelementenglishsymbolic

get_all_hexagrams

Get All Hexagrams

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.

Parametersorder

list_trigrams

List Trigrams

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.

Takes no parameters.

get_hexagram

Get Hexagram

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.

Parametersidrequiredinclude

list_sequences

List Sequences

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.

Takes no parameters.

Version history

1
  1. v1.12.35LatestSep 16, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.