{"id":"io.github.onedotlinks/astronest","slug":"io-github-onedotlinks-astronest","title":"AstroNest — Vedic Astrology Readings","description":"Vedic astrology readings for AI agents: life areas, compatibility, business timing, gems, ephemeris.","version":"1.2.0","publisher":{"kind":"github","id":"onedotlinks","label":"@onedotlinks on GitHub","url":"https://github.com/onedotlinks"},"website":"https://www.astronest.ai/developers/astrology-mcp-server","repository":"https://github.com/onedotlinks/astronest-quickstart","remotes":[{"type":"streamable-http","url":"https://www.astronest.ai/api/developer/mcp","headers":[{"description":"Optional. Clients with MCP sign-in (OAuth) need no key. Others send Bearer <your AstroNest API key>; free sandbox keys at https://www.astronest.ai/developer","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-11-03","updated":"2026-11-03","status":"online","auth":"","latency_ms":967,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"get_chart","title":"Natal chart (kundli)","description":"Use this when the user wants their birth chart (kundli): ascendant, planets in signs and houses, yogas, the current planetary periods, or one of the classical sub-charts.\nSidereal chart: ascendant, the nine grahas, twelve houses, yogas and the life-period (daśā) timeline. A modern Western block is added unless `western` is false. With `location`, also astrocartography lines at that place and the c","read_only":true},{"name":"get_dasha","title":"Life-period timeline (planetary periods)","description":"Use this when the user asks which planetary period (daśā) they are in, when it ends, or which periods are coming.\nThe current periods include the running pratyantardaśā; send depth 'pratyantardasha' for the full timeline at that level.\nCost: 1 credit per call (only successful calls are charged; a sandbox key is free and returns a fixed sample).\nDeterministic: the same input always gives the same a","read_only":true},{"name":"get_guidance","title":"Guidance for the running daśā periods","description":"Use this when the user asks how to conduct themselves in the period they are in: what to do and what to take care with, each with its classical reason. Guidance, not prediction.\nPlain-language guidance cards for each running daśā level (mahādaśā, antardaśā, …) at `referenceDate` (default: now).\nCost: 3 credits per call (only successful calls are charged; a sandbox key is free and returns a fixed s","read_only":true},{"name":"get_techniques","title":"Classical techniques for a chart","description":"Use this when the user or an astrologer asks for a specific classical computation — planetary strength, transit point tables, another life-period timeline, the annual chart, house cusps, a named yoga, the birth pañcāṅga, Manglik, house lords and aspects — rather than for a reading. Pass `sections` to fetch only what is needed.\nThe computed classical working for a chart, no model: strength scores f","read_only":true},{"name":"get_prashna","title":"Praśna (horary): a question, a deal, or a horary number","description":"Use this when the user asks a specific question and wants it answered from the moment of asking rather than from a birth chart — \"will this deal close?\", \"will I recover?\", \"will I find what I lost?\" — or when an astrologer gives a horary number 1–249. Send where the user is as `place`; it is never defaulted.\nThe chart of the moment and place a question is asked, read on classical praśna rules, no","read_only":true},{"name":"interpret_domain","title":"Reading of one life area","description":"Use this when the user asks what their chart says about one area of life (career, marriage, finance, health, property, children, education, travel, legal and others) and a reproducible verdict with its reasons and sources is wanted. Prefer it to get_forecast when no written narrative is needed.\nDeterministic reading of one life area: the verdict, the factors for and against it, timing windows, a c","read_only":true},{"name":"get_life_reading","title":"Whole-life reading","description":"Use this when the user wants their life as a whole: which life areas (marriage, children, career, business, money, property, family, travel, education, spirituality, health) are in focus when, across past and future, and where life stands now.\nThe life's chapters (each mahādaśā in plain words, with dates and ages) and eleven life areas, each with the planets that govern it on this chart, every gov","read_only":true},{"name":"get_domain_timeline","title":"Life-area timeline","description":"Use this when the user asks about one area of life — when marriage, children, career, money, property or another area is in focus, or what a given stretch of years holds for it.\nOne life area across the whole life: the planets that govern it on this chart, every period that bears on it (past and future, with dates, ages and why that planet governs it), each marked `primary` when the area is in foc","read_only":true},{"name":"get_relationship_reading","title":"Relationship reading (non-marital)","description":"Use this when the user asks how two people get on in a bond other than marriage — business partners, siblings, a parent and child, or friends.\nReads the bond the way the classical method reads it: the houses that govern this kind of bond and their lords in each chart, the natural significators, whose planets fall in whose governing houses, and whether that reach runs both ways, plus the running pe","read_only":true},{"name":"get_venture_timing","title":"Venture timing: when to commit, which business","description":"Use this when the user asks when to start, launch, sign, borrow or expand a business, or which line of business their chart supports.\nA calendar of the coming months in four labels — commit (sign, open, launch), build (keep building; commit only what can be undone), guarded (low fixed cost; no lease, no borrowing) and hold (no new fixed commitments) — each window with the daśā period running and t","read_only":true},{"name":"assess_gemstone","title":"Gemstone assessment","description":"Use this when the user asks whether they should wear a particular gemstone (blue sapphire, emerald, pukhraj, a crystal), or whether a stone they wear suits their chart.\nAnswers the prescription, not the future: which planet the stone strengthens, what that planet owns from this ascendant, whether a classical rule (a dusthāna or kendrādhipati lordship, a māraka) argues against strengthening it, and","read_only":true},{"name":"get_compatibility","title":"Marriage compatibility: the full reading","description":"Use this when the user asks whether two people are a good match for marriage and wants the full reading, not only a score. For the fast 36-point score with Manglik alone, use get_guna_milan.\nBoth charts read together for marriage. The 36-point Aṣṭakūṭa (guna milan) is one input: the verdict names the governing factor and says when it outweighs the score. Also returned: each chart's marital promise","read_only":true},{"name":"get_guna_milan","title":"Guna Milan (36-point Aṣṭakūṭa) and Manglik","description":"Use this when the user asks for the guna milan / kundli matching score (out of 36), or whether either person is Manglik.\nThe classical Aṣṭakūṭa match for a pair (all eight kūṭas, with the Bhakoot and Nāḍī doṣas) and Manglik for both charts reckoned from the lagna, the Moon and Venus, with mutual cancellation. The same engine as /v1/compatibility, without the full reading: the score is one input, a","read_only":true},{"name":"find_muhurta","title":"Auspicious windows (muhūrta) in a date range","description":"Use this when the user asks for an auspicious date or time (muhūrta) to do something, such as a wedding, launch, move or purchase, within a date range at a given place.\nScans each day in the range and ranks windows for the subject. The pañcāṅga is computed for `eventPlace`, never defaulted to the birthplace.\nCost: 10 credits per call (only successful calls are charged; a sandbox key is free and re","read_only":true},{"name":"get_forecast","title":"Written answer about what lies ahead","description":"Use this when the user asks an open question about what lies ahead in one area of life and wants a written answer. It takes tens of seconds; for a fast, structured verdict use interpret_domain.\nThe interpret verdict for `domain`, voiced as a narrative answer to `question` by a language model grounded in the classical statements for the domain. Expect tens of seconds; set a client timeout of at lea","read_only":true},{"name":"resolve_timing","title":"Is this a good time? (decision timing)","description":"Use this when the user asks whether now, or a particular date or range, is a good time for a decision such as changing jobs, marrying or investing. It takes tens of seconds.\nThe interpret verdict for `domain`, voiced by a language model as an answer to a decision `question`, read at `targetDate` (or the start of `dateRange`, or today when neither is sent): the verdict, the running daśā and eventTi","read_only":true},{"name":"get_ephemeris_positions","title":"Positions at a moment","description":"Use this when you need where the Sun, Moon and planets are at a moment (sidereal or tropical), not a reading.\nSun, Moon, planets and lunar nodes at one moment: longitude, latitude, distance, speed and retrograde flag, with sign, and nakṣatra and its quarter when sidereal. `equatorial: true` adds apparent right ascension and declination.\nCost: 0.1 credit per call, billed as 1 credit per started blo","read_only":true},{"name":"get_ephemeris_angles","title":"Ascendant, MC and house cusps","description":"Use this when you need the ascendant, midheaven or house cusps for a moment and place.\nAscendant, midheaven and twelve cusps for a moment and place. Placidus is undefined beyond the polar circles at some moments; the call then returns 422 houses_undefined_at_latitude.\nCost: 0.1 credit per call, billed as 1 credit per started block of 10 Ephemeris calls (only successful calls are charged; a sandbox","read_only":true},{"name":"get_ephemeris_ayanamsa","title":"Ayanamsa values","description":"Use this when you need an ayanamsa value at a moment.\nThe ayanāṁśa (the sidereal offset) at a moment, for each supported ayanāṁśa (mean, without nutation).\nCost: 0.1 credit per call, billed as 1 credit per started block of 10 Ephemeris calls (only successful calls are charged; a sandbox key is free and returns a fixed sample).\nDeterministic: the same input always gives the same answer.\nExample arg","read_only":true},{"name":"get_ephemeris_sunrise","title":"Sunrise and sunset","description":"Use this when you need sunrise and sunset for a date and place, or where the Vedic day begins.\nSunrise, sunset and the next sunrise for a local date and place: upper limb at the sea-level horizon with 36.6′ refraction. The Vedic day runs from sunrise to the next sunrise.\nCost: 0.1 credit per call, billed as 1 credit per started block of 10 Ephemeris calls (only successful calls are charged; a sand","read_only":true},{"name":"get_ephemeris_series","title":"Positions over a range","description":"Use this when you need planetary positions across a range of dates, for a transit table or to find when a planet changes sign or stations.\nPositions from start to end (inclusive) every stepMinutes, for transit tables and station finding. At most 1,000 points (too_many_points beyond). A 365-point daily table costs 4 credits.\nCost: 1 credit per started 100 points (only successful calls are charged; ","read_only":true}],"server_info":{"name":"astronest","title":"AstroNest","version":"1.1.0"},"category":"agents","tags":[],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-07","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-onedotlinks-astronest/"}