{"service":"qching.ai MCP Server","version":"1.0.0","usage":{"protocol":"MCP (Model Context Protocol)","endpoint":"/","learn":"https://qching.ai/learn","signup":"https://qching.ai/sign-up","reddit":"https://reddit.com/r/qching","try":{"web":"https://qching.ai/cast","smithery":"https://smithery.ai/server/@tavurth/qching"},"auth":{"type":"Bearer token","supports":["OAuth 2.0","MCP tokens"],"getToken":"https://qching.ai/settings/mcp"}},"tools":[{"name":"ask_qching","description":"Generate personalized I Ching hexagrams using quantum entropy.\nConsumes 1 credit per reading.\nProvides hexagram interpretation, changing lines analysis, and guidance\nbased on ancient Chinese wisdom traditions. Uses quantum random number\ngeneration (vacuum fluctuations) for true randomness in hexagram selection.\nReturns structured reading with classical texts, moving line interpretations,\nand practical frameworks for applying wisdom to contemporary situations.\nLearn more: https://qching.ai/learn","inputSchema":{"type":"object","properties":{"question":{"type":"string","description":"The situation or decision seeking guidance.\nBe specific, one question at a time - don't ask for 2-3-5 things at once.\nGive context, ask a clear question.\nIf you need multiple readings, ask separately - the answers together provide richer context.\nOn failure: retry with the EXACT same question, do not rephrase."},"conversation_id":{"type":"string","format":"uuid","description":"UUID to continue an existing conversation thread."},"locale":{"type":"string","description":"Language code sq,cs,en,es,fr,de,ka,pt,ru,tr,vi,zh. Defaults to en."}},"required":["question"]},"outputSchema":{"def":{"type":"object","shape":{"hexagramNow":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"},"changingLines":{"def":{"type":"optional","innerType":{"def":{"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}},"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}}},"type":"optional"}}},"type":"object"},"hexagramNext":{"def":{"type":"optional","innerType":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"}}},"type":"object"}},"type":"optional"},"interpretation":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"coherence":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"warning":{"def":{"type":"boolean"},"type":"boolean"},"conversationId":{"def":{"type":"optional","innerType":{"def":{"type":"string","checks":[{"def":{"type":"string","format":"uuid","check":"string_format","abort":false,"pattern":{}},"type":"string","format":"uuid","minLength":null,"maxLength":null}]},"type":"string","format":"uuid","minLength":null,"maxLength":null}},"type":"optional"}}},"type":"object"},"requiredScope":"write","annotations":{"readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"get_reading_stats","description":"Get comprehensive reading usage statistics and trends.","inputSchema":{"type":"object","properties":{"locale":{"type":"string","description":"Language code sq,cs,en,es,fr,de,ka,pt,ru,tr,vi,zh. Defaults to en."}}},"outputSchema":{"def":{"type":"object","shape":{"totalReadings":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"recentReadings":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"avgDailyReadings":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"avgCoherence":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"changingReadingsCount":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"warningsCount":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"mostFrequentHexagrams":{"def":{"type":"optional","innerType":{"def":{"type":"array","element":{"def":{"type":"object","shape":{"hexagram":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"count":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null}}},"type":"object"}},"type":"array","element":{"def":{"type":"object","shape":{"hexagram":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"count":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null}}},"type":"object"}}},"type":"optional"}}},"type":"object"},"requiredScope":"write","annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"check_credits","description":"Check current credit balance and usage information.","inputSchema":{"type":"object","properties":{"locale":{"type":"string","description":"Language code sq,cs,en,es,fr,de,ka,pt,ru,tr,vi,zh. Defaults to en."}}},"outputSchema":{"def":{"type":"object","shape":{"credits":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null}}},"type":"object"},"requiredScope":"write","annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"get_reading_history","description":"Retrieve paginated history of past I Ching readings.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","default":20,"minimum":1,"maximum":100,"description":"Number of readings to return per page."},"offset":{"type":"number","default":0,"minimum":0,"description":"Number of readings to skip for pagination."},"locale":{"type":"string","description":"Language code sq,cs,en,es,fr,de,ka,pt,ru,tr,vi,zh. Defaults to en."}}},"outputSchema":{"def":{"type":"object","shape":{"readings":{"def":{"type":"array","element":{"def":{"type":"object","shape":{"question":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"hexagramNow":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"},"changingLines":{"def":{"type":"optional","innerType":{"def":{"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}},"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}}},"type":"optional"}}},"type":"object"},"hexagramNext":{"def":{"type":"optional","innerType":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"}}},"type":"object"}},"type":"optional"},"interpretation":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"coherence":{"def":{"type":"optional","innerType":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null}},"type":"optional"},"warning":{"def":{"type":"optional","innerType":{"def":{"type":"boolean"},"type":"boolean"}},"type":"optional"}}},"type":"object"}},"type":"array","element":{"def":{"type":"object","shape":{"question":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"hexagramNow":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"},"changingLines":{"def":{"type":"optional","innerType":{"def":{"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}},"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}}},"type":"optional"}}},"type":"object"},"hexagramNext":{"def":{"type":"optional","innerType":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"}}},"type":"object"}},"type":"optional"},"interpretation":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"coherence":{"def":{"type":"optional","innerType":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null}},"type":"optional"},"warning":{"def":{"type":"optional","innerType":{"def":{"type":"boolean"},"type":"boolean"}},"type":"optional"}}},"type":"object"}},"total":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"hasMore":{"def":{"type":"boolean"},"type":"boolean"}}},"type":"object"},"requiredScope":"read","annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"search_readings","description":"Search through past readings by keyword or topic.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword or phrase to search for across past reading questions and interpretations."},"limit":{"type":"number","default":10,"minimum":1,"maximum":50,"description":"Maximum number of results to return."},"locale":{"type":"string","description":"Language code sq,cs,en,es,fr,de,ka,pt,ru,tr,vi,zh. Defaults to en."}},"required":["query"]},"outputSchema":{"def":{"type":"object","shape":{"results":{"def":{"type":"array","element":{"def":{"type":"object","shape":{"question":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"hexagramNow":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"},"changingLines":{"def":{"type":"optional","innerType":{"def":{"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}},"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}}},"type":"optional"}}},"type":"object"},"hexagramNext":{"def":{"type":"optional","innerType":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"}}},"type":"object"}},"type":"optional"},"interpretation":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"coherence":{"def":{"type":"optional","innerType":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null}},"type":"optional"},"warning":{"def":{"type":"optional","innerType":{"def":{"type":"boolean"},"type":"boolean"}},"type":"optional"}}},"type":"object"}},"type":"array","element":{"def":{"type":"object","shape":{"question":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"hexagramNow":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"},"changingLines":{"def":{"type":"optional","innerType":{"def":{"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}},"type":"array","element":{"def":{"type":"object","shape":{"position":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"text":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}}},"type":"object"}}},"type":"optional"}}},"type":"object"},"hexagramNext":{"def":{"type":"optional","innerType":{"def":{"type":"object","shape":{"number":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null},"name":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"judgment":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null}},"type":"optional"}}},"type":"object"}},"type":"optional"},"interpretation":{"def":{"type":"string"},"type":"string","format":null,"minLength":null,"maxLength":null},"coherence":{"def":{"type":"optional","innerType":{"def":{"type":"number","checks":[]},"type":"number","minValue":null,"maxValue":null,"isInt":false,"isFinite":true,"format":null}},"type":"optional"},"warning":{"def":{"type":"optional","innerType":{"def":{"type":"boolean"},"type":"boolean"}},"type":"optional"}}},"type":"object"}}}},"type":"object"},"requiredScope":"read","annotations":{"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}}]}