Skip to main content
Glama
feifeizhao25-ship-it

TianJi Astrology MCP Server

by feifeizhao25-ship-it
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

TianJi Astrology MCP Server

Computation-first astrology tools for AI agents. Real ephemeris-grade planetary positions, houses, and aspects — not generic sun-sign content.

Built by TianJi Astrology on top of kerykeion 6.x (libephemeris engine). Transport: streamable HTTP (MCP spec).

Live endpoint: https://mcp.tianji-astrology.com/mcp

Why this server

Most astrology MCP servers wrap horoscope text. TianJi computes the actual chart:

  • Swiss-ephemeris-grade planetary longitudes, retrogrades, and house cusps (via kerykeion/libephemeris)

  • Full 12-house placement with cusp houses resolved per planet

  • Major aspects (conjunction, sextile, square, trine, opposition) computed with standard orbs

  • Deterministic output an agent can reason over — no LLM-generated "readings" in the loop

Related MCP server: astro-mcp

Tools

compute_natal_chart

Compute a natal (birth) chart from date, time, and place.

Parameters: name, year, month, day, hour (default 12), minute (default 0), city, nation, lng, lat, tz_str.

Returns JSON: positions for Sun through Pluto (sign, degree, house, retrograde), Ascendant/MC, house cusps, and the aspect list with exact orbits.

get_current_transits

Today's sky: current planetary positions for all ten bodies, with retrograde flags. No parameters.

get_sign_profile

Reference facts for a zodiac sign: element, modality, ruling planet (traditional + modern), date range. Parameter: sign (e.g. "Scorpio").

Usage

Remote (hosted)

The server runs publicly at https://mcp.tianji-astrology.com/mcp (streamable HTTP transport). Point any MCP client that supports remote servers at that URL — no API key required for the reference tools.

Claude Desktop / Claude Code (claude mcp add):

claude mcp add --transport http tianji https://mcp.tianji-astrology.com/mcp

Cursor / other clients: add a server entry with type http (or streamable-http) and the URL above.

Self-host

docker build -t tj-mcp .
docker run -p 8033:8033 tj-mcp

Or bare Python:

pip install fastmcp kerykeion
python server.py

Data & privacy

All computation is local to the server. Birth data is used only to compute the chart and is never stored or logged.

License

MIT — see LICENSE.

TianJi Astrology: personalized Western astrology, computed. https://tianji-astrology.com

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Astro MCP Server

    aryaminus
    F
    license
    Not graded
    quality
    C
    maintenance
    Multi-tradition astrology engine that computes real birth charts, transits, and synastry for AI agents via MCP tools.
    13
    -

  • astro-mcp

    DrewCyber
    A
    license
    Not graded
    quality
    B
    maintenance
    High-precision astrology tools for LLM agents, including natal charts, transits, progressions, synastry, and more, backed by Swiss Ephemeris.
    1
    MIT
  • fatenava-mcp by fatenava

    fatenava-mcpofficial

    fatenava
    A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to cast deterministic BaZi, Zi Wei Dou Shu, and Western astrology natal charts from birth details, with no setup or API key.
    1
    45 npm
    MIT