Unified Reading

com.unifiedreadingPublished by unifiedreading.comOfficial publisherv1.1.0Updated Oct 25, 2026

Life Path number, Sun sign and Chinese zodiac for a birth date, plus Lunar New Year lookups.

VerifiedStreamable HTTPWeb executableLocation & Lifestyle Knowledge & Memory

Server details

Identifier: com.unifiedreading/unified-reading
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Oct 25, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to unifiedreading.com, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/com.unifiedreading%2Funified-reading.svg)](https://sourceweft.com/mcp/com.unifiedreading%2Funified-reading?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A remote or local MCP server that computes Life Path numbers, Western Sun signs and Chinese zodiac animals from a birth date, plus Lunar New Year lookups.

What you can do: Look up reading options, including the free sample, free preview, paid full reading, price and pages to open, without collecting personal data. Calculate a birth date profile: Life Path number, Sun sign and Chinese zodiac animal, with links to matching library guides. Look up a Chinese zodiac year's animal, stem element, yin-yang and Lunar New Year start and end dates, useful for explaining January and February birthdays.
When to use it: Useful when an assistant needs quick date-only numerology, astrology or Chinese zodiac facts, or needs to explain which zodiac animal a year or an early-year birthday belongs to. It is a light reference tool rather than a full personal reading service.
Requirements: Runs as a remote endpoint or as a local process via npx with Node 18 or later. No API key, account or environment variables are needed. Network access to the service is required; the API allows 10 requests per minute per IP.

Before you install

Send only birth dates; the server asks that names, birth times and places never be submitted. It offers a paid full reading, so it may point users to a purchase. Nothing is stored according to the documentation, but dates are sent to a third-party service.

Installation

In SourceWeft

Open Unified Reading in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.unifiedreading%2Funified-reading/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "unified-reading": {
      "type": "http",
      "url": "https://unifiedreading.com/mcp"
    }
  }
}

README

unified-reading

SDK, CLI and stdio MCP server for the public Unified Reading API. Give it a birth date and it returns the Life Path number, the Western Sun sign and the Chinese zodiac animal. It also covers the 1924-2044 Lunar New Year table. There is no API key and nothing is stored.

Send only birth dates, never names, birth times or places. The combined personal reading is at unifiedreading.com.

CLI

1990-07-14Life Path   4  The BuilderSun sign    ♋ Cancer, decan 3 (Water, Cardinal, ruled by Moon)Chinese     Yang Metal Horse

1990-07-14Life Path   4  The BuilderSun sign    ♋ Cancer, decan 3 (Water, Cardinal, ruled by Moon)Chinese     Yang Metal Horse

Command	What it does
`unified-reading profile <YYYY-MM-DD>`	Life Path, Sun sign and Chinese zodiac for one date
`unified-reading batch <YYYY-MM-DD>...`	The same for up to 20 dates
`unified-reading year <YYYY>`	A Chinese zodiac year and its Lunar New Year start and end
`unified-reading years [--limit N] [--cursor YYYY] [--all]`	Page through the year table
`unified-reading mcp`	Run as a stdio MCP server

Add --json to any command for the raw API response. --base-url points the CLI at another origin.

MCP server

unified-reading mcp runs a stdio MCP server that forwards to the remote server at https://unifiedreading.com/mcp. It is for MCP clients that only launch local commands:

json

{ "mcpServers": { "unified-reading": { "command": "npx", "args": ["-y", "unified-reading", "mcp"] } } }

{ "mcpServers": { "unified-reading": { "command": "npx", "args": ["-y", "unified-reading", "mcp"] } } }

The server has tools for reading options, the birth date profile (with an MCP Apps card) and Chinese zodiac years. It is listed in the official MCP registry as com.unifiedreading/unified-reading.

SDK

Needs Node 18 or later, or any runtime with fetch.

import { UnifiedReading, UnifiedReadingError } from "unified-reading";
const client = new UnifiedReading();
const profile = await client.profile("1990-07-14");console.log(profile.lifePath.number, profile.sunSign.sign, profile.chineseZodiac.animal); // 4 Cancer Horse
const results = await client.profiles(["1990-07-14", "1990-01-20"], { idempotencyKey: crypto.randomUUID() });
for await (const year of client.allChineseZodiacYears()) {  console.log(year.year, year.animal, year.starts, year.ends);}
try {  await client.profile("1990-02-30");} catch (error) {  if (error instanceof UnifiedReadingError) console.log(error.code, error.hint); // invalid_date ...}

import { UnifiedReading, UnifiedReadingError } from "unified-reading";
const client = new UnifiedReading();
const profile = await client.profile("1990-07-14");console.log(profile.lifePath.number, profile.sunSign.sign, profile.chineseZodiac.animal); // 4 Cancer Horse
const results = await client.profiles(["1990-07-14", "1990-01-20"], { idempotencyKey: crypto.randomUUID() });
for await (const year of client.allChineseZodiacYears()) {  console.log(year.year, year.animal, year.starts, year.ends);}
try {  await client.profile("1990-02-30");} catch (error) {  if (error instanceof UnifiedReadingError) console.log(error.code, error.hint); // invalid_date ...}

Method	Endpoint
`profile(date)`	`GET /api/v1/profile?date=`
`profiles(dates, { idempotencyKey })`	`POST /api/v1/profiles/batch`
`chineseZodiacYears({ limit, cursor })`	`GET /api/v1/chinese-zodiac/years` (one page)
`allChineseZodiacYears()`	Every page, as an async iterator
`chineseZodiacYear(year)`	One year, or `null` outside 1924-2044

Dates can be YYYY-MM-DD strings or Date objects; a Date is sent as its local calendar date. Errors throw UnifiedReadingError, which carries status, code, hint and retryAfter. The API allows 10 requests per minute per IP.

Tools

get_unified_reading_options

Unified Reading options

List what Unified Reading offers (free sample, free preview, paid full reading), its price, and the pages a person should open. Collects no personal data.

Parametersoption

calculate_birth_date_profile

Birth date profile

Calculate the Life Path number, Western Sun sign and Chinese zodiac animal for a birth date, with links to the matching Unified Reading library guides. Only the date is needed; never send names, birth times or places. Nothing is stored. Moon, rising, houses and the full combined reading need the website form.

Parametersdaterequired

get_chinese_zodiac_year

Chinese zodiac year

Look up a Chinese zodiac year: its animal, stem element, yin-yang, and the Lunar New Year dates it starts and ends on. Use it to explain why a January or February birthday belongs to the previous animal. Needs no personal data.

Parametersyearrequired

Version history

v1.1.0LatestOct 25, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts