Skip to main content
Glama
0xctx

astrolog-mcp

by 0xctx
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

πŸ”­ astrolog-mcp

Exact astrology chart data for any AI assistant. Calculated by Astrolog and the Swiss Ephemeris, served over MCP.

CI License: AGPL v3 Node 22+ MCP

Ask your assistant about a birth chart and get real positions back, not made-up ones. ✨

"What are my Sun, Moon and rising for 15 June 1990, 14:30, born in Paris, France?" β†’ Sun 24Β°09β€² Gemini, Moon 15Β°38β€² Pisces, Ascendant 2Β°28β€² Libra (plus houses, aspects, midpoints…)

✨ Why

  • 🎯 Accurate. Real ephemeris maths, not an LLM's guess. Chiron, Ceres and the dwarf planets included.

  • πŸ”Œ Works anywhere. Claude Desktop, Claude Code, Cursor, or any MCP client, over stdio or HTTP.

  • ⚑ Fast. A typical warm call takes about 25 to 65 ms at the median (see the latency table), quick enough for voice assistants.

  • 🌍 Offline places. Type a city name. No geocoding service, no API keys.

  • πŸ”’ Private. No accounts, no logging of birth data, nothing stored.

  • 🧠 Facts, not fortune-telling. It returns numbers. Your assistant does the interpreting.

Related MCP server: auseklis

πŸš€ Quick start

git clone https://github.com/0xctx/astrolog-mcp.git && cd astrolog-mcp
npm ci && npm run install:astrolog && npm run build

Then connect it to your assistant: docs/clients.md has copy-paste configs for Claude Desktop, Claude Code and others. Prefer containers? docker compose up --build. 🐳

πŸ› οΈ Tools

Tool

You get

🌟 get_chart_data

A natal chart: bodies, houses, angles, aspects

πŸŒ™ get_transit_data

The sky for a date (or now) against a natal chart

πŸ’ž get_composite_data

A composite or Davison chart for two people

πŸ”’ get_harmonic_midpoints

A harmonic chart's midpoint structures

πŸ“… get_daily_transits

One day's ranked aspect hits, sign and house changes, retrograde changes and the Moon, with exact times

Seven house systems, harmonics from 1 to 10000 (the daily reading caps its own by the day's length), place names or coordinates. See the tool reference.

πŸ“š Docs

Connect a client

Claude Desktop, Claude Code, Cursor, HTTP

Tool reference

Every input, output and error

Installing Astrolog

Installer options, requirements, troubleshooting

Configuration

Environment variables

Running a server

Docker, limits, proxies, latency

Development

Layout, tests, how results are verified

Licensing

What you must do when you run or share it

🀝 Contributing

Bug reports, ideas and pull requests are welcome. Start with CONTRIBUTING.md.

⭐ Like it?

A star helps other people find it.

πŸ“œ Licence

AGPL-3.0-only. It is built on Astrolog (GPL), the Swiss Ephemeris (AGPL or Professional licence) and place data from GeoNames (CC BY 4.0, credited to GeoNames). Details and notices: docs/licensing.md and NOTICE.

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.
    10
    -

  • auseklis

    igmizo
    A
    license
    A
    quality
    C
    maintenance
    Astrology MCP server that computes natal charts, transits, synastry, progressions, returns, eclipses, retrogrades, and moon phases from a real ephemeris, enabling AI agents to provide accurate astrological calculations without hallucination.
    12
    61 npm
    1
    MIT

  • 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

  • AstroChalit MCP Server

    subhamPoulimaInfotech
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to access real-time Vedic astrology data and perform calculations like horoscopes, panchang, matchmaking, and planetary positions via the AstroChalit API.
    14 npm
    ISC