🌿 Inherits Dr. Ho Ngoc Duc Algorithm (UTC+7) • MCP Server & REST API for AI Agents

Digitizing Eastern Metaphysics for Modern AI Agents & Applications

Deeply mindful of our humble standing before the vast heritage of ancient wisdom, NaturaOS faithfully builds upon the astronomical and philosophical research of venerated scholars (Dr. Ho Ngoc Duc, Phan Boi Chau, Nguyen Hien Le, Dr. Nguyen Van Tho). We provide a 100% deterministic computing engine while maintaining a receptive, learning-oriented mindset.

Get Started Free → Integration Guide Swagger Sandbox

Free 200 requests/day • No credit card required • 1-line connect for Claude Code & Cursor

NaturaOS — Engine Architecture for AI Agents & Applications

📖 Scholarly Roots & Copyright Integrity

Honoring Scholarly Heritage, Multi-Source Cross-Referencing & Copyright Integrity

Deeply conscious of our modest contribution before the vast ocean of Eastern knowledge, NaturaOS was built through extensive research, independent compilation, and cross-referencing of classical and modern scholarship. We strictly uphold copyright integrity and algorithmic independence:

Pioneering Scholars Who Inspire Our Work

Dr. Ho Ngoc Duc

UTC+7 Astronomy

Faithfully inherits the Vietnamese Lunar Calendar Algorithm from the precise astronomical computations of Dr. Ho Ngoc Duc (VNCal), preserving historical accuracy for the Indochina timezone.

Scholar Phan Boi Chau

I Ching Philosophy

Inspired by the liberating spirit and profound national depth of the patriotic scholar's seminal work Quoc Van Chu Dich Dien Giai (1926).

Scholar Nguyen Hien Le

Way of the Noble Person

Guided by the rigorous and lucid scholarship of Kinh Dich — Dao Cua Nguoi Quan Tu, centering on ethical and personal development rather than occult divination.

Dr. Nguyen Van Tho

Ten Wings Exegesis

Drawing upon the erudite exegesis of the Great Commentary (Xi Ci) and Discussion of Trigrams (Shuo Gua) and East-West philosophical comparative research.

Multi-Source Cross-Referencing & International Scholarship

Classical Chinese Canons

Independently surveyed from public-domain original texts: Zhouyi Zhengyi, Ten Wings, Zhu Xi's Benyi, and Xieji Bianfang Shu.

English Scholarship (Wilhelm / Legge)

Cross-referenced philosophical terminology against landmark international editions by Richard Wilhelm, Cary F. Baynes, and James Legge (Oxford).

Astronomical History (Needham)

Informed by Joseph Needham's authoritative research on East Asian astronomical history and the mathematical mechanics of the 24 solar terms.

🛡️ Commitment to Copyright Respect & Independent Authorship:

Recognizing that 20th-century scholarly commentaries remain under copyright protection, NaturaOS does not copy commercial translations or copyrighted prose. All computational structures and interpretive metadata are independently compiled and translated from public-domain classical sources and open scholarship into structured JSON APIs.

Receptive Mindset: Before the magnificent cultural heritage of humanity, NaturaOS remains humble and eagerly welcomes guidance, critique, and contributions from researchers, scholars, and developers worldwide.

Why Do AI Agents Need an Independent Metaphysics Engine?

Large Language Models excel at reasoning and natural language, but astronomical new moons and sexagenary cycles require absolute deterministic precision.

⚠️ Challenges of Relying on Raw LLM Guessing

Astronomical Timezone Drift: Models easily conflate UTC+8 (Beijing) with UTC+7 (Hanoi), causing errors in Tet dates (1985, 2007, 2030, 2053) and leap month placement.
Sexagenary Cycle Arithmetic: Modulo-60 cycle shifts and solar term boundary calculations require exact celestial algorithms rather than token probability.
Inference Token Waste: High token costs on complex prompts that still yield hallucinations.

🌿 When AI Agents Partner with NaturaOS

100% Deterministic: The same input always produces the exact same structured JSON envelope, verifiable anywhere.
Standardized via Dr. Ho Ngoc Duc: Preserves decades-tested Vietnamese astronomical calendar calculations.
Lightweight & Agent-Native: Instant integration via Model Context Protocol (MCP) or standard REST API.

Integrate in 30 Seconds

Select the method suited for your stack — MCP for AI Coding Agents or REST API for Web & Mobile Apps.

1. Claude Code CLI (MCP) 1-line setup

claude mcp add naturaos https://naturaos.mza.vn/mcp --header "Authorization: Bearer <api-key>"

2. Cursor & Windsurf IDE (.cursor/mcp.json) native stream

{ "mcpServers": { "naturaos": { "url": "https://naturaos.mza.vn/mcp", "headers": { "Authorization": "Bearer <api-key>" } } } }

3. REST API (Next.js, Flutter, cURL, Python) JSON envelope

curl -H "Authorization: Bearer <api-key>" \
  https://naturaos.mza.vn/api/v1/calendar/day?date=2026-09-06

4 Pillars of Objective Computation

Standardized into clean REST APIs and MCP tools for reliable machine lookup.

📅 Lunar Calendar & Solar Terms

Solar-lunar conversion, astronomical new moons, leap months, Julian Day Numbers, and 24 solar terms spanning years 1800 to 2199 in Vietnam timezone.

🧭 Four Pillars & Ganzhi

Compute Stems and Branches for Year, Month, Day, and Hour; inspect 60 Hoa Giap (Jiazi), Nayin elements, 12 Duty Officers, and auspicious days.

☯️ 64 Hexagrams of Zhouyi

64 hexagram structures, changing lines, and transformed hexagrams computed via traditional Plum Blossom numerology with annotated canonical texts.

⚡ Serverless Edge Infrastructure

Deployed globally on Cloudflare Workers. Standardized JSON responses distributed across 300+ edge locations with sub-50ms latency.

Experience and Contribute to the Project

Create an account via GitHub or Google in seconds. Enjoy 200 free API requests daily for testing and development.

Get Started Free →