mcpbeat

Yarrow MCP Server

io.github.shaozhengkun123/yarrow
answering

Yarrow is answering right now. Last checked 7 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 39 hours of history
39 hours agonow
100.0%
Uptime 24h
91 of 91 checks
7
Tools
read from the server
102 ms
Response time
average over 24h
1
Stars
last commit 27 May 2026

Connect this server

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

run in your terminal
claude mcp add yarrow --transport http https://yarrow-oracle.shaozhengkun.workers.dev/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "yarrow": {
      "url": "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
{
  "mcpServers": {
    "yarrow": {
      "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

URLTransportStateLatencyChecked
https://yarrow-oracle.shaozhengkun.workers.dev/mcp streamable-http answering 176 ms 7 min ago

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 91 of 91 checks got a reply (100.0%), average response time 102 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 with the file path 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 102 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?
Yes — it is published under the NOASSERTION licence, written in TypeScript and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.