get_transits
Utilisez le champ contractuel natalChart pour fournir les données bodygraph sous-jacentes, puis demandez le contexte de transit actuel ou à une date précise. L’identifiant littéral est conservé pour la compatibilité de l’API.
Résultat pour le développeur : Créez des expériences d’agent tenant compte du temps sans calculer les positions planétaires dans le client.
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
date | chaîne (heure locale) | Oui | Instant de transit explicite exprimé en heure locale dans le fuseau horaire fourni, sans Z ni décalage UTC. MCP l’exige afin qu’une tentative avec la même clé désigne le même instant. Il peut se situer dans le futur. |
timezone | chaîne | Non | Fuseau horaire IANA de l’instant de transit. |
natalChart | objet | Non | Données de naissance bodygraph facultatives avec birthDateTime et timezone. birthDateTime est une heure locale sans Z ni décalage UTC. Le nom du champ fait partie du contrat backend. |
idempotencyKey | chaîne | Oui | Clé stable pour ce calcul de transit prévu. Réutilisez-la uniquement avec des arguments identiques lors d’une nouvelle tentative. |
Les heures de naissance sont des heures locales telles qu’affichées par l’horloge. Indiquez la date et l’heure de naissance telles qu’elles apparaissaient sur l’horloge du lieu de naissance, sans Z ni décalage UTC, et indiquez séparément le fuseau sous forme d’identifiant IANA. « birthDateTime » : « 1990-05-15T14:30:00 » avec « timezone » : « America/New_York » signifie quatorze heures trente à New York.
Obsolète : Les valeurs se terminant par Z ou par un décalage numérique sont obsolètes. MCP les transmet et l’API les accepte encore pour le moment en les interprétant comme UTC ; la dépréciation est signalée dans la réponse de l’API. Elles ne seront plus acceptées, et la date sera annoncée à l’avance. Lire la règle complète.
Requête
JSON-RPC assaini
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "get_transits",
"arguments": {
"date": "2026-08-06T12:00:00",
"timezone": "UTC",
"natalChart": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York"
},
"idempotencyKey": "transits-2026-08-06-v1"
}
}
}Format de réponse en cas de succès
- Positions planétaires de transit
- Portes et canaux activés
- Connexions aux données bodygraph fournies
La réponse comprend également les métadonnées de niveau et de quota fournies par la couche de droits de l’API. Les champs exacts varient selon l’outil et le niveau de détail demandé.
Erreurs
- Niveau Startup requis
- Données bodygraph invalides
- Date de transit invalide
- Quota dépassé
Comportement du quota
Après validation des données, autorisation et vérification du niveau, une tentative d’exécution qui atteint le fournisseur de calcul consomme exactement une unité API partagée, même si une étape de présentation ultérieure échoue. Les données mal formées ou ambiguës, les niveaux refusés, les références inconnues et les autres échecs avant le fournisseur consomment zéro unité. Vérifiez l’utilisation actuelle sur my.humandesign.ai.