Back to Browse

Tj MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Ephemeris-grade natal charts, current transits, zodiac sign profiles. No API key.

About

Ephemeris-grade natal charts, current transits, zodiac sign profiles. No API key.

Remote endpoints: streamable-http: https://mcp.tianji-astrology.com/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (0 strong, 3 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

4 tools verified · Open access · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-feifeizhao25-ship-it-tj-mcp": {
      "url": "https://mcp.tianji-astrology.com/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

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

Reviews

No reviews yet

Be the first to review this server!