# QChing

**Explore the I Ching with Quantum-Randomness powered Reflection**

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add tavurth/qching

# Browse available tools
npx -y @smithery/cli@latest tool list tavurth/qching

# Get full schema for a tool
npx -y @smithery/cli@latest tool get tavurth/qching ask_qching

# Call a tool
npx -y @smithery/cli@latest tool call tavurth/qching ask_qching '{}'
```

## Direct MCP Connection

Endpoint: `https://qching--tavurth.run.tools`

## Tools (5)

- `ask_qching` — Generate personalized I Ching hexagrams using quantum entropy.
- `get_reading_stats` — Get comprehensive reading usage statistics and trends. Returns total readings, frequency patterns, most consulted topic…
- `check_credits` — Check current credit balance and usage information. Returns available credits, recent usage, and account status to help…
- `get_reading_history` — Retrieve paginated history of past I Ching readings. Returns chronologically ordered readings with questions, hexagrams…
- `search_readings` — Search through past readings by keyword or topic. Find specific consultations by searching questions, interpretations, …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get tavurth/qching <tool-name>
```