urssaf-vigilance-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| URSSAF_ENV | No | Environnement : `production` (api.urssaf.fr) ou `sandbox` (api-edi.urssaf.fr, défaut). | sandbox |
| URSSAF_MOCK | No | `1` : réponses simulées, sans réseau ni identifiants. | |
| URSSAF_DOMAINE | No | `URSSAF` (défaut : employeurs et toutes catégories) ou `ISU` (artisans, commerçants, indépendants). | URSSAF |
| URSSAF_TIMEOUT | No | Délai HTTP en secondes (30). | 30 |
| URSSAF_ECRITURE | No | `1` pour autoriser `suivi_verifier(ecrire=True)` à modifier le classeur. Désactivé par défaut. | 0 |
| URSSAF_CLIENT_ID | No | Identifiant OAuth2 (client-id) reçu de l'Urssaf. | |
| URSSAF_CLIENT_SECRET | No | Secret OAuth2 (client-secret) reçu de l'Urssaf. | |
| URSSAF_FEUILLE_SUIVI | No | Nom de la feuille ; sinon la première feuille contenant les en-têtes attendus est utilisée. | |
| URSSAF_FICHIER_SUIVI | No | Chemin du classeur Excel de suivi utilisé par défaut par `suivi_*`. |
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 |
|---|---|
| verifier_attestationA | Vérifie un code de sécurité (15 caractères) auprès de l'Urssaf. Renvoie le statut normalisé : valide | perimee (avec perimee_depuis) | inconnue (fraude possible) |
incomplete | erreur, et pour une attestation valide : nature, dénomination, organisme, date de
certification, SIREN, SIRET des établissements, dernière période analysée, effectif, masse salariale.
|
| verifier_attestationsA | Vérifie plusieurs codes de sécurité (lots de 100 par appel API). Renvoie un résultat par code. |
| lire_attestation_pdfB | Extrait les données d'un PDF d'attestation de vigilance Urssaf (sans appel réseau). Renvoie code de sécurité, SIREN, raison sociale, organisme émetteur, date de délivrance, date « à jour au » (fin de période analysée), effectif, masse salariale, SIRET des établissements. |
| controler_attestationA | Contrôle complet d'une attestation reçue : lecture du PDF, vérification du code auprès de l'Urssaf, cohérence champ à champ (SIREN, SIRET, période, effectif, masse salariale), cocontractant attendu (siret_attendu / siren_attendu) et fin de validité (6 mois après la période analysée, fin de mois). Renvoie verdict OK | ALERTE (échéance < 30 j ou écarts mineurs) | REFUS (code inconnu, périmée, SIRET absent…). |
| suivi_listerA | Lit le tableau Excel « Suivi des attestations par entreprise » : une entrée par ligne (opération, lot,
entreprise, date d'attestation, échéance, statut, code de sécurité, texte de vérification) et la liste des
codes uniques. |
| suivi_verifierA | Vérifie auprès de l'Urssaf les codes du tableau de suivi (par défaut seulement ceux non encore
vérifiés ; |
| suivi_creer_modeleA | Crée un classeur Excel de suivi vierge (colonnes Opération, Lot, Entreprise, SIRET attendu, dates, statut, contact, code de sécurité, vérification) à l'emplacement indiqué. Refuse d'écraser un fichier existant. |
| etat_connecteurB | Configuration courante (sans secrets) : environnement, mode mock, fichier de suivi, écriture, version. |
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 8 tools
verifier_attestation and verifier_attestations differ only by a trailing 's', which is a real misselection risk despite the batch description. controler_attestation also overlaps heavily with lire_attestation_pdf + verifier_attestation since it performs both internally, though its composite verdict purpose is described. The suivi_* group is reasonably distinct.
The attestation tools use verb_noun (verifier_attestation, lire_attestation_pdf, controler_attestation) while the tracking tools invert to noun_verb (suivi_lister, suivi_verifier, suivi_creer_modele). Names remain readable and grouped by prefix, but the mixed verb/noun ordering and singular/plural pair deviate from a single convention.
Eight tools is well within the ideal 3-15 range and each covers a distinct step (single check, batch check, PDF extraction, full control, listing, batch verification, template creation, connector status). No filler tools.
The surface covers the full attestation lifecycle: extraction, verification, cross-check verdicts, Excel tracking, batch re-verification, template creation, and connector config. Minor gaps like updating/removing individual tracking rows or exporting results are not surfaced but can be worked around.