Public, read-only MCP over the complete 64-hexagram I Ching corpus. Deterministic lookup only.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen.
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.
| Argument | Type | Description |
|---|---|---|
| order | string | null | Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen. |
{
"type": "object",
"properties": {
"order": {
"type": [
"string",
"null"
],
"default": null,
"description": "Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| id* | 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. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"description": "Hexagram number, 1-64 (King Wen)."
},
"include": {
"type": [
"string",
"null"
],
"default": "core",
"description": "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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| ids* | 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. |
{
"type": "object",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Hexagram numbers, 1-64 (King Wen), no duplicates, max 16 per call."
},
"include": {
"type": [
"string",
"null"
],
"default": "core",
"description": "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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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. |
| primary_id* | integer | Primary hexagram number, 1-64 (King Wen). |
| changing_lines* | array | Changing line numbers (1-6), strictly ascending, no duplicates. Empty for an unchanging reading. |
{
"type": "object",
"required": [
"primary_id",
"changing_lines"
],
"properties": {
"include": {
"type": [
"string",
"null"
],
"default": "core",
"description": "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."
},
"primary_id": {
"type": "integer",
"description": "Primary hexagram number, 1-64 (King Wen)."
},
"changing_lines": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Changing line numbers (1-6), strictly ascending, no duplicates. Empty for an unchanging reading."
}
}
}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.
No arguments.
{
"type": "object",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| 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. |
{
"type": "object",
"properties": {
"binary": {
"type": [
"string",
"null"
],
"default": null,
"description": "Three-bit trigram binary, e.g. 010 (canonical identifier)."
},
"chinese": {
"type": [
"string",
"null"
],
"default": null,
"description": "Pinyin romanization, e.g. Li. (This field holds pinyin; the Chinese character lives in element.)"
},
"element": {
"type": [
"string",
"null"
],
"default": null,
"description": "Chinese element character, e.g. 火."
},
"english": {
"type": [
"string",
"null"
],
"default": null,
"description": "English name, e.g. Fire."
},
"symbolic": {
"type": [
"string",
"null"
],
"default": null,
"description": "Symbolic name, e.g. Radiance."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| order | string | null | Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen. |
{
"type": "object",
"properties": {
"order": {
"type": [
"string",
"null"
],
"default": null,
"description": "Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen."
}
}
}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.
No arguments.
{
"type": "object",
"properties": {}
}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.
No arguments.
{
"type": "object",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Max results, 1-64. Default 10. |
| order | string | null | Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen. |
| query* | string | Literal text to match (max 200 chars). Case-, diacritic-, and traditional/simplified Chinese-insensitive. |
| fields | array | null | Whitelisted field paths to search; defaults to the documented default set. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Max results, 1-64. Default 10."
},
"order": {
"type": [
"string",
"null"
],
"default": null,
"description": "Ordering: kingwen | mawangdui | eightpalaces | binary. Default kingwen."
},
"query": {
"type": "string",
"description": "Literal text to match (max 200 chars). Case-, diacritic-, and traditional/simplified Chinese-insensitive."
},
"fields": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"default": null,
"description": "Whitelisted field paths to search; defaults to the documented default set."
}
}
}