Yarrow
Cast a hexagram, hear it back.
Yarrow is a quiet I-Ching companion — for your iPhone, and for your AI agents. Ask a real question. Cast a hexagram by the present moment, or by three numbers. Read an answer drawn from nineteen classical Chinese commentaries, translated into clear English.
Get the app
What's inside
- 64 hexagrams, 384 lines, with moving lines (bian gua) computed for you
- Classical sources side-by-side: Overview, Judgment, Commentary, plain-language note, historical anecdote
- AI reading that weaves your question and the sources into one calm reply — in the spirit of Wilhelm/Baynes, never as fortune-telling
- Local journal. No account. No tracking. 30 readings a day; the oracle rests at night.
For your AI agents
Yarrow is also a public MCP server. Any LLM client that speaks MCP can consult the same oracle — cast_hexagram, lookup_hexagram, divine. No auth, 30 readings per day per anonymous caller.
Claude Desktop
Add to
claude_desktop_config.json:
{
"mcpServers": {
"yarrow": { "url": "https://yarrow-oracle.shaozhengkun.workers.dev/mcp" }
}
}
Claude Code
claude plugin marketplace add https://github.com/shaozhengkun123/yarrow
claude plugin install yarrow
Codex / others
Use the stdio bridge:
npx @shaozhengkun/yarrow-mcp
curl
curl -s -X POST https://yarrow-oracle.shaozhengkun.workers.dev/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
"name":"divine",
"arguments":{"question":"Should I take the new job?","locale":"en"}
}}'Source on GitHub · MIT licensed. Full setup details in INTEGRATIONS.md.