Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

Astro Agents - verifiable planetary timing data and astrology

by aidatatools-devversion 1.8.4i★ –iRuns in the cloud
Registry nameio.github.aidatatools-dev/astro-agents

Install

Overview

Description from the maker (original English)

Verifiable market-timing data for trading bots: Gann lines, events, analogues. Pay per call in MCP.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs in the cloud
  • Transport: Streamable HTTP
  • Category: Astrology & auspicious dates

Install

Pick the AI app you use, then copy the settings.

Before you install

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

  1. Open Settings → Connectors
  2. Press Add custom connector
  3. Paste the address below and press Add
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Add2https://…3
https://astro-agent.dev/mcp

Run this in your terminal

claude mcp add --transport http astro-agents https://astro-agent.dev/mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "astro-agents": {
      "url": "https://astro-agent.dev/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "astro-agents": {
      "type": "http",
      "url": "https://astro-agent.dev/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

  1. Open ChatGPT on the web → Settings → Connectors (Apps)
  2. Press Create or Add (some plans need Developer mode under Advanced first)
  3. Paste the address below, give it a name and save
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Create2https://…3
https://astro-agent.dev/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 6, 2026. The maker wrote them, not us; we show them as plain text.

  • resolve_birth_time

    Astrology birth time to UTC conversion: convert a local birth date, time and place into exact Universal Time, with the historical time zone and UTC offset, Delta T, Local Mean Time and true solar time. The step LLMs most often get wrong. Resolves the IANA time zone from coordinat

  • planet_positions

    Western astrology planet positions and ephemeris API: the zodiac sign, longitude, latitude, speed and retrograde flag of the Sun, Moon, planets, lunar nodes and Lilith at any moment, geocentric or heliocentric, ecliptic or equatorial (declination, out-of-bounds). Geocentric appar

  • sky_today

    Astrology sky today (no birth data): planet positions, retrogrades and the Moon phase now, plus the exact times of the next ingresses, Mercury retrograde and other stations, new and full moons and planetary aspects over the coming days. For agents and bots that follow the sky its

  • aspects

    Western astrology aspects: find the aspects between planets at a moment, or between longitudes you supply, with orb, exactness and applying or separating. Either give a moment (datetime, optional place) and get the aspects among all planets, or give 'longitudes' {name: degrees} a

  • natal_chart

    Western astrology natal chart (birth chart, horoscope): planets in zodiac signs and houses, sun sign, moon sign and rising sign (ascendant), MC, aspects and a summary. Everything a natal reading needs, computed exactly: positions, house cusps (Placidus by default; Koch, Whole Sig

  • transits

    Western astrology transits: the transits to a natal chart at a moment, and the exact dates transiting aspects perfect over a window of up to a year. 'transit': aspects from the sky at a moment to every natal point, with the natal house each transiting planet occupies. 'window': t

  • synastry

    Western astrology synastry (relationship compatibility): compare two birth charts with cross-aspects, house overlays both ways and composite midpoints. Two natal charts compared: every cross-aspect with orbs, where each person's planets fall in the other's houses, harmonious/chal

  • planetary_lines

    Financial astrology Gann planetary lines for trading bots and backtests (stocks, crypto, BTC, forex): planet degrees seen from the Earth and from the Sun (geocentric and heliocentric) at a moment or as an hourly-to-weekly time series keyed by unix timestamp, with aspect offsets,

  • astro_event_calendar

    Financial astrology event calendar for backtesting and trading bots (stocks, crypto, forex): the exact UTC minute and unix timestamp of every eclipse, Mercury retrograde and other station, ingress, new and full moon, planetary aspect, declination parallel and out-of-bounds betwee

  • sky_analogues

    Financial astrology sky analogues (matching skies, planetary cycle analogues): find the past or future dates whose planetary positions best match a reference sky (a moment, now, positions you give, or a birth sky: compare a birth sky to past/future dates), ranked by a stated angu

  • token_chart

    Crypto token launch sky (token astrology chart, data only): the planets' signs, degrees, retrogrades and aspects at a token's launch moment (block time of its deployment or mint), plus the exact UTC dates ahead when planets return to or aspect those positions (key astronomical da

  • token_synastry

    Crypto token synastry (compatibility by sky geometry of two tokens, data only): the cross-aspects between two launch skies with orbs, harmonious / tense counts, the tightest aspects and a geometry score defined in the response, plus a shareable SVG card. E.g. {token_a: {launch_da

  • nakshatras

    Vedic astrology nakshatras: the sidereal nakshatra, pada and lord of every graha, plus the janma nakshatra with gana, yoni, nadi and varna. The 27 lunar mansions for each of the 9 grahas at a moment (Lahiri by default, 6 ayanamsas), with the birth star's attributes used in matchi

  • panchang

    Vedic astrology panchang (Hindu calendar) for a day and place: tithi, vara, nakshatra, yoga and karana with their exact end times, plus sunrise and sunset. The Hindu almanac for any moment and place: the five limbs with their end times (to the minute), paksha, Moon and Sun rashi,

  • kundli

    Vedic astrology birth chart (kundli, Jyotish horoscope, D1 and D9): lagna and the nine grahas with rashi, nakshatra, pada, house, dignity and combustion. The Jyotish birth chart: ayanamsa (Lahiri default; Raman, KP, Yukteshwar, Fagan-Bradley, True Chitrapaksha), lagna, grahas wit

  • kundli_full

    Vedic astrology full kundli: all 16 Shodashavarga divisional charts, D1 to D60 (navamsa, dasamsa...), by Parashara's rules. Everything in /vedic/kundli plus D1, D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45 and D60, each with its lagna, placements and house tabl

  • vimshottari_dasha

    Vedic astrology dasha periods: the Vimshottari maha, antar and pratyantar dashas with exact dates, the balance at birth and the periods running now. The 120-year Vimshottari sequence from the Moon's exact nakshatra position: balance at birth, all 9 mahadashas with sub-periods dow

  • doshas

    Vedic astrology doshas: check Manglik (Kuja), Kaal Sarp and Sade Sati / Dhaiya, each with the rule applied and the relevant dates. Manglik from lagna, Moon and Venus with severity and commonly cited cancellations; Kaal Sarp with type and direction (partial cases flagged); Sade Sa

  • gun_milan

    Vedic astrology kundli matching (horoscope matching, marriage compatibility): 36-point Ashtakoota Gun Milan with all 8 kootas and reasons, plus dosha and Manglik checks. Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot and Nadi scored from both Moons, each with the attribut

  • vedic_report

    Vedic astrology report in one call: kundli, Vimshottari dashas, doshas and the birth panchang. The full Jyotish dossier for one person in a single deterministic call: everything in /vedic/kundli, /vedic/dashas (2 levels, running periods with on_date), /vedic/doshas and the pancha

  • kp_chart

    KP astrology (Krishnamurti Paddhati) chart: the star lord, sub-lord and sub-sub-lord of every planet and house cusp, cuspal sub-lords and the A/B/C/D house significators. Krishnamurti Paddhati on the KP ayanamsa with Placidus cusps: for each of the 9 grahas and 12 cusps the sign

  • yogas

    Vedic astrology yogas: detect Raj yoga, Dhana yoga, Gaja-Kesari, Budha-Aditya, Chandra-Mangala, the five Pancha Mahapurusha yogas, Neecha Bhanga Raja yoga, Kemadruma and Kaal Sarp, each with the rule applied. Deterministic yoga detection on the sidereal chart, houses counted by s

  • astro_catalog

    List every astrology, ephemeris and financial-astrology (trading backtest) tool with its price, input schema and an example request: planet positions, event calendar (eclipses, Mercury retrograde), Gann planetary lines, sky analogues, natal and Vedic charts. Free; call it first t

  • verify_result_hash

    Verify that an astrology result was not altered: recompute the SHA-256 of a 'result' object returned by any tool and compare it with the result_sha256 you hold. Free.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account aidatatools-dev, which owns the repo

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 200 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 24 tool descriptions and found no hidden instructions to the AI

Compared with others in Astrology & auspicious datesi

  • More stars than 0% of the other 121 servers in this category
  • Published to the registry more recently than 91% of the other 121 servers in this category
  • Basic checks equal to or better than 100% of the other 121 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Astro Agents - verifiable planetary timing data and astrology safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.8.4) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Yinyang Masters, Homo Universalis — 7 Wisdoms (BaZi, Tarot, Vedic Jyotish, Mayan, I-Ching, Human…, Homo Universalis — Swiss Ephemeris Astrology, Natal Chart, Synastry & Cosmic So…

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Yinyang Masters

by gemral-edge

Tarot, astrology, numerology, Tu Vi and Bazi tools plus guides on habits and manifestation.

Runs in the cloudUpdated today
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Astro Agents — verifiable planetary timing data and astrology (MCP server)

Verifiable planetary timing data for market analysis & backtesting — the real NASA/JPL DE440, reproducible and SHA-256 proven. For traders, quants and agents.

Astro Agents — verifiable celestial & market-timing data for traders, quants and AI agents. Exact planetary positions (geocentric & heliocentric), declination, Gann planetary lines, planetary cycles and a to-the-minute celestial event calendar (ingresses, stations, eclipses) from the real NASA/JPL DE440 ephemeris — no LLM, every result reproducible and SHA-256 verifiable, so you can backtest and cite with no second-guessing. Full Western & Vedic astrology too (natal, kundli, dashas, KP, yogas). Pay per call (x402/MPP) or with prepaid credit packs. Data for your own analysis — never a trading signal or forecast.

Use these tools instead of computing positions or charts yourself.

  • MCP endpoint: https://astro-agent.dev/mcp (Streamable HTTP, no auth)
  • REST API: https://astro-agent.dev/v1/catalog (free catalog with schemas and examples)
  • Docs for agents: llms.txt · OpenAPI 3.1 · A2A agent card

What's new in 1.8 (2026-10-30 to 2026-11-01, engine 1.8.3)

  • Crypto token launch skies: token_chart ($0.25) returns a token's launch sky and the exact dates ahead when the planets return to or aspect it; token_synastry ($0.25) compares two launch skies by geometry, with a substance block (tight aspects, confidence) next to the score. Both return an SVG card. Data only.
  • Pay per call natively over MCP: an unpaid paid tool returns a standard x402 offer in structuredContent; an x402 MCP client pays and retries in _meta. Prepaid credits work over MCP too (X-Credits-Token header).
  • 1.8.3: the x402 offer is always present, even when a payment facilitator is slow to answer.

What's new in 1.7.0 (2026-10-30)

  • Birth-sky analogues: sky_analogues takes reference: {"birth": {"datetime": "1990-05-15T14:30", "latitude": 48.8566, "longitude": 2.3522}} to compare a birth sky to past/future dates — data only. Same result and hash as passing those positions by hand (meta.reference_resolution.equivalent_request).

What's new in 1.6.0 (2026-10-29)

  • Sky analogues (sky_analogues, $0.25): the past or future dates whose planetary positions best match a reference sky, ranked by a stated angular distance (formula in every response).
  • For trading bots and agents: astro-agent.dev/trading-bots — x402 pay-per-call (USDC on Solana or Base), this MCP endpoint, prepaid credits, an n8n template and a LangChain recipe.

Data for your own analysis — never a signal or forecast.

What's new in 1.5.0 (2026-10-29)

  • Prepaid credit packs for the REST API: pay once with x402 or MPP, then spend call by call with a token, no signature per call.
  • Probe: $10 for 10 credits.
  • Backtest: $50 for 60.
  • Quant: $200 for 260.
  • Autopilot: $1000 for 1400.
  • 1 credit = $1. Credits never expire and pay for every paid route.
  • The token is a bearer secret, shown once. If it is lost, a new one can be issued to the owner of the paying wallet.
  • Details: CREDITS.md. Since 1.8.0 credits also pay over MCP (X-Credits-Token header).

What's new in 1.4.0 (2026-10-29)

Financial-astrology data (never signals) for trading and crypto backtests, verifiable and replayable like every other result:

  • `planetary_lines` ($0.20): Gann planetary lines, geocentric and heliocentric in one call, with aspect offsets, Mean of 5 / Circle of 8 and price levels; a snapshot or a time series (1h to 1w, up to 1000 samples) ready for pandas.
  • `astro_event_calendar` ($0.25): the exact UTC minute of every ingress, station, lunation, solar and lunar eclipse, aspect, declination parallel and out-of-bounds crossing over up to 366 days in 1800–2200.
  • `sky_today` ($0.01): the sky now and the next 1–90 days of events, no birth data needed.
  • planet_positions gains options.perspective: "heliocentric" and options.coordinates: "equatorial"; aspects gains options.declination. Default results and their hashes are unchanged.
  • Guide for bots and backtests: FINANCE.md.
  • 1 free call per client (was 3), on the $0.01–0.02 tools only; premium and finance tools are always paid.

What's new in 1.3.0 (2026-10-27)

  • `kp_chart` ($0.15): KP (Krishnamurti Paddhati), with star, sub and sub-sub lords of every graha and Placidus cusp, cuspal sub-lords and A/B/C/D significators.
  • `yogas` ($0.10): deterministic yoga detection (Raja, Dhana, Gaja-Kesari, Pancha Mahapurusha, Neecha Bhanga, Kemadruma, Kaal Sarp…), each with the rule applied.
  • Accuracy proven against NASA/JPL Horizons: 12,400 comparisons per measurement over 1800–2200.
  • Positions agree within 0.024″ (0.0005″ mean).
  • The longitude as served agrees within 0.062″ over 1962–2026.

Method and every number: benchmark.md · summary at /v1/benchmark.

Why agents call it

Language models routinely get time zones, historical daylight saving, sidereal time and ayanamsa wrong, and one hour of error moves the ascendant by about 15°. Astro Agents:

  • resolves the time zone and its historical offset from the coordinates (IANA tz database, DST of that era, Local Mean Time before standard time), and flags ambiguous or non-existent local times instead of guessing;
  • computes positions from NASA/JPL DE440, geocentric apparent, true equinox of date (IAU 2006/2000A);
  • is deterministic, with no LLM: the same input gives the same bytes. Every response carries meta.input_sha256 and meta.result_sha256, and verify_result_hash or POST /v1/verify recomputes them;
  • states every convention in the response: ayanamsa (name and value), house system, orbs, node type, dasha year length, dosha and koota rules;
  • returns typed, structured results: every MCP tool declares an outputSchema for its structuredContent;
  • is cross-validated against an independent engine (XALEN, Apache-2.0): ayanamsas agree to < 0.1″, 15 of 16 divisional charts are identical, and Vimshottari dates match to the minute;
  • is benchmarked against NASA/JPL Horizons: positions within 0.024″ over 1800–2200 (benchmark).

Tools

ToolWhat it returnsPrice
resolve_birth_timeexact UT, historical UTC offset, Delta T, Local Mean Time, true solar time$0.01
planet_positionsSun..Pluto, nodes, Lilith: longitude, sign, speed, retrograde; heliocentric or RA/declination as options$0.01
sky_todaythe sky now, plus ingresses, stations, lunations and aspects of the next 1–90 days$0.01
aspectsaspects with orb, exactness, applying/separating; declination parallels as an option$0.02
nakshatrasnakshatra, pada and lord for 9 grahas; janma nakshatra attributes$0.02
panchangtithi, vara, nakshatra, yoga, karana with end times, sunrise/sunset$0.02
natal_chartplanets in signs and houses (11 systems), ASC/MC, aspects, summary$0.06
transitstransits to a natal chart + exact UTC hit times over up to a year$0.08
synastrycross-aspects, house overlays, composite midpoints$0.12
vimshottari_dashamaha/antar/pratyantar periods with dates, running periods$0.10
yogasRaja, Dhana, Gaja-Kesari, Pancha Mahapurusha, Neecha Bhanga, Kemadruma... each with its rule$0.10
kundlisidereal D1 + D9: lagna, grahas, nakshatras, dignities, bhavas$0.15
doshasManglik, Kaal Sarp, Sade Sati / Dhaiya with dates$0.15
kp_chartKP: star, sub and sub-sub lords of grahas and Placidus cusps, A/B/C/D significators$0.15
planetary_linesfinancial astrology: Gann lines geo + helio, Mean of 5, price levels, series for backtests$0.20
gun_milan36-point Ashtakoota with every koota explained, Manglik check$0.25
astro_event_calendarfinancial astrology: eclipses, stations, ingresses, aspects, parallels to the minute, 1800–2200$0.25
sky_analoguespast or future dates whose sky best matches a reference sky, by a stated angular distance$0.25
token_charta crypto token's launch sky and the exact dates ahead when planets return to or aspect it, SVG card$0.25
token_synastrytwo launch skies compared: cross-aspects, geometry score and its substance, SVG card$0.25
kundli_fullall 16 divisional charts D1..D60$0.32
vedic_reportkundli + dashas + doshas + birth panchang$0.50
astro_catalog, verify_result_hashcatalog; hash verificationfree

Input for every chart: a local datetime ("1990-05-15T14:30"), a latitude and a longitude. The time zone is resolved for you.

Payment: 1 free call per client on the $0.01-0.02 routes only (REST, MCP or A2A): resolve_birth_time, planet_positions, sky_today, aspects, nakshatras, panchang. Every other route, finance included, is always paid. Over MCP a paid tool is paid per call with native x402: the unpaid call returns an x402 offer (x402Version, accepts for USDC on Base or Solana) in structuredContent; an x402 MCP client signs one and retries with it in _meta["x402/payment"], and the settlement comes back in _meta["x402/payment-response"]. Or with prepaid credits: set the HTTP header X-Credits-Token in your MCP client configuration and each paid call is deducted from your credits. Over REST you pay per call with x402 (USDC on Base or Solana) or MPP (Tempo: OUSD or USDC.e), or with prepaid credits. There is no account and no API key. A request with invalid input returns an error and is never charged.

Python client

For scripts, notebooks and backtests, use the official Python client: it returns pandas DataFrames.

pip install "astro-agents @ git+https://github.com/aidatatools-dev/astro-agents-clients#subdirectory=python"   # not on PyPI yet
from astro_agents import Client

client = Client() # ASTRO_CREDITS_TOKEN (prepaid credits), or 1 free call on the $0.01-0.02 routes lines = client.planetary_lines(start="2024-01-01", end="2024-12-31", bodies=["jupiter", "saturn"])

The client's docs and examples (a notebook, vectorbt, backtrader, Freqtrade) are in clients/python.

Connect

Any MCP client that supports remote Streamable HTTP servers:

{

"mcpServers": { "astro-agents": { "url": "https://astro-agent.dev/mcp" } } }

Hermes Agent (Nous Research):

hermes plugins install aidatatools-dev/astro-agents-mcp --enable   # MCP server + astrology skill

Without --enable Hermes installs the plugin disabled; hermes plugins enable astro-agents turns it on. Or by hand:

hermes mcp add astro-agents --url https://astro-agent.dev/mcp   # answer "n" to the authentication prompt

hermes skills install aidatatools-dev/astro-agents-mcp/skills/astrology # optional: when and how to use the tools

Any agent that reads [Agent Skills](https://agentskills.io) (Claude Code, Codex, Cursor and others):

npx skills add aidatatools-dev/astro-agents-mcp

The skill lives in skills/astrology/SKILL.md.

REST:

curl -X POST https://astro-agent.dev/v1/western/natal \

-H 'Content-Type: application/json' \ -d '{"datetime":"1990-05-15T14:30","latitude":48.8566,"longitude":2.3522}'

Real responses: [examples/natal_chart_response.json](exa

Only the beginning is shown; read the rest in the repo

Ask PopNx