⚡ MCP server • CLI • SDKs • GitHub Actions

The developer-first
astrology API

Natal charts, horoscopes, compatibility, transits, tarot, numerology and moon phases — all through one typed REST API. Built for builders, not believers.

$ curl -X POST https://api.gitstrology.dev/v1/natal-chart \
    -H "X-API-Key: ***" \
    -d '{"date":"1990-03-15","time":"14:30","lat":44.8,"lon":20.4}'

{
  "data": {
    "sunSign": "pisces",
    "moonSign": "leo",
    "risingSign": "taurus",
    "planets": [ { "planet": "sun", "sign": "pisces", "house": 11, ... } ],
    "aspects": [ { "planetA": "sun", "planetB": "moon", "type": "trine" } ]
  },
  "credits": { "used": 5, "remaining": 95 }
}
Astronomy-verifiedSwiss Ephemeris precision, not random tables
99.9% uptimeEdge-cached horoscopes, deterministic output
Stripe-securedPayments handled by Stripe, keys never stored raw
WCAG 2.1 AAMarketing + docs tested for screen readers

Everything you need

One API, eight endpoints, zero astrology knowledge required.

🔮

Natal Charts

Full birth chart with 10 planets, 12 houses, and all major aspects. Real astronomical calculations.

📰

Daily Horoscopes

Deterministic, transit-aware horoscopes for every sign. Same input, same output — cacheable.

💕

Compatibility

Synastry scoring with a 0-100 breakdown across emotional, physical, mental, and values dimensions.

🪐

Transit Readings

Live planetary transits to a natal chart, with interpretations and intensity ratings.

🃏

Tarot

Full 78-card Rider-Waite deck. Single draws, three-card spreads, and Celtic Cross.

🔢

Numerology

Life path, expression, soul urge, and personality numbers from any name and date.

🌙

Moon Phases

Current lunar phase, illumination, age, and zodiac sign. Next full moon lookups.

🤖

MCP Server

Native Model Context Protocol server. Use astrology data inside Claude, Cursor, ChatGPT.

⌨️

CLI + SDKs

TypeScript and Python SDKs. A npx gitstrology CLI. GitHub Actions for CI.

Developers are building with it

Real projects shipping against the GitStrology API.

Wired up the natal-chart endpoint in an afternoon. The synastry scoring is genuinely good — my compatibility app shipped in a weekend instead of three months.
Mara VidalIndie dev · Lisbon@maravidal
The MCP server alone sold me. I pull horoscope data straight into Claude for my newsletter and it just works. Credit pricing is transparent — no surprise bills.
Tom BeckettCreator · Daily Stars newsletter@tbeckett
I needed moon-phase + numerology for a wellness tracker. One API key, typed responses, decent docs. Exactly what a solo dev wants instead of stitching three half-baked services.
Priya AnandFounder · Lunar Habits@priyaa

Ready to build?

Free tier includes 100 requests/month. No credit card required.

Get your API key →