Unified Reading

Name: Unified Reading
Author: emrecolako

by emrecolakoversion 1.1.0i★ –iComputer or cloud

Registry namecom.unifiedreading/unified-reading

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, Streamable HTTP
Category: Astrology & auspicious dates

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 3 of 3 passed
Runs on the maker’s server: what you ask it goes through their server.
Can do 3 things (tools) get_unified_reading_options, calculate_birth_date_profile, get_chinese_zodiac_year
The registry lists no key to fill in.

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://unifiedreading.com/mcp

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

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

Run this in your terminal

claude mcp add --transport http unified-reading https://unifiedreading.com/mcp

Or run it on your computer

claude mcp add unified-reading -- npx -y unified-reading mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

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

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "unified-reading": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "unified-reading",
        "mcp"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://unifiedreading.com/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.

get_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.
calculate_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
get_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.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain unifiedreading.com (the registry checks domain ownership)
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
✓ Pass
Endpoint responds
Responded in 272 ms (HTTP 200)
– Not applicable
Sign-in with OAuth
No sign-in needed
✓ Pass
No hidden instructions in tool descriptions
Read 3 tool descriptions and found no hidden instructions to the AI

Compared with others in Astrology & auspicious datesi

More stars than 0% of the other 116 servers in this category
Published to the registry more recently than 66% of the other 116 servers in this category
Basic checks equal to or better than 100% of the other 116 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Unified Reading safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.1.0) reached the registry 14 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: NumeroClaw, Yinyang Masters, Homo Universalis — 7 Wisdoms (BaZi, Tarot, Vedic Jyotish, Mayan, I-Ching, Human…

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

NumeroClaw

by numeroclaw.com

Order a personalized numerology reading, paid by the person and delivered by email.

Runs in the cloudUpdated yesterday

Install

Yinyang Masters

by gemral-edge

Tarot, astrology, numerology, Tu Vi and Bazi tools plus guides on habits and manifestation.

Runs in the cloudUpdated 2 days ago

Install

Homo Universalis — 7 Wisdoms (BaZi, Tarot, Vedic Jyotish, Mayan, I-Ching, Human…

by David-Porto-Baraldes

Deterministic 7-Wisdoms (BaZi, Tarot, Vedic Jyotish, Mayan, I-Ching, Human Design, Kabbalah) MCP.

Runs in the cloudUpdated 2 days ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

npx unified-reading profile 1990-07-14

1990-07-14

Life Path 4 The Builder Sun sign ♋ Cancer, decan 3 (Water, Cardinal, ruled by Moon) Chinese Yang Metal Horse

Command	What it does
`unified-reading profile`	Life Path, Sun sign and Chinese zodiac for one date
`unified-reading batch ...`	The same for up to 20 dates
`unified-reading year`	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:

{ "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 ... }

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.

Unified Reading

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Astrology & auspicious datesi

Common questions

Alternatives

NumeroClaw

Yinyang Masters

Homo Universalis — 7 Wisdoms (BaZi, Tarot, Vedic Jyotish, Mayan, I-Ching, Human…

README from the maker

unified-reading

CLI

MCP server

SDK

Links