Yarrow for AI agents

Give your agent a quiet I Ching reference.

Yarrow exposes a public MCP server for source-grounded I Ching reflection. It is built for agents that need a structured reading, not an answer feed.

MCP endpoint llms.txt Integration docs

cast_hexagramCast a hexagram from a question and method.

lookup_hexagramRead source-grounded notes for a specific hexagram.

lookup_yilinLook up the Yilin verse for a primary hexagram changing into another.

divineCast, inspect sources, and return a restrained reading.

Claude Desktop

{
  "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 and other stdio clients

npx @shaozhengkun/yarrow-mcp

Direct JSON-RPC call

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":"What should I pay attention to?","locale":"en"}
  }}'

Boundary: Yarrow is for reflection, not professional advice or fortune-telling. The public MCP server has anonymous rate limits and should be used as a calm source path, not a replacement for human judgment.