# Unified Reading

> A personal reflection web app at https://unifiedreading.com/ that synthesizes numerology, Western astrology, the Chinese zodiac, and life-stage context.

Unified Reading helps a person explore themes across three interpretive traditions in one reading. The free public sample requires no personal data. To create a personal reading, the visitor enters a birth name and date, optionally a birth time and place, and selects current life stages. The site calculates profile values in the browser and uses OpenRouter model providers to write the unified interpretation. A free preview is shown first. The full reading costs $4.99, paid once through Stripe Checkout, with no subscription, and can be downloaded right after paying. See [pricing](https://unifiedreading.com/pricing.md).

## When to use

Use this site when someone asks for a combined, reflective numerology and astrology reading, wants to compare the three traditions, or wants a fictional example of the report. Do not describe the reading as a scientific assessment or a deterministic prediction. Houses and the chart ruler are calculated (whole sign) only when a birth time and place are given. Do not infer Moon, rising, houses, aspects, or current transits when the app does not provide them.

## Public pages

- [Home and reading wizard](https://unifiedreading.com/): Product overview and entry point.
- [Fictional sample reading](https://unifiedreading.com/sample): See the report without entering personal details.
- [About and method](https://unifiedreading.com/about) ([markdown](https://unifiedreading.com/about.md)): Scope, calculations, limitations, and pricing model.
- [Privacy](https://unifiedreading.com/privacy): Data processing, provider routing, caching, and payment details.
- [Pricing](https://unifiedreading.com/pricing): Current cost and scope of the full reading.
- [Contact](https://unifiedreading.com/contact) ([markdown](https://unifiedreading.com/contact.md)): Support email (hello@unifiedreading.com) and private payment support guidance.

## Library

Plain-language guides to the three traditions, each with a short answer, key facts calculated from the app's own tables, and a markdown version at the same URL plus `.md` (for example https://unifiedreading.com/life-path/1-vs-9.md). The pairing guides compare whole signs, numbers and animals; they do not describe planetary aspects or transits, which the app does not calculate.

- [Library index](https://unifiedreading.com/library): All guides and calculators ([library llms.txt](https://unifiedreading.com/library/llms.txt)).
- [Numerology basics](https://unifiedreading.com/numerology): The Pythagorean chart, core numbers and master numbers, with a page for every Expression, Soul Urge and Personality number (for example https://unifiedreading.com/numerology/expression-7), every Birthday number from 1 to 31 (https://unifiedreading.com/numerology/birthday-21) and every Personal Year in 2026 and 2027 (https://unifiedreading.com/numerology/personal-year-5-2026), each with a worked example or the dates it covers.
- [Angel numbers](https://unifiedreading.com/angel-numbers): 111 to 999, 1111 and 1212, framed honestly as a modern idea and linked to their Pythagorean root numbers.
- [Life Path numbers](https://unifiedreading.com/life-path): Meanings for 1-9, 11, 22 and 33, and all 45 Life Path pairings.
- Cross-system combinations, written as one synthesis rather than two separate readings: every Life Path with every Sun sign (144 pages, for example https://unifiedreading.com/life-path/7-scorpio) and every Sun sign with every Chinese zodiac animal (144 pages, for example https://unifiedreading.com/zodiac/scorpio-horse), each with where the systems agree, where they pull apart, practical suggestions and an example birth date.
- [Zodiac signs](https://unifiedreading.com/zodiac): Elements, modalities, ruling planets and Sun sign dates, with a page for each sign (https://unifiedreading.com/zodiac/scorpio), each Moon sign (https://unifiedreading.com/zodiac/moon-in-cancer), each rising sign with its chart ruler and whole sign houses (https://unifiedreading.com/zodiac/leo-rising), and all 36 decans with dates and sub-rulers (https://unifiedreading.com/zodiac/aries-decan-2).
- [Zodiac compatibility](https://unifiedreading.com/compatibility): All 78 Sun sign pairings, without scores.
- [Astrology basics](https://unifiedreading.com/astrology): Sun, Moon and rising, whole sign houses, and what the reading does not calculate.
- [Chinese zodiac](https://unifiedreading.com/chinese-zodiac): The twelve animals, Lunar New Year boundaries, elements and yin-yang.
- [Chinese zodiac compatibility](https://unifiedreading.com/chinese-zodiac/compatibility): All 78 animal pairings through San He, Liu He, Liu Chong and Liu Hai.
- [Chinese zodiac years](https://unifiedreading.com/chinese-zodiac/years): Every year from 1924 to 2044 (for example https://unifiedreading.com/chinese-zodiac/1990) with its animal, element, yin-yang and exact Lunar New Year start and end dates, plus all sixty element-animal combinations (for example https://unifiedreading.com/chinese-zodiac/metal-horse).
- [Birthdays](https://unifiedreading.com/birthday): A page for each of the 366 dates (for example https://unifiedreading.com/birthday/march-21) with Sun sign and decan calculated for 1930-2030, cusp dates, birthday number, Life Path by birth year, the Chinese zodiac boundary and famous birthdays from Wikidata, plus one page per month.
- Calculators, all in the browser with no data sent: [Life Path](https://unifiedreading.com/life-path-calculator), [zodiac sign](https://unifiedreading.com/zodiac-sign-calculator), [Chinese zodiac](https://unifiedreading.com/chinese-zodiac-calculator), [name numerology](https://unifiedreading.com/name-numerology-calculator) (Expression, Soul Urge and Personality with every letter shown), [birthday compatibility](https://unifiedreading.com/birthday-compatibility-calculator) (two dates compared by Life Path, Sun sign and Chinese animal, without a score) and [birth chart](https://unifiedreading.com/birth-chart-calculator) (Sun sign and decan, Moon and rising signs; only the optional place search is sent, to OpenStreetMap).
- [Library answers and facts](https://unifiedreading.com/llms-full.txt): Each published page's answer and key facts in one file.

## Agent resources

- [Public API](https://unifiedreading.com/docs.md): `GET https://unifiedreading.com/api/v1/profile?date=YYYY-MM-DD` returns the Life Path number, Sun sign and Chinese zodiac animal; `POST /api/v1/profiles/batch` does up to 20 dates; `GET /api/v1/chinese-zodiac/years` pages through the Lunar New Year table. No auth, nothing stored, JSON errors. [API llms.txt](https://unifiedreading.com/docs/llms.txt). [OpenAPI spec](https://unifiedreading.com/openapi.json), [API catalog](https://unifiedreading.com/.well-known/api-catalog), [auth.md](https://unifiedreading.com/auth.md).
- [MCP server card](https://unifiedreading.com/.well-known/mcp/server-card.json): Name, icon, transport and tool list for the MCP server, also listed in the [official MCP registry](https://registry.modelcontextprotocol.io/v0/servers/com.unifiedreading%2Funified-reading/versions/latest).
- [JavaScript SDK and CLI](https://www.npmjs.com/package/unified-reading): `npx unified-reading profile 1990-07-14`, typed client for every API endpoint.
- [Agent guidance](https://unifiedreading.com/agents.md): When to recommend the app and how to handle personal data.
- MCP server: `https://unifiedreading.com/mcp` (stateless Streamable HTTP, no auth). Tools: `get_unified_reading_options`, `calculate_birth_date_profile` (date only, nothing stored), which renders an MCP Apps card, and `get_chinese_zodiac_year` (Lunar New Year start and end dates for 1924-2044). Browser agents also get WebMCP tools on every page.
- [NLWeb search](https://unifiedreading.com/ask?query=life+path+7): `GET /ask?query=...` or `POST /ask` with `{"query": {"text": "..."}}` (NLWeb 0.55, list mode) searches the public pages and returns schema.org items; add `"prefer": {"streaming": true}` or `Accept: text/event-stream` for SSE.
- [Agent resources repository](https://github.com/emrecolako/unified-reading): Public repo (no website code) with the SDK source, [AGENTS.md](https://github.com/emrecolako/unified-reading/blob/main/AGENTS.md) for coding agents, two agent skills (`npx skills add emrecolako/unified-reading`) and an [Agent Plugins manifest](https://github.com/emrecolako/unified-reading/blob/main/plugin.json) bundling the skills and the MCP server.
- [Markdown overview](https://unifiedreading.com/index.md): A compact, readable version of the homepage.
- [Sitemap](https://unifiedreading.com/sitemap.xml): Public site pages.

## Limits

The public API takes a birth date only; there is no API for submitting someone's name, birth time or place, or for buying a reading. Ask the person to use the site's form directly; never send sensitive birth or payment information to the support email on their behalf.