
TianJi Astrology
Ephemeris-based natal charts, current transits and zodiac sign facts for AI agents
- Pricing
- Open source
- Platforms
- API, self-hosted
- Runs
- Remotely
- Version
- 1.0.0
- Listing updated
- 3 days ago
About TianJi Astrology
TianJi Astrology is an open-source MCP server for astrology. It runs as a hosted remote server, so there is nothing to install locally.
Unlike servers that wrap horoscope text, this one computes the chart. The README says it is built on kerykeion 6.x with the libephemeris engine and returns planetary longitudes, retrograde flags, house cusps and aspects with exact orbs as JSON an agent can reason over, with no language-model writing in the loop.
Three tools are listed. compute_natal_chart takes a name, birth date and time, and a place (city and nation or coordinates and timezone) and returns Sun through Pluto with sign, degree, house and retrograde state, the Ascendant and Midheaven, cusps and aspects. get_current_transits reports today's positions for ten bodies. get_sign_profile returns element, modality, ruling planets and date range for a sign.
All computation happens on the server and the README says birth data is never stored or logged. You can use the public endpoint with no API key or self-host with Docker or Python. The parent TianJi site sells paid readings for entertainment and self-reflection.
Install
Run in a terminal
claude mcp add --transport http tj-mcp https://mcp.tianji-astrology.com/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.tianji-astrology.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"tj-mcp": {
"url": "https://mcp.tianji-astrology.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tj-mcp": {
"type": "http",
"url": "https://mcp.tianji-astrology.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tj-mcp": {
"serverUrl": "https://mcp.tianji-astrology.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tj-mcp": {
"type": "http",
"url": "https://mcp.tianji-astrology.com/mcp"
}
}
}Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- compute_natal_chart
- Computes a natal chart from date, time and place.
- get_current_transits
- Returns today's planetary positions with retrograde flags.
- get_sign_profile
- Returns reference facts for a zodiac sign.
What it does
- Natal chart computation
- Planet positions, houses, Ascendant, Midheaven and aspects from birth data.
- Current transits
- Today's positions for ten bodies with retrograde flags.
- Sign profiles
- Element, modality, ruling planets and date range for any sign.
- Deterministic output
- Structured JSON with no generated interpretation text.
- Self-hostable
- Run it with Docker or plain Python.
- No key for reference tools
- The hosted endpoint is open for the documented tools.
Good for
- Have an assistant explain a user's natal placements from exact data
- Check which planets are retrograde today
- Build an astrology app that needs accurate chart numbers
- Look up sign attributes for content writing
Pricing
Open source
MIT licence; hosted tools need no key. The TianJi reading app has separate paid tiers
Prices change. Check tianji-astrology.com before you buy.
TianJi Astrology FAQ
Does it need an API key?
The README says no key is required for the reference tools on the hosted endpoint.
Is birth data stored?
The README says birth data is used only to compute the chart and is never stored or logged.
What licence is it under?
MIT.
How accurate are the positions?
The site says its ephemeris engine was cross-checked against NASA JPL Horizons data for ten classical bodies.
Can I run it myself?
Yes, with docker build or pip install fastmcp kerykeion.
Is TianJi Astrology free?
Yes. TianJi Astrology is open source, so you can use and self-host it for free.
How do I add TianJi Astrology to Claude Code?
Run this command in your terminal: claude mcp add --transport http tj-mcp https://mcp.tianji-astrology.com/mcp
What are the best alternatives to TianJi Astrology?
The closest alternatives to TianJi Astrology are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.
Alternatives to TianJi Astrology
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