Skip to content
MCP server

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/mcp

Add to Settings → Connectors → Add custom connector

https://unifiedreading.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "unified-reading": {
      "url": "https://unifiedreading.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Natal Chart Lab

    MCP server

    Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

    Runs locally
    • 5 tools
    • Open source
    • Astrology
  2. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology
  3. Céu Natal

    MCP server

    Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese

    • 9 tools
    • Remote
    • Open source
    • Astrology
  4. Deterministic Korean tax, payroll, labor and calendar calculators served over MCP

    • 76 tools
    • Remote
    • Free
    • Finance and payments