Skip to content
MCP server

TianJi Astrology

Ephemeris-based natal charts, current transits and zodiac sign facts for AI agents

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

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

  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