Linky MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LINKY_PRM | No | Numéro du compteur, 14 chiffres (obligatoire, sauf s'il est fourni via LINKY_SECRETS_FILE). | |
| LINKY_TOKEN | No | Jeton Conso API (obligatoire, sauf s'il est fourni via LINKY_SECRETS_FILE). | |
| LINKY_BASE_URL | No | Autre adresse d'API, pour les tests (facultatif). | |
| LINKY_MCP_HOST | No | En mode http : adresse d'écoute. | 127.0.0.1 |
| LINKY_MCP_PORT | No | En mode http : port d'écoute. | 8791 |
| LINKY_MCP_HOTES | No | En mode http : noms d'hôte publics. | |
| LINKY_MCP_ISSUER | No | En mode http : serveur d'autorisation (obligatoire). | |
| LINKY_MCP_JOURNAL | No | Emplacement du journal (facultatif ; par défaut ~/.nexaura/journal/linky.jsonl). | |
| LINKY_MCP_JWKS_URL | No | En mode http : adresse des clés publiques (sinon trouvée par RFC 8414). | |
| LINKY_MCP_RESOURCE | No | En mode http : adresse publique de ce MCP (obligatoire). | |
| LINKY_SECRETS_FILE | No | Chemin du fichier privé des accès (facultatif, ~ accepté). Le fichier doit contenir LINKY_TOKEN et LINKY_PRM. | |
| LINKY_MCP_TRANSPORT | No | Transport : stdio (défaut) ou http. | stdio |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| conso_veilleA | Dit combien d'électricité le foyer a consommé hier, en kWh (kilowattheures). À utiliser pour « combien j'ai consommé hier ? ». Lecture seule. |
| conso_periodeA | Donne la consommation d'électricité jour par jour, en kWh, entre deux dates incluses, avec le total et la moyenne. Dates au format AAAA-MM-JJ (exemple 2026-05-01). Jusqu'à 366 jours, jusqu'à hier au plus tard. Lecture seule. |
| courbe_chargeA | Donne la consommation toutes les 30 minutes (puissance moyenne en watts et énergie en kWh). Sans dates : hier. 7 jours au plus. Dates au format AAAA-MM-JJ, incluses. Marche seulement si le client a activé l'enregistrement de la courbe de charge chez Enedis. Lecture seule. |
| puissance_maxA | Donne la puissance maximale atteinte chaque jour (en VA) et le jour le plus fort de la période. Utile pour savoir si l'abonnement est trop petit ou trop grand. Sans dates : hier. Dates au format AAAA-MM-JJ, incluses. Lecture seule. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
The four tools target distinct query types: yesterday's total, a date-range daily series, a 30-minute load curve, and daily maximum power. The only overlap is that conso_veille is effectively a one-day convenience subset of conso_periode, but the descriptions clearly steer usage.
All tool names use French noun phrases in snake_case (conso_veille, conso_periode, courbe_charge, puissance_max), which is consistent and readable. They do not follow a verb_noun pattern, but that is reasonable for a read-only server.
Four tools is well-scoped for a Linky consumption reader: each provides a distinct view of consumption or power. No tool feels redundant or unnecessary.
The surface covers core consumption use cases: yesterday's total, date-range daily totals, load curve detail, and maximum power. Minor gaps exist, such as no explicit today/real-time query or cost/aggregate insights, but agents can work around them.