I Ching

liveReference

i-ching — cast the I Ching with coins or yarrow stalks, and look up any of the 64 hexagrams (King Wen sequence).

3tools
0msauth
free tier50 calls/day

Tools

cast_i_ching

Cast an I Ching hexagram using the traditional three-coin method (default) or the classical yarrow-stalk method, per James Legge's 1899 translation.

No parameters required.

▶Try it
get_hexagram

Look up one of the 64 I Ching hexagrams (King Wen sequence) by its number (1-64) or by name (Chinese, pinyin, or the English gloss used in this pack).

No parameters required.

▶Try it
search_hexagrams

Search the 64 I Ching hexagrams (King Wen sequence) by a free-text query matched against name (Chinese, pinyin, English gloss) and keywords.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/i-ching/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/i-ching/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"cast_i_ching","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("cast_i_ching", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("i-ching — cast the i ching with coins or yarrow stalks, and look up any of the 64 hexagrams (king wen sequence)");