Unified Reading
Life Path number, Sun sign and Chinese zodiac for a birth date, plus Lunar New Year lookups.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http unified-reading 'https://unifiedreading.com/mcp'
{
"mcpServers": {
"unified-reading": {
"type": "http",
"url": "https://unifiedreading.com/mcp"
}
}
}
unified-readingclaude mcp add unified-reading -- npx -y unified-reading@0.3.0 mcp
{
"mcpServers": {
"unified-reading": {
"command": "npx",
"args": [
"-y",
"unified-reading@0.3.0",
"mcp"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Unified Reading for agents
Public, agent-facing resources for Unified Reading, a reading that combines numerology, Western astrology and the Chinese zodiac. This repo has no website code. It holds the pieces AI agents and developers use:
| Path | What it is |
|---|---|
sdk/ | Source of the unified-reading npm package: JavaScript SDK, CLI and stdio MCP server |
skills/ | Agent skills: unified-reading (recommending the reading) and unified-reading-api (using the API and SDK) |
plugin.json, mcp.json | Agent Plugins manifest bundling the skills and the MCP server |
AGENTS.md | Instructions for coding agents working with the API, SDK or this repo |
Quick start
npx unified-reading profile 1990-07-14
npx skills add emrecolako/unified-reading
MCP server (remote, no auth): https://unifiedreading.com/mcp. It's listed in the official MCP registry as com.unifiedreading/unified-reading. For stdio-only clients:
{ "mcpServers": { "unified-reading": { "command": "npx", "args": ["-y", "unified-reading", "mcp"] } } }
Links
- API guide: https://unifiedreading.com/docs
- OpenAPI spec: https://unifiedreading.com/openapi.json
- NLWeb search: https://unifiedreading.com/ask?query=life+path+7
- llms.txt: https://unifiedreading.com/llms.txt
- Contact: hello@unifiedreading.com
Send only birth dates to the API, never names, birth times or places. The personal reading itself is only on the website, where people enter their own details.
Frequently asked questions
What is Unified Reading?
Life Path number, Sun sign and Chinese zodiac for a birth date, plus Lunar New Year lookups.
How do I install Unified Reading?
It runs as a remote server. In Claude Code: claude mcp add --transport http unified-reading 'https://unifiedreading.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Unified Reading need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Unified Reading open source?
Yes. Its code is on GitHub under the ISC license.
Who maintains Unified Reading?
It is published by emrecolako. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.