io.github.kairosastro-sketch/mcp-ephemeris
NPM · @COSMOSOS/MCP-EPHEMERIS · SCANNED SEP 20
NASA-validated computed planetary positions for your AI: 19 astrology tools, never hallucinated.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security89
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known high-severity CVE affects tar 6.2.1, reached via swisseph > node-gyp > tar. A fixed version is available. View diagnostics → Fail
- No install/post-install scripts declared.Pass
- 73 of 188 dependencies flagged as unhealthy (8 deprecated). View diagnostics → Partial
Provenance & Transparency32
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (PolyForm-Noncommercial-1.0.0) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 60 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability74
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2290 tokens (~120/item across 19 items; 19 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management93
- Stability observed for 28 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 19 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 19 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.kairosastro-sketch/mcp-ephemeris server?
io.github.kairosastro-sketch/mcp-ephemeris runs locally as an npm package, launched with npx -y @cosmosos/mcp-ephemeris. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @cosmosos/mcp-ephemeris
claude mcp add kairosastro-sketch-mcp-ephemeris -- npx -y @cosmosos/mcp-ephemeris
{
"mcpServers": {
"kairosastro-sketch-mcp-ephemeris": {
"command": "npx",
"args": [
"-y",
"@cosmosos/mcp-ephemeris"
]
}
}
} {
"servers": {
"kairosastro-sketch-mcp-ephemeris": {
"command": "npx",
"args": [
"-y",
"@cosmosos/mcp-ephemeris"
]
}
}
} codex mcp add kairosastro-sketch-mcp-ephemeris -- npx -y @cosmosos/mcp-ephemeris
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kairosastro-sketch-mcp-ephemeris": {
"type": "local",
"command": [
"npx",
"-y",
"@cosmosos/mcp-ephemeris"
],
"enabled": true
}
}
} openclaw mcp add kairosastro-sketch-mcp-ephemeris --command npx --arg -y --arg @cosmosos/mcp-ephemeris
mcp_servers:
kairosastro-sketch-mcp-ephemeris:
command: "npx"
args: ["-y", "@cosmosos/mcp-ephemeris"] {
"McpServers": {
"kairosastro-sketch-mcp-ephemeris": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@cosmosos/mcp-ephemeris"
]
}
}
} assistant mcp add kairosastro-sketch-mcp-ephemeris -t stdio -c npx -a -y @cosmosos/mcp-ephemeris
{
"mcpServers": {
"kairosastro-sketch-mcp-ephemeris": {
"command": "npx",
"args": [
"-y",
"@cosmosos/mcp-ephemeris"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 18 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 −2
- Stability: pass → 0.80 functional
- 15 Sept 26 0
- Stability: 0.97 → pass security
- 14 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 9 Sept 26 −2
- Stability: pass → 0.80 functional
- 8 Sept 26 0
- Stability: 0.97 → pass security
- 7 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/@cosmosos/mcp-ephemeris@0.2.3
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Vulnerabilities 13 findings
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-vpq2-c234-7xj6 | CVE-2026-3449 | low | CVSS:3.1/AV:L/AC:L/PR:L/UI:N/S:U/C:N/I:N/A:L | yes |
| GHSA-23hp-3jrh-7fpw | CVE-2026-59873 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | yes |
| GHSA-34x7-hfp2-rc4v | CVE-2026-24842 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:C/C:H/I:L/A:N | yes |
| GHSA-83g3-92jg-28cx | CVE-2026-26960 | high | CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:N | yes |
| GHSA-8qq5-rm4j-mr97 | CVE-2026-23745 | high | yes | |
| GHSA-8x88-c5mf-7j5w | CVE-2026-59874 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | yes |
| GHSA-9ppj-qmqm-q256 | CVE-2026-31802 | high | yes | |
| GHSA-gvwx-54wh-qm9j | CVE-2026-59875 | medium | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:L | yes |
| GHSA-qffp-2rhf-9h96 | CVE-2026-29786 | high | yes | |
| GHSA-r292-9mhp-454m | CVE-2026-73566 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | yes |
| GHSA-r6q2-hw4h-h46w | CVE-2026-23950 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:C/C:L/I:H/A:L | yes |
| GHSA-vmf3-w455-68vh | CVE-2026-53655 | medium | yes | |
| GHSA-w8wr-v893-vjvp | CVE-2026-59871 | medium | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:L | yes |
Background: What a vulnerability scan can and cannot prove →
Dependencies 188 packages
| Packages resolved | 188 |
|---|---|
| Deprecated | 8 |
| Stale | 70 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
get_aspects ~81
Aspects (majeurs et mineurs) entre les planètes à un instant donné, avec orbe et tonalité. Grille d'aspects calculée par le moteur, pas estimée.
| Name | Type | Req | Description |
|---|---|---|---|
| datetime | string | yes | Instant en ISO 8601 UTC, ex. "2026-07-18T14:00:00Z". |
No output schema declared.
No examples provided.
get_astrocartography ~83
Astrocartographie à un instant donné : pour chaque corps, les méridiens MC/IC et le nombre de points des courbes lever/coucher, plus les parans (croisements de lignes).
| Name | Type | Req | Description |
|---|---|---|---|
| datetime | string | yes | Instant en ISO 8601 UTC, ex. "2026-07-18T14:00:00Z". |
No output schema declared.
No examples provided.
get_composite_chart ~73
Thème composite par mi-points : pour chaque corps, le point milieu circulaire entre les deux thèmes (convention Robert Hand). Représente la relation elle-même.
| Name | Type | Req | Description |
|---|---|---|---|
| personA | object | yes | Naissance de la personne A. |
| personB | object | yes | Naissance de la personne B. |
No output schema declared.
No examples provided.
get_current_sky ~69
Le ciel à l'instant présent (transits du moment) pour un lieu donné : positions en maisons + aspects.
| Name | Type | Req | Description |
|---|---|---|---|
| latitude | number | yes | Latitude en degrés décimaux (positif = Nord). |
| longitude | number | yes | Longitude en degrés décimaux (positif = Est). |
No output schema declared.
No examples provided.
get_eclipse_details ~103
Détail d'une éclipse (magnitude, obscuration, type, série de Saros) pour une date d'éclipse connue. Nécessite le moteur swisseph (retourne null en mode AstraCore).
| Name | Type | Req | Description |
|---|---|---|---|
| datetime | string | yes | Instant de l'éclipse en ISO UTC, ex. "2026-08-12T17:46:00Z". |
| kind | string | yes | Type d'éclipse à détailler. |
No output schema declared.
No examples provided.
get_engine_diagnostic ~56
Diagnostic du moteur de calcul : quel moteur est actif (swisseph sub-arcseconde vs AstraCore), si l'addon natif a chargé, et pourquoi. Utile pour vérifier la précision dont vous bénéficiez.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_ingresses ~105
Ingrès : dates auxquelles un corps change de signe sur une plage donnée (entrées/sorties de signe), robuste aux passages rétrogrades.
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | yes | Corps à suivre. |
| end | string | yes | Fin de la plage, ISO UTC. Plage max conseillée : quelques années. |
| start | string | yes | Début de la plage, ISO UTC, ex. "2026-01-01T00:00:00Z". |
No output schema declared.
No examples provided.
get_life_path ~63
Nombre du chemin de vie (numérologie pythagoricienne) calculé depuis la date de naissance locale. Fait déterministe, jamais estimé par le modèle.
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | yes | Date de naissance locale, format YYYY-MM-DD. |
No output schema declared.
No examples provided.
get_lunar_return ~181
Retour lunaire : le prochain instant, après une date de référence, où la Lune retrouve sa longitude natale (~tous les 27,3 jours), et le thème à cet instant.
| Name | Type | Req | Description |
|---|---|---|---|
| after | string | – | Chercher le retour après cet instant ISO UTC (défaut : maintenant). |
| date | string | yes | Date de naissance locale, format YYYY-MM-DD, ex. "1990-05-21". |
| latitude | number | yes | Latitude en degrés décimaux (positif = Nord). |
| longitude | number | yes | Longitude en degrés décimaux (positif = Est). |
| time | string | yes | Heure de naissance locale, format HH:mm (24 h), ex. "14:30". |
| timezone | string | yes | Fuseau IANA du lieu de naissance, ex. "Europe/Paris". |
No output schema declared.
No examples provided.
get_moon_phase ~68
Phase de la Lune (nom, illumination %, description) à un instant donné, dérivée de la position réelle Soleil/Lune.
| Name | Type | Req | Description |
|---|---|---|---|
| datetime | string | yes | Instant en ISO 8601 UTC, ex. "2026-07-18T14:00:00Z". |
No output schema declared.
No examples provided.
get_natal_chart ~275
Thème natal complet : positions en maisons, aspects, ASC/MC, phase lunaire, Lots hermétiques. Prend une date/heure LOCALE + fuseau IANA + coordonnées. Zodiaque tropical (défaut) ou sidéral (Lahiri), et système de maisons au choix (Placidus par défaut).
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | yes | Date de naissance locale, format YYYY-MM-DD, ex. "1990-05-21". |
| houseSystem | string | – | Système de maisons (défaut "placidus"). Regiomontanus/Campanus/Koch exigent le moteur swisseph ; sinon repli Placidus signalé par le champ systemeMaisons retourné. |
| latitude | number | yes | Latitude en degrés décimaux (positif = Nord). |
| longitude | number | yes | Longitude en degrés décimaux (positif = Est). |
| time | string | yes | Heure de naissance locale, format HH:mm (24 h), ex. "14:30". |
| timezone | string | yes | Fuseau IANA du lieu de naissance, ex. "Europe/Paris". |
| zodiac | string | – | Zodiaque : "tropical" (défaut, occidental) ou "sidereal" (ayanamsa Lahiri). |
No output schema declared.
No examples provided.
get_next_eclipse ~126
Trouve la prochaine (ou précédente) éclipse solaire ou lunaire à partir d'une date : instant du maximum, type, et fenêtres de contact. Nécessite le moteur swisseph (retourne null en AstraCore).
| Name | Type | Req | Description |
|---|---|---|---|
| backward | boolean | – | true = chercher la précédente au lieu de la prochaine (défaut false). |
| from | string | yes | Chercher à partir de cet instant ISO UTC, ex. "2026-01-01T00:00:00Z". |
| kind | string | yes | Type d'éclipse à chercher. |
No output schema declared.
No examples provided.
get_planet_positions ~103
Positions écliptiques géocentriques de tous les corps (Soleil→Pluton, nœuds, Lilith) à un instant donné. Calculé côté serveur par le moteur d'éphéméride — jamais estimé par le modèle.
| Name | Type | Req | Description |
|---|---|---|---|
| datetime | string | yes | Instant en ISO 8601 UTC, ex. "2026-07-18T14:00:00Z". Sans fuseau, interprété en UTC. |
No output schema declared.
No examples provided.
get_retrograde_windows ~93
Stations de rétrogradation : dates auxquelles un corps change de direction (station rétrograde ou directe) sur une plage donnée. Le Soleil et la Lune ne rétrogradent jamais.
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | yes | Corps à suivre (Mercure→Pluton). |
| end | string | yes | Fin de la plage, ISO UTC. |
| start | string | yes | Début de la plage, ISO UTC. |
No output schema declared.
No examples provided.
get_secondary_progressions ~191
Progressions secondaires (méthode « un jour après la naissance = une année de vie ») : positions planétaires progressées à une date cible. La Lune progressée (~1 signe / 2,5 ans) est la plus lue.
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | yes | Date de naissance locale, format YYYY-MM-DD, ex. "1990-05-21". |
| latitude | number | yes | Latitude en degrés décimaux (positif = Nord). |
| longitude | number | yes | Longitude en degrés décimaux (positif = Est). |
| targetDate | string | yes | Date pour laquelle progresser le thème, format YYYY-MM-DD. |
| time | string | yes | Heure de naissance locale, format HH:mm (24 h), ex. "14:30". |
| timezone | string | yes | Fuseau IANA du lieu de naissance, ex. "Europe/Paris". |
No output schema declared.
No examples provided.
get_solar_return ~224
Retour solaire d'une année donnée : l'instant exact où le Soleil retrouve sa longitude natale, et le thème dressé à cet instant (pour le lieu de résidence si fourni, sinon lieu de naissance).
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | yes | Date de naissance locale, format YYYY-MM-DD, ex. "1990-05-21". |
| latitude | number | yes | Latitude en degrés décimaux (positif = Nord). |
| longitude | number | yes | Longitude en degrés décimaux (positif = Est). |
| returnLatitude | number | – | Latitude du lieu au moment du retour (défaut : lieu de naissance). |
| returnLongitude | number | – | Longitude du lieu au moment du retour (défaut : lieu de naissance). |
| time | string | yes | Heure de naissance locale, format HH:mm (24 h), ex. "14:30". |
| timezone | string | yes | Fuseau IANA du lieu de naissance, ex. "Europe/Paris". |
| year | integer | yes | Année du retour solaire, ex. 2026. |
No output schema declared.
No examples provided.
get_synastry ~84
Synastrie : aspects inter-thèmes entre deux personnes (planètes A × planètes B), triés par orbe, avec un résumé harmonie/tension. Réutilise la table d'aspects canonique du moteur.
| Name | Type | Req | Description |
|---|---|---|---|
| personA | object | yes | Naissance de la personne A. |
| personB | object | yes | Naissance de la personne B. |
No output schema declared.
No examples provided.
get_transits ~201
Transits croisés au thème natal : aspects entre les planètes qui transitent (aujourd'hui ou à une date donnée) et les planètes de naissance, triés par orbe. Le cœur des « prévisions ».
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | yes | Date de naissance locale, format YYYY-MM-DD, ex. "1990-05-21". |
| datetime | string | – | Instant du transit en ISO UTC (défaut : maintenant), ex. "2026-07-19T09:00:00Z". |
| latitude | number | yes | Latitude en degrés décimaux (positif = Nord). |
| longitude | number | yes | Longitude en degrés décimaux (positif = Est). |
| time | string | yes | Heure de naissance locale, format HH:mm (24 h), ex. "14:30". |
| timezone | string | yes | Fuseau IANA du lieu de naissance, ex. "Europe/Paris". |
No output schema declared.
No examples provided.
validate_against_horizons ~111
Preuve d'exactitude : compare nos positions planétaires à la référence mondiale JPL Horizons (NASA) au même instant, et donne l'écart en secondes d'arc. Nécessite un accès réseau.
| Name | Type | Req | Description |
|---|---|---|---|
| bodies | array | – | Sous-ensemble de corps à valider (défaut : les 10 classiques). |
| datetime | string | yes | Instant en ISO 8601 UTC, ex. "2026-07-19T00:00:00Z". |
No output schema declared.
No examples provided.
What is the io.github.kairosastro-sketch/mcp-ephemeris server?
io.github.kairosastro-sketch/mcp-ephemeris is listed in the public MCP registry as io.github.kairosastro-sketch/mcp-ephemeris. NASA-validated computed planetary positions for your AI: 19 astrology tools, never hallucinated. This page covers its npm package (@cosmosos/mcp-ephemeris).
Is the io.github.kairosastro-sketch/mcp-ephemeris server safe to use?
io.github.kairosastro-sketch/mcp-ephemeris scores 77 out of 100 on VerifyMCP. We recorded 13 known advisories against it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.kairosastro-sketch/mcp-ephemeris server expose?
io.github.kairosastro-sketch/mcp-ephemeris exposes 19 tools: get_planet_positions, get_moon_phase, get_current_sky, get_aspects, get_natal_chart, and 14 more. Their descriptions and schemas cost roughly 2,290 tokens of context every time the server is loaded.
Is the io.github.kairosastro-sketch/mcp-ephemeris server still maintained?
io.github.kairosastro-sketch/mcp-ephemeris is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.kairosastro-sketch/mcp-ephemeris server under?
io.github.kairosastro-sketch/mcp-ephemeris declares the PolyForm-Noncommercial-1.0.0 licence, which is not on the OSI-approved list. Read the terms before using it at work, and note this covers the source only, not the cost of any service it calls.