Données
Citoyen pour les agents IA et les développeurs
Les chiffres de Citoyen se lisent aussi par les assistants IA et les programmes, pas seulement à l’écran. Un serveur public, en lecture seule, leur donne les mêmes séries que les cartes, chacune avec son producteur officiel, sa période et son unité : une réponse peut ainsi dire d’où vient un chiffre.
Le serveur MCP
Le Model Context Protocol (MCP) est le standard qu’utilisent des assistants comme Claude ou ChatGPT pour appeler des outils extérieurs. Le serveur de Citoyen est gratuit, sans clé ni compte, et ne fait que lire : il ne garde rien des questions posées, il compte seulement les appels pour que le service reste disponible.
Adresse du serveur
https://citoyenapp.com/mcpLe brancher
Dans Claude
Sur claude.ai ou dans l’application de bureau : Réglages, Connecteurs, Ajouter un connecteur personnalisé, puis collez l’adresse du serveur.
Dans les autres assistants
ChatGPT en mode développeur et les autres assistants qui acceptent un serveur MCP distant : ajoutez un connecteur HTTP avec l’adresse du serveur.
Dans un éditeur de code
Cursor, VS Code, Claude Code et les outils semblables : ajoutez le serveur à leur configuration MCP, comme ci-dessous.
Configuration pour les clients qui lisent un fichier MCP :
{
"mcpServers": {
"citoyen": {
"type": "http",
"url": "https://citoyenapp.com/mcp"
}
}
}Les outils
- search
- Trouve les indicateurs avec leur code, les pays nommés dans la question et les publications liées.
- get_series
- La série d’un indicateur pour un pays, telle que la trace sa carte : valeurs par période, unité, producteur et lien vers la source. Dix dernières années par défaut.
- compare_countries
- Un indicateur pour 2 à 8 pays, tiré d’une seule source harmonisée pour que les valeurs soient comparables.
- get_ranking
- Tous les pays couverts classés sur un indicateur, pour la dernière période qu’ils partagent, de la valeur la plus haute à la plus basse.
- get_publication
- Les points clés d’une note de synthèse, d’une analyse ou d’une fiche réforme, avec le lien vers le texte complet.
- get_release_calendar
- Les prochaines publications des séries : dates officielles du producteur ou fenêtres estimées.
Limites et règles
- 60 appels par minute et par adresse. Au-delà, le serveur demande de réessayer un peu plus tard.
- Les séries couvrent dix ans par défaut (jusqu’à 80 sur demande, 600 points au plus par réponse) ; une comparaison porte sur 2 à 8 pays.
- Les séries de producteurs privés, et les séries militaires que le SIPRI publie par la Banque mondiale, ne donnent que leur dernière valeur et le lien vers la carte : leurs conditions ne permettent pas de transmettre la série complète.
- Les publications donnent leurs points clés et le lien, jamais le texte complet.
- Les valeurs marquées comme projetées sont des prévisions, jamais des chiffres réalisés.
- Chaque réponse nomme son producteur : citez-le, avec le lien vers la page Citoyen donnée dans la réponse.
- Les appels sont comptés par jour sous une clé anonyme dérivée de l’adresse IP, qui change chaque jour ; l’adresse elle-même n'est jamais conservée et les comptes sont gardés 30 jours.
Autres accès
- Chaque page d’indicateur propose sa série en CSV : ajoutez /data.csv à son adresse (sauf pour les séries de producteurs privés).
- Un plan du site en texte brut pour les robots des assistants IA : /llms.txt
- Toute carte peut s’intégrer dans un autre site avec son bouton « Intégrer ».
Citer
Citez le producteur officiel nommé avec chaque chiffre, et Citoyen comme l’endroit où il a été lu, avec le lien vers sa page.
Les sélections, contrôles et textes de Citoyen sont protégés, et l’extraction systématique de sa base n’est pas permise. Le détail : Mentions légales