# Psychomantic : calcul astrologique et astronomique de précision pour les agents IA
# Summary: Deterministic astrology/astronomy computation engine (NASA JPL DE442 ephemeris, in-house DE442Q kernel) for AI agents and developers
# Version: 7.0.0
# Data Source: kernel quantifié maison DE442Q (dérivé de l'éphéméride NASA JPL DE442, millésime 2024, couverture 1550-2650)

## Core Identity
Psychomantic est le moteur de calcul (IshtarEngine) qui donne aux agents IA des positions
astronomiques déterministes au lieu de positions hallucinées. Précision certifiée contre JPL Horizons :
**0,052″ en moyenne / 0,095″ au maximum** (63 points, campagne rejouable).
Couverture : 1550-2650. Latence moteur : ≈ 5 µs par position en régime chaud, ~15 µs à date
arbitraire ; 1-3 ms par thème complet via l'API. Moteur 100 % maison, licence commerciale.

## Documentation et points d'entrée
- Page API (présentation humaine) : https://psychomantic.com/api/
- Référence API publique (OpenAPI) : https://api.psychomantic.com/docs
- Spécification brute (OpenAPI 3.0, sous-ensemble public) : https://api.psychomantic.com/openapi.json
- Corpus complet pour les agents (toutes les sources en un fichier) : /llms-full.txt
- État du service (public, sans clé) : https://api.psychomantic.com/health
- Serveur MCP distant : https://api.psychomantic.com/mcp
- Paquets npm : SDK — https://www.npmjs.com/package/ishtarengine-sdk · MCP — https://www.npmjs.com/package/@ishtarengine/mcp

## Domaines couverts
- Astrologie occidentale : thème natal, transits, synastrie, révolution solaire, maisons, aspects
- Astrocartographie et relocation (lignes planétaires mondiales, GeoJSON)
- Astéroïdes : Chiron, Cérès, Pallas, Junon, Vesta
- Astrologie chinoise (BaZi, signe), numérologie
- Yi King (hexagramme de naissance, méthode He Lu Li Shu / HLLS)
- Matrice du Destin (22 arcanes, octogramme, chakras, cycles annuels, programme karmique)
- Heures miroirs / triples, phase de Lune
- Interprétation littéraire : le modèle de langage ne calcule rien, il traduit le JSON du moteur

## API (produit payant, app gratuite = vitrine)
- Base URL : https://api.psychomantic.com/v1
- Auth : en-tête `X-API-Key` uniquement (une clé ne se transmet jamais dans l'URL)
- Réponse : `{ "success": true, "data": {} }`, ou `{ "success": false, "error": { "code", "message" } }`
- Quotas : en-têtes `X-Quota-Daily-*` / `X-Quota-Monthly-*` sur chaque réponse authentifiée
- Entrée publique sans clé : `GET /health`
- Endpoints de calcul (clé requise, un appel = un résultat complet) :
  - POST /v1/astro/natal        thème natal complet (planètes, maisons, aspects)
  - POST /v1/astro/transits     transits sur un thème natal
  - POST /v1/astrocartography   carte astrocartographique (GeoJSON)
  - POST /v1/asteroids          positions des 5 astéroïdes majeurs
  - GET  /v1/astro/moon-phase   phase de Lune

## MCP (Model Context Protocol)
Serveur MCP distant : `POST https://api.psychomantic.com/mcp` (streamable HTTP, en-tête
`X-API-Key` ou `Authorization: Bearer`). Le descripteur public répond en `GET` sur la même URL,
et la liste des outils fait autorité via `tools/list`.
Serveur MCP local (stdio) : paquet `@ishtarengine/mcp`, **publié sur npm** —
`npx -y @ishtarengine/mcp` l'installe et le lance ; le serveur distant ci-dessus
reste la porte zéro-installation.
Compatible : ChatGPT, Claude, Gemini, Kimi, Mistral, Grok, DeepSeek, Llama et tout client MCP.