MCP.Market

Ephemeris MCP server

by kairosastro-sketch·io.github.kairosastro-sketch/mcp-ephemeris·v0.2.3
No reviews yet

NASA-validated computed planetary positions for your AI: 19 astrology tools, never hallucinated.

A85/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A85/100

full report

Adoption
New

0 stars29 downloads/wk

Reviews

Write one

Nobody has reviewed Ephemeris yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Ephemeris tools (19)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_aspects

    Aspects (majeurs et mineurs) entre les plan\xE8tes \xE0 un instant donn\xE9, avec orbe et tonalit\xE9. Grille d'aspects calcul\xE9e par le moteur, pas estim\xE9e.

  • get_astrocartography

    Astrocartographie \xE0 un instant donn\xE9 : pour chaque corps, les m\xE9ridiens MC/IC et le nombre de points des courbes lever/coucher, plus les parans (croisements de lignes).

  • get_composite_chart

    Th\xE8me composite par mi-points : pour chaque corps, le point milieu circulaire entre les deux th\xE8mes (convention Robert Hand). Repr\xE9sente la relation elle-m\xEAme.

  • get_current_sky

    Le ciel \xE0 l'instant pr\xE9sent (transits du moment) pour un lieu donn\xE9 : positions en maisons + aspects.

  • get_eclipse_details

    D\xE9tail d'une \xE9clipse (magnitude, obscuration, type, s\xE9rie de Saros) pour une date d'\xE9clipse connue. N\xE9cessite le moteur swisseph (retourne null en mode AstraCore).

  • get_engine_diagnostic

    Diagnostic du moteur de calcul : quel moteur est actif (swisseph sub-arcseconde vs AstraCore), si l'addon natif a charg\xE9, et pourquoi. Utile pour v\xE9rifier la pr\xE9cision dont vous b\xE9n\xE9ficiez.

  • get_ingresses

    Ingr\xE8s : dates auxquelles un corps change de signe sur une plage donn\xE9e (entr\xE9es/sorties de signe), robuste aux passages r\xE9trogrades.

  • get_life_path

    Nombre du chemin de vie (num\xE9rologie pythagoricienne) calcul\xE9 depuis la date de naissance locale. Fait d\xE9terministe, jamais estim\xE9 par le mod\xE8le.

  • get_lunar_return

    Retour lunaire : le prochain instant, apr\xE8s une date de r\xE9f\xE9rence, o\xF9 la Lune retrouve sa longitude natale (~tous les 27,3 jours), et le th\xE8me \xE0 cet instant.

  • get_moon_phase

    Phase de la Lune (nom, illumination %, description) \xE0 un instant donn\xE9, d\xE9riv\xE9e de la position r\xE9elle Soleil/Lune.

  • get_natal_chart

    Th\xE8me natal complet : positions en maisons, aspects, ASC/MC, phase lunaire, Lots herm\xE9tiques. Prend une date/heure LOCALE + fuseau IANA + coordonn\xE9es. Zodiaque tropical (d\xE9faut) ou sid\xE9ral (Lahiri), et syst\xE8me de maisons au choix (Placidus par d\xE9faut).

  • get_next_eclipse

    Trouve la prochaine (ou pr\xE9c\xE9dente) \xE9clipse solaire ou lunaire \xE0 partir d'une date : instant du maximum, type, et fen\xEAtres de contact. N\xE9cessite le moteur swisseph (retourne null en AstraCore).

  • get_planet_positions

    Positions \xE9cliptiques g\xE9ocentriques de tous les corps (Soleil\u2192Pluton, n\u0153uds, Lilith) \xE0 un instant donn\xE9. Calcul\xE9 c\xF4t\xE9 serveur par le moteur d'\xE9ph\xE9m\xE9ride \u2014 jamais estim\xE9 par le mod\xE8le.

  • get_retrograde_windows

    Stations de r\xE9trogradation : dates auxquelles un corps change de direction (station r\xE9trograde ou directe) sur une plage donn\xE9e. Le Soleil et la Lune ne r\xE9trogradent jamais.

  • get_secondary_progressions

    Progressions secondaires (m\xE9thode \xAB un jour apr\xE8s la naissance = une ann\xE9e de vie \xBB) : positions plan\xE9taires progress\xE9es \xE0 une date cible. La Lune progress\xE9e (~1 signe / 2,5 ans) est la plus lue.

  • get_solar_return

    Retour solaire d'une ann\xE9e donn\xE9e : l'instant exact o\xF9 le Soleil retrouve sa longitude natale, et le th\xE8me dress\xE9 \xE0 cet instant (pour le lieu de r\xE9sidence si fourni, sinon lieu de naissance).

  • get_synastry

    Synastrie : aspects inter-th\xE8mes entre deux personnes (plan\xE8tes A \xD7 plan\xE8tes B), tri\xE9s par orbe, avec un r\xE9sum\xE9 harmonie/tension. R\xE9utilise la table d'aspects canonique du moteur.

  • get_transits

    Transits crois\xE9s au th\xE8me natal : aspects entre les plan\xE8tes qui transitent (aujourd'hui ou \xE0 une date donn\xE9e) et les plan\xE8tes de naissance, tri\xE9s par orbe. Le c\u0153ur des \xAB pr\xE9visions \xBB.

  • validate_against_horizons

    Preuve d'exactitude : compare nos positions plan\xE9taires \xE0 la r\xE9f\xE9rence mondiale JPL Horizons (NASA) au m\xEAme instant, et donne l'\xE9cart en secondes d'arc. N\xE9cessite un acc\xE8s r\xE9seau.

Public scan report

scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 66 days ago12/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Ephemeris compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
85/100
higher than 70% of 48,255 servers
Tools
19
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
29
more than 16% of 12,191 servers with a package

What its tools let an agent do: 19 read

Install Ephemeris in Claude Code, Cursor or VS Code

Runs npx -y @cosmosos/mcp-ephemeris on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-ephemeris -- npx -y @cosmosos/mcp-ephemeris
Add to Cursor

What the publisher says

From the Ephemeris repository's README, as published. We do not edit it. Read it on GitHub

@cosmosos/mcp-ephemeris

The real sky, for your AI. An MCP server that gives any assistant (Claude, Cursor, agents) computed planetary positions — never guessed — powered by the Swiss Ephemeris engine, and validated against JPL Horizons (NASA) to under one arcsecond.

Cardinal rule: the LLM never computes. This server is a facade over an

ephemeris engine. The model interprets; the sky is a fact.

(Version française : )

Quick start (Claude Desktop)

Open Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "llmastro": {
      "command": "npx",
      "args": ["-y", "@cosmosos/mcp-ephemeris"]
    }
  }
}

Fully quit Claude Desktop (system tray) and relaunch it. Then ask: "What's the moon phase today?" — Claude calls the server and answers from genuinely computed positions.

Cursor / Windsurf / others: add the same llmastro entry (command: npx, args: ["-y", "@cosmosos/mcp-ephemeris"]) to your client's MCP configuration.

Tools exposed

19 tools, all backed by the same server-side computed engine.

Positions & sky

Natal chart & relationships

Celestial events

Astrocartography, numerology, authority

(swisseph) = requires the native Swiss Ephemeris addon; returns null on the AstraCore fallback.

Precision

Under Swiss Ephemeris, positions match the world reference JPL Horizons (NASA) to under one arcsecond (measured 2026-07-19):

Check it yourself with the validateagainsthorizons tool.

Two engines

Computation is routed by the ASTRO_ENGINE variable:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Ephemeris: common questions

Is Ephemeris MCP server safe?
Yes, by our scan: it is graded A (85/100). Read the Ephemeris safety report
How do I install Ephemeris?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Ephemeris need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Ephemeris maintained?
The last commit was 106 days ago (2026-07-21). The latest release is v0.2.3.
How does Ephemeris compare with other MCP servers?
safety score 85/100 (higher than 70% of 48,255 servers); tools 19 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.