# Unified Reading

> Unified Reading is a freemium MCP server for astrology. Birth-date lookups for Life Path number, Sun sign, Chinese zodiac and Lunar New Year. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://unifiedreading.com
- **Repository:** https://github.com/emrecolako/unified-reading/tree/HEAD/sdk
- **MCP Registry name:** com.unifiedreading/unified-reading
- **Categories:** astrology
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://unifiedreading.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "unified-reading": {
      "serverUrl": "https://unifiedreading.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/unified-reading
