Unified Reading
Birth-date lookups for Life Path number, Sun sign, Chinese zodiac and Lunar New Year
- Pricing
- Freemium
- Platforms
- API, CLI, Web
- Runs
- Locally or Remotely
- Version
- 1.1.0
- Listing updated
- 3 days ago
About Unified Reading
Unified Reading is a freemium MCP server for astrology. It can run locally on your machine or as a hosted remote server.
The data behind this server is simple and deterministic: give it a birth date and it returns the Life Path number, the Western Sun sign with its decan, and the Chinese zodiac animal and element. It also covers a Lunar New Year table for 1924 to 2044, with each zodiac year's start and end. The README example for 1990-07-14 returns Life Path 4, Cancer decan 3 and Yang Metal Horse.
A stdio package published on npm forwards to the hosted remote server for clients that only start local commands, and the same package provides a CLI and a JavaScript SDK with batch lookups of up to 20 dates. The API needs no key, stores nothing, and allows 10 requests per minute per IP. The README advises sending birth dates only, never names, times or places.
The full personal reading on the Unified Reading site is a separate product at $4.99 one-time, which uses an AI model through OpenRouter and frames its output as reflection, not prediction.
Install
Run in a terminal
claude mcp add --transport http unified-reading https://unifiedreading.com/mcpAdd to Settings → Connectors → Add custom connector
https://unifiedreading.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"unified-reading": {
"url": "https://unifiedreading.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"unified-reading": {
"type": "http",
"url": "https://unifiedreading.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"unified-reading": {
"serverUrl": "https://unifiedreading.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"unified-reading": {
"type": "http",
"url": "https://unifiedreading.com/mcp"
}
}
}What it does
- Birth date profile
- Returns Life Path, Sun sign and Chinese zodiac for one date.
- Lunar New Year table
- Covers zodiac years 1924 to 2044 with start and end dates.
- Batch lookups
- The CLI and SDK handle up to 20 dates at once.
- Stdio and remote
- Local npm package or hosted streamable HTTP endpoint.
- SDK and CLI
- JavaScript client with typed errors and command-line commands.
- No key or storage
- Public API that stores nothing.
Good for
- Show a zodiac profile in a birthday app
- Look up the Chinese zodiac year for a given date
- Add Life Path numbers to a horoscope chatbot
- Check Lunar New Year dates for a range of years
Pricing
Freemium
API and profile free; full reading $4.99 one-time
Prices change. Check unifiedreading.com before you buy.
Unified Reading FAQ
Does it need an API key?
No. The API is keyless, limited to 10 requests per minute per IP.
What input should I send?
Only birth dates; the README says not to send names, birth times or places.
Is the full reading free?
The calculated profile is free; the full personal reading is $4.99 one time on the website.
Is it a prediction?
No. The site calls it a framework for reflection, not a forecast.
Is Unified Reading free?
Unified Reading has a free plan, with paid plans for more usage or features.
How do I add Unified Reading to Claude Code?
Run this command in your terminal: claude mcp add --transport http unified-reading https://unifiedreading.com/mcp
What are the best alternatives to Unified Reading?
The closest alternatives to Unified Reading are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.
Alternatives to Unified Reading
Natal Chart Lab
MCP serverKeyless MCP server for planet positions, retrogrades, Moon phases and birth placements
Runs locally- 5 tools
- Open source
- Astrology

Vedic astrology calculations for AI: kundli, guna milan, panchang, dosha and muhurat
- 10 tools
- Remote
- Free
- Astrology

AstroLogics
MCP serverVedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching
- 23 tools
- Remote
- Freemium
- Astrology

GenesisCore Astrology (Western + Vedic)
MCP serverFree Western and Vedic chart signs, retrogrades and ingresses from a date and place
- 4 tools
- Remote
- Free
- Astrology
Céu Natal
MCP serverSwiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese
- 9 tools
- Remote
- Open source
- Astrology

OIYO Korea Calculators
MCP serverDeterministic Korean tax, payroll, labor and calendar calculators served over MCP
- 76 tools
- Remote
- Free
- Finance and payments