# AstroNest Developer API

> Vedic (Jyotiṣa) astrology over a JSON API and an MCP server: kundli (sidereal birth chart), life periods (daśā), guna milan (36-point Aṣṭakūṭa) and Manglik, compatibility, muhūrta (auspicious windows), praśna (horary), readings in classical Vedic methodology computed by a deterministic Jyotish engine, and a NASA JPL DE440 ephemeris. Free sandbox keys; a live key starts with 100 free credits, then credit packs.

Readings are symbolic interpretation, not medical, legal, financial or psychological advice. Every chart, period and reading an assistant shows must come from an API result, never be invented.

Base URL: https://www.astronest.ai/api/developer · Auth: `Authorization: Bearer <key>` · All endpoints are POST with a JSON body.

## Docs
- [API reference](https://www.astronest.ai/developers): every endpoint, field, price and error
- [OpenAPI 3 spec](https://www.astronest.ai/openapi/astronest-v1.json): machine-readable, generate a client in any language
- [OpenAPI, Postman and MCP guide](https://www.astronest.ai/developers/openapi): import into tools, connect AI apps
- [Get a key](https://www.astronest.ai/developer): sandbox keys are free with no time limit
- [Full text for LLMs](https://www.astronest.ai/llms-full.txt): this file plus every endpoint's description and required fields

## MCP server
- Remote MCP endpoint: https://www.astronest.ai/api/developer/mcp (Streamable HTTP). Authenticate with `Authorization: Bearer <key>`, or sign in (OAuth 2.1): Claude and ChatGPT open AstroNest sign-in on the first tool call
- Sign-in: choose Sandbox (free fixed samples) or Live (real results, billed to your credits, optional monthly credit limit). Disconnect any time under Connected apps in the developer portal
- Official MCP Registry name: io.github.onedotlinks/astronest
- Claude Code: `claude mcp add --transport http astronest https://www.astronest.ai/api/developer/mcp --header "Authorization: Bearer YOUR_KEY"`

## Guides by use case
- [Kundli API](https://www.astronest.ai/developers/kundli-api): Generate a Vedic kundli (sidereal birth chart) and the life-period (daśā) timeline over a JSON API. Positions from NASA JPL DE440. Free sandbox key, then pay per call.
- [Guna Milan and kundli matching API](https://www.astronest.ai/developers/guna-milan-api): Kundli matching over a JSON API: the 36-point Aṣṭakūṭa guna milan with every kūṭa, Manglik from the lagna, Moon and Venus, and a full compatibility reading. For matrimony and dating apps.
- [Muhūrta API](https://www.astronest.ai/developers/muhurta-api): Find auspicious windows (muhūrta) for a wedding, griha pravesh, signing or launch in a date range, computed at the event's place, ranked for the person. JSON API with a free sandbox key.
- [Praśna (horary) API](https://www.astronest.ai/developers/prashna-api): Answer a question from the moment it is asked: Vedic praśna over a JSON API, including deal questions and horary numbers (1–249). Free sandbox key.
- [Ephemeris API on NASA JPL DE440](https://www.astronest.ai/developers/ephemeris-api): Planetary positions, ascendant and house cusps, ayanamsa, sunrise and sunset, and position series from NASA JPL DE440. Tropical or sidereal. No Swiss Ephemeris licence needed.
- [Vedic astrology MCP server](https://www.astronest.ai/developers/astrology-mcp-server): Give Claude, Cursor or your own AI app real Vedic charts: the AstroNest MCP server exposes the kundli, daśā, guna milan, muhūrta, praśna and readings as tools, so the model stops inventing planets and dates.

## Endpoints

- [POST /v1/chart](https://www.astronest.ai/developers#chart): Natal chart (kundli) (1 credit)
- [POST /v1/dasha](https://www.astronest.ai/developers#dasha): Life-period timeline (planetary periods) (1 credit)
- [POST /v1/guidance](https://www.astronest.ai/developers#guidance): Guidance for the running daśā periods (3 credits)
- [POST /v1/techniques](https://www.astronest.ai/developers#techniques): Classical techniques for a chart (3 credits)
- [POST /v1/prashna](https://www.astronest.ai/developers#prashna): Praśna (horary): a question, a deal, or a horary number (3 credits)
- [POST /v1/interpret](https://www.astronest.ai/developers#interpret): Reading of one life area (5 credits)
- [POST /v1/life-reading](https://www.astronest.ai/developers#life-reading): Whole-life reading (10 credits)
- [POST /v1/domain-timeline](https://www.astronest.ai/developers#domain-timeline): Life-area timeline (3 credits)
- [POST /v1/relationship](https://www.astronest.ai/developers#relationship): Relationship reading (non-marital) (8 credits)
- [POST /v1/venture-timing](https://www.astronest.ai/developers#venture-timing): Venture timing: when to commit, which business (10 credits)
- [POST /v1/gem-assessment](https://www.astronest.ai/developers#gem-assessment): Gemstone assessment (5 credits)
- [POST /v1/compatibility](https://www.astronest.ai/developers#compatibility): Marriage compatibility: the full reading (12 credits)
- [POST /v1/guna-milan](https://www.astronest.ai/developers#guna-milan): Guna Milan (36-point Aṣṭakūṭa) and Manglik (2 credits)
- [POST /v1/muhurta](https://www.astronest.ai/developers#muhurta): Auspicious windows (muhūrta) in a date range (10 credits)
- [POST /v1/forecast](https://www.astronest.ai/developers#forecast): Written answer about what lies ahead (8 credits)
- [POST /v1/timing/resolve](https://www.astronest.ai/developers#timing-resolve): Is this a good time? (decision timing) (7 credits)
- [POST /v1/ephemeris/positions](https://www.astronest.ai/developers#ephemeris-positions): Positions at a moment (0.1 credits)
- [POST /v1/ephemeris/angles](https://www.astronest.ai/developers#ephemeris-angles): Ascendant, MC and house cusps (0.1 credits)
- [POST /v1/ephemeris/ayanamsa](https://www.astronest.ai/developers#ephemeris-ayanamsa): Ayanamsa values (0.1 credits)
- [POST /v1/ephemeris/sunrise](https://www.astronest.ai/developers#ephemeris-sunrise): Sunrise and sunset (0.1 credits)
- [POST /v1/ephemeris/series](https://www.astronest.ai/developers#ephemeris-series): Positions over a range (1 credit)

## Optional
- [Full endpoint descriptions](https://www.astronest.ai/llms-full.txt)