MCP pour agents IA

L'API est aussi disponible sous forme de serveur MCP (Model Context Protocol), pour que les assistants et agents IA comme Claude, ChatGPT ou Cursor puissent l'utiliser comme outil natif. Ajoutez-la comme connecteur avec cette URL, sans clé API ni inscription :

https://api.sunrise-sunset.org/mcp

C'est un serveur sans état (transport Streamable HTTP) avec deux outils : get_sun_times renvoie tout ce qui est documenté dans l'API pour une journée, et get_sun_times_range couvre jusqu'à 366 jours consécutifs en un seul appel. Les données et l'exigence d'attribution sont les mêmes que pour le reste de l'API.

Comment le connecter

• Dans Claude (claude.ai ou les applications) : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, puis collez l'URL ci-dessus.
• Dans Claude Code, depuis le terminal :
  claude mcp add --transport http sunrise-sunset https://api.sunrise-sunset.org/mcp
• Dans ChatGPT : Paramètres → Applications et connecteurs → Paramètres avancés → Mode développeur, puis ajoutez l'URL comme connecteur personnalisé.
• Tout autre client compatible MCP fonctionne aussi : c'est un serveur MCP distant standard sur Streamable HTTP, sans authentification.

Idées de questions une fois connecté

• “À quelle heure est l'heure dorée demain à Paris ?”
• “Combien de lumière du jour Oslo perd-elle en novembre ?”
• “Quelles nuits de ce mois seront les plus sombres pour observer les étoiles à Tenerife ?”

Les outils renvoient les mêmes données que notre API de lever et coucher du soleil : toutes les définitions de champs documentées là-bas s'appliquent aussi ici.

Le service est gratuit, avec la même exigence d'attribution que l'API : affichez un lien visible vers sunrise-sunset.org partout où vous montrez les données.

Contact

N'hésitez pas à nous contacter pour toutes vos questions relatives à l'API.