HumanDesign.aiMCPOuvrir l'application ↗
POUR VOTRE IADocumentation
Outil MCP Startup

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

NomTypeObligatoireDescription
datechaîne (heure locale)OuiInstant 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.
timezonechaîneNonFuseau horaire IANA de l’instant de transit.
natalChartobjetNonDonné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.
idempotencyKeychaîneOuiClé 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.

generate_chart · get_reference_item

Haut de page ↑Besoin d'aide ? Contacter l'assistance ↗

Trouvez votre prochaine réponse.