Yarrow

Working · 3.7 s

io.github.shaozhengkun123/yarrowv0.1.0

I-Ching (周易) oracle: cast a hexagram, read classical commentary, get a reflection. Bilingual.

Entertainment & Games

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://yarrow-oracle.shaozhengkun.workers.dev/mcp

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.

cast_hexagram

Cast a hexagram for an I-Ching consultation. Returns the primary hexagram, the six lines (6=old yin, 7=young yang, 8=young yin, 9=old yang from bottom to top), any moving lines, and the changing hexagram if there are moving lines. Pass `seed` to make the cast deterministic (useful for testing or for reproducing a reading).

seedstring

Optional seed for deterministic casting.

methodstring

coins = three-coin toss (most common); yarrow = traditional 50-stalk probabilities; random = uniformly pick one of the 64 hexagrams with no moving lines.

questionstring

The question being asked (not used for casting, returned in result for context).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (7)

cast_hexagram

Argument	Type	Description
seed	string \| number	Optional seed for deterministic casting.
method	string	coins = three-coin toss (most common); yarrow = traditional 50-stalk probabilities; random = uniformly pick one of the 64 hexagrams with no moving lines.
question	string	The question being asked (not used for casting, returned in result for context).

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Optional seed for deterministic casting."
    },
    "method": {
      "enum": [
        "coins",
        "yarrow",
        "random"
      ],
      "type": "string",
      "default": "coins",
      "description": "coins = three-coin toss (most common); yarrow = traditional 50-stalk probabilities; random = uniformly pick one of the 64 hexagrams with no moving lines."
    },
    "question": {
      "type": "string",
      "description": "The question being asked (not used for casting, returned in result for context)."
    }
  }
}

cast_tarot

Draw one upright Major Arcana card for reflection. Uses a deterministic one-card Waite-Smith Major Arcana method and returns a selected source excerpt from Arthur Edward Waite's public-domain 1910/1922 text. Pass `seed` to reproduce the same draw.

Argument	Type	Description
seed	string \| number	Optional deterministic draw seed.
question	string	The question being reflected on (not used to influence the draw).

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Optional deterministic draw seed."
    },
    "question": {
      "type": "string",
      "description": "The question being reflected on (not used to influence the draw)."
    }
  }
}

divine

Ask the I Ching. See your next step. Cast a hexagram, show the classical sources first, then offer a thoughtful reflection grounded in those sources. Sources first. Reflection, not prediction. The divine name remains stable for oracle/divination client compatibility. Supports English, Chinese, Japanese, Korean, Spanish, French, German, Portuguese, Italian, Russian, Arabic, Hindi, Indonesian, and English+Chinese bilingual output. Daily quota: 30 completed readings per device_id (or per anonymous IP if no device_id is supplied); timeout, provider failure, incomplete response, and cancellation do not consume it.

Argument	Type	Description
seed	string \| number	Deterministic cast seed.
locale	string
method	string
question*	string	The question to consult on.
device_id	string	Optional opaque identifier for quota tracking. If omitted, IP-derived.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "question"
  ],
  "properties": {
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Deterministic cast seed."
    },
    "locale": {
      "enum": [
        "en",
        "zh",
        "zh-Hant",
        "ja",
        "ko",
        "es",
        "fr",
        "de",
        "pt",
        "it",
        "ru",
        "ar",
        "hi",
        "id",
        "bilingual"
      ],
      "type": "string",
      "default": "en"
    },
    "method": {
      "enum": [
        "coins",
        "yarrow",
        "random"
      ],
      "type": "string",
      "default": "coins"
    },
    "question": {
      "type": "string",
      "description": "The question to consult on."
    },
    "device_id": {
      "type": "string",
      "description": "Optional opaque identifier for quota tracking. If omitted, IP-derived."
    }
  }
}

lookup_hexagram

Return the full classical sources for a hexagram by its number (1–64): judgment (卦辞), image (大象), Tuan commentary, Zhu Xi 周易本义, Yang Tian Cai modern explanation, Yarrow's separately labelled Chinese reading aid, and historical anecdote — with available Chinese and English source material.

Argument	Type	Description
locale	string
number*	integer	Hexagram number 1-64 in King Wen sequence.
compact	boolean	If true, omit authorities (long classical commentary). Returns only structural fields.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "number"
  ],
  "properties": {
    "locale": {
      "enum": [
        "en",
        "zh",
        "both"
      ],
      "type": "string",
      "default": "both"
    },
    "number": {
      "type": "integer",
      "maximum": 64,
      "minimum": 1,
      "description": "Hexagram number 1-64 in King Wen sequence."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "If true, omit authorities (long classical commentary). Returns only structural fields."
    }
  }
}

lookup_yilin

Look up the 焦氏易林 verse for a primary hexagram changing into another hexagram. This is a local classical-source lookup, not an AI reading.

Argument	Type	Description
primary_number*	integer	Primary hexagram number 1-64.
changing_number*	integer	Changing hexagram number 1-64.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "primary_number",
    "changing_number"
  ],
  "properties": {
    "primary_number": {
      "type": "integer",
      "maximum": 64,
      "minimum": 1,
      "description": "Primary hexagram number 1-64."
    },
    "changing_number": {
      "type": "integer",
      "maximum": 64,
      "minimum": 1,
      "description": "Changing hexagram number 1-64."
    }
  }
}

tarot_reading

Ask one real question through a single upright Waite-Smith Major Arcana card. Returns a direct calibrated answer first, the named card and bound Arthur Edward Waite 1910 source excerpt, a practical reality check, and one observable next step. No reversals, astrology, redraw loop, or guaranteed prediction. Daily quota is shared with completed divine and Two Lenses readings.

Argument	Type	Description
seed	string \| number	Deterministic Tarot draw seed.
locale	string
question*	string	The real question to reflect on.
device_id	string	Optional opaque identifier for quota tracking. If omitted, IP-derived.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "question"
  ],
  "properties": {
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Deterministic Tarot draw seed."
    },
    "locale": {
      "enum": [
        "en",
        "zh",
        "zh-Hant",
        "ja",
        "ko",
        "es",
        "fr",
        "de",
        "pt",
        "it",
        "ru",
        "ar",
        "hi",
        "id",
        "bilingual"
      ],
      "type": "string",
      "default": "en"
    },
    "question": {
      "type": "string",
      "description": "The real question to reflect on."
    },
    "device_id": {
      "type": "string",
      "description": "Optional opaque identifier for quota tracking. If omitted, IP-derived."
    }
  }
}

two_lenses

Bring one real question to two independent symbolic traditions: a source-first I-Ching cast and one upright Waite-Smith Major Arcana card. Returns a clear calibrated answer first, then five grounded sections covering the I Ching lens, Tarot lens, shared themes, different emphasis, and next step. Direction without guaranteed prediction or mutual-confirmation claims. Daily quota is shared with completed divine readings.

Argument	Type	Description
locale	string
method	string
question*	string	The same real question for both lenses.
device_id	string	Optional opaque identifier for quota tracking. If omitted, IP-derived.
tarot_seed	string \| number	Deterministic Tarot draw seed.
iching_seed	string \| number	Deterministic I-Ching cast seed.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "question"
  ],
  "properties": {
    "locale": {
      "enum": [
        "en",
        "zh",
        "zh-Hant",
        "ja",
        "ko",
        "es",
        "fr",
        "de",
        "pt",
        "it",
        "ru",
        "ar",
        "hi",
        "id",
        "bilingual"
      ],
      "type": "string",
      "default": "en"
    },
    "method": {
      "enum": [
        "coins",
        "yarrow",
        "random"
      ],
      "type": "string",
      "default": "coins"
    },
    "question": {
      "type": "string",
      "description": "The same real question for both lenses."
    },
    "device_id": {
      "type": "string",
      "description": "Optional opaque identifier for quota tracking. If omitted, IP-derived."
    },
    "tarot_seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Deterministic Tarot draw seed."
    },
    "iching_seed": {
      "type": [
        "string",
        "number"
      ],
      "description": "Deterministic I-Ching cast seed."
    }
  }
}