# Asterwise Docs

> Developer documentation for the Asterwise API — Vedic + Western astrology, numerology, tarot, crystals, and dreams. 115+ REST endpoints. Interpretations grounded in classical Jyotish methodology. HMAC-signed responses. MCP server with 103 tools.

## Get started

- [Quickstart](https://docs.asterwise.com/quickstart): Get your first Asterwise API response in under 5 minutes.
- [Authentication](https://docs.asterwise.com/authentication): API key + header conventions.
- [Errors](https://docs.asterwise.com/reference/errors): Error envelope, codes, and recovery guidance.

## Reference

- [Vedic astrology endpoints](https://docs.asterwise.com/reference/vedic-astrology/foundations/natal-chart): Natal, Dasha (5-level Vimshottari), Yogas, Doshas, Divisional charts, Panchanga, Varshaphal, Prashna.
- [Western astrology endpoints](https://docs.asterwise.com/reference/western-astrology/foundations/western-natal-chart): Natal, Synastry, Composite, Returns, Progressions, Transits, Moon phases, Biorhythm.
- [Numerology endpoints](https://docs.asterwise.com/reference/numerology/core-numbers/numerology-profile): Pythagorean numbers, Chaldean, Lo Shu, Angel numbers, Compatibility.
- [Matchmaking endpoints](https://docs.asterwise.com/reference/vedic-astrology/matchmaking/kundali-milan): Ashtakoota, Dashakoot, Porutham, Thirumana, Papasamyam.
- [Tarot endpoints](https://docs.asterwise.com/reference/tarot/draws/draw-cards): Card draws, spreads (Celtic Cross, three-card, yes/no).
- [Crystals + dreams endpoints](https://docs.asterwise.com/reference/crystals/crystals-index): Crystal recommendations, dream symbol lookups.
- [KP + Lal Kitab endpoints](https://docs.asterwise.com/reference/vedic-astrology/kp-system/kp-natal-chart): Krishnamurti Paddhati, Lal Kitab remedies.
- [Utilities](https://docs.asterwise.com/reference/utilities/geocode): Geocoding, timezone lookup.

## SDKs

- [Python SDK (v0.2.3)](https://docs.asterwise.com/reference/python-sdk): `pip install asterwise`
- [TypeScript SDK (v0.2.3)](https://docs.asterwise.com/reference/typescript-sdk): `npm install asterwise`
- [MCP server](https://docs.asterwise.com/guides/mcp-setup): Connect from Claude, Cursor, or custom MCP clients. 103 tools.

## Resources

- [Rate limits](https://docs.asterwise.com/reference/rate-limits): Per-tier monthly + burst limits.
- [Changelog](https://docs.asterwise.com/reference/changelog): All shipped changes, dated.
- [API status](https://status.asterwise.com): Live uptime and incident history.

## Pricing

- Sandbox: Free, 500 calls/month
- Builder: $39/month, 15,000 calls/month
- Launch: $99/month, 60,000 calls/month
- Scale: $249/month, 300,000 calls/month
- Enterprise: Custom

Get a key: [asterwise.com](https://asterwise.com)
Support: support@asterwise.com