Yarrow MCP Server

by shaozhengkun123 Your server? Claim it

answering

Yarrow is answering right now. Last checked 2 min ago. It exposes 7 tools. Last commit 27 May 2026.

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

Uptime history 91 days of history · worst day 93%

91 days agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

144 ms

Response time

average over 24h

Stars

last commit 27 May 2026

What the code does

We read the source, 2 d ago · tools taken from the live server · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command npm/yarrow-mcp/bin/yarrow-mcp.js:35

const child = spawn(cmd, args, {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 2 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add yarrow --transport http https://yarrow-oracle.shaozhengkun.workers.dev/mcp

Settings → Connectors → Add custom connector, then paste this address

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

~/.codex/config.toml

[mcp_servers.yarrow]
url = "https://yarrow-oracle.shaozhengkun.workers.dev/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "yarrow": {
      "url": "https://yarrow-oracle.shaozhengkun.workers.dev/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "yarrow": {
      "type": "http",
      "url": "https://yarrow-oracle.shaozhengkun.workers.dev/mcp"
    }
  }
}

Available tools 7

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

cast

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).

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.

lookup

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.

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.

divine

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.

tarot

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.

two

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.

Endpoints

URL	Transport	State	Latency	Checked
https://yarrow-oracle.shaozhengkun.workers.dev/mcp	streamable-http	answering	180 ms	2 min ago

Alternatives to Yarrow

same job, measured the same way

I Ching Hexagrams (The Hexagrams)

by thehexagrams

Cast I Ching hexagrams with moving lines; classical + English judgments for all 64.

3 tools answering

海棠诗社

by mkfasthq

Search and browse classical Chinese poetry on haitang.app. Read-only and public.

16 tools answering

Bereishes

by bereishes

Search and read classical Jewish texts: Tanach, Talmud, Midrash, halacha, and commentaries.

4 tools answering

I Ching MCP Server by RoxyAPI

by roxyapi

I Ching hexagram casts, 64 hexagram meanings and changing lines for AI agents.

9 tools answering

I Ching Hexagram MCP

by iching

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

10 tools answering

I Ching

by pipeworx-io

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

334 installs/wk 47 tools answering

Hotyata

by hotyata

Real estate and classifieds in Batumi & Tbilisi with rooftop geocoding and duplicate detection.

9 tools answering

Yiditu MCP

by kingbbs

I Ching hexagram analysis and geographic feng shui for Taiwan locations

278 installs/wk 3 tools answering

Yarrow — questions

Answers built from our own checks of this server.

What can Yarrow do?

It exposes 7 tools, read directly from the server on our last check. Among them: cast_hexagram, cast_tarot, divine, lookup_hexagram, lookup_yilin, tarot_reading and 1 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Yarrow mostly used for?

Its tools cluster around cast and lookup. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Yarrow working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 144 ms. The bar chart above shows every period we have measured.

How do I connect Yarrow?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Yarrow need an API key?

No. Yarrow completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 7 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Yarrow?

It answers our handshake in 144 ms on average, which is faster than 83% of all working MCP servers we measure. That puts it in the quick quarter of the ecosystem. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Yarrow open source?

We cannot say either way: written in TypeScript and 1 stars on GitHub, but we could not determine the licence, and without one the code is not open source by default.