Model Context Protocol

L’Occult API dans votre assistant IA

Connectez Claude, Cursor ou tout assistant compatible MCP à de vraies données d’éphémérides. Demandez un panchanga, une kundli ou une dasha en langage courant, et obtenez un vrai calcul, pas une invention qui a l’air plausible.

vous :  Quel est le panchanga de Jaipur demain au lever du soleil ?

        → tithi Chaturthi (Krishna paksha), yoga Vriddhi, karana Balava

Avant de commencer

Il vous faut une clé API. Créez un compte et générez-en une depuis la page Clés. Elle ne s’affiche qu’une fois : copiez-la avant de quitter la page. Seule autre condition : Node 18 ou plus récent. npx télécharge le reste au premier lancement.

Installation

Tous les clients utilisent le même bloc. Ajoutez-le au fichier ci-dessous. Si le fichier contient déjà une section mcpServers, placez occult-api à l’intérieur au lieu d’en ajouter une deuxième.

{
  "mcpServers": {
    "occult-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "occult-api-mcp"],
      "env": { "OCCULT_API_KEY": "yt_live_your_key_here" }
    }
  }
}

Claude Code (VS Code)~/.claude.jsonC:Users<you>.claude.json sous Windows

Claude Desktopclaude_desktop_config.json%APPDATA%Claude sous Windows, ~/Library/Application Support/Claude/ sous macOS

Cursor~/.cursor/mcp.json

Redémarrez ensuite complètement l’application. Les serveurs MCP sont connectés au démarrage : recharger la fenêtre ne suffit pas.

Ou depuis le terminal

Si vous avez installé Claude Code en ligne de commande, cette commande fait la même chose en une étape. Elle ne fonctionne pas dans l’extension VS Code, qui n’a pas de commande claude : utilisez plutôt le fichier de configuration ci-dessus.

claude mcp add occult-api -e OCCULT_API_KEY=yt_live_your_key_here -- npx -y occult-api-mcp

Ce que peut faire l’assistant

Cinq outils couvrent les 299 endpoints et les 330 calculs. Il n’y a volontairement pas un outil par endpoint : chaque outil occupe le contexte du modèle à chaque message, et 299 outils satureraient la conversation avant même votre première question. L’assistant fait donc une recherche.

check_accountGratuit

Vérifie que la clé fonctionne et indique le solde de crédits. En cas d’échec, demandez d’abord à l’assistant de lancer cet outil : il distingue une clé invalide d’un solde vide.

search_endpointsGratuit

Trouve un calcul par son nom ou par sa fonction. « manglik » donne un résultat même si aucun endpoint ne porte ce nom : la recherche porte sur tous les calculs nommés, pas seulement sur les noms d’endpoints.

describe_endpointGratuit

Les champs de requête exacts, les valeurs acceptées par chacun et un corps de requête validé sur un serveur en service.

call_endpoint1 à 25 crédits

Lance n’importe quel endpoint, à son prix : un crédit pour la plupart, 25 pour les rapports PDF et le chat IA. Les requêtes en échec ne sont pas facturées.

get_panchanga1 crédit

Un raccourci dédié à la requête la plus courante, pour que l’assistant n’ait pas à la chercher d’abord.

Ce que ça coûte

Exactement le prix d’un appel HTTP direct : un crédit par calcul réussi (25 pour les rapports PDF et le chat IA), rien pour une requête en échec. Rechercher et lire la documentation est gratuit : un assistant peut explorer toute l’API sans rien dépenser. Le solde est renvoyé à chaque appel, et vous êtes averti quand il passe sous 50 crédits.

À propos de votre clé

La clé reste sur votre machine. Elle est lue dans l’environnement, envoyée à l’API dans un en-tête et jamais montrée au modèle : l’assistant voit les résultats, jamais l’identifiant.

Elle reste un identifiant côté serveur : quiconque la détient peut dépenser vos crédits. Ne la mettez pas dans des configurations partagées ni dans des dépôts, et renouvelez-la depuis la page Clés si vous pensez qu’elle a fuité.

En cas de problème

« Your Occult API key is invalid, revoked, or expired »: Créez une nouvelle clé, mettez à jour le bloc env et redémarrez l’application. Les serveurs MCP ne lisent leur environnement qu’une fois, au démarrage.
« claude » n’est pas reconnu en tant que commande: Vous utilisez l’extension VS Code, qui n’installe pas de commande claude. Utilisez le fichier de configuration ci-dessus : il fait exactement la même chose.
Le serveur n’apparaît pas du tout: Vérifiez que le JSON est valide, puis redémarrez complètement l’application. Les erreurs de démarrage vont dans le journal MCP du client, pas dans la conversation.
L’assistant ne trouve pas un calcul: Essayez le nom sanskrit : « kundli » plutôt que « thème natal ». Tous les calculs sont listés dans la référence.

Obtenir une clé API Voir sur npm Code source sur GitHub