Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
VOXFACTURA_API_KEYYesTa clé API (obligatoire)
VOXFACTURA_API_BASE_URLNoURL de l'APIhttps://voxfacture-production.up.railway.app

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
factures_impayeesA

Liste les factures impayées (envoyées, partiellement payées, en retard).

facturesB

Liste les factures émises, éventuellement filtrées par statut ou chantier (chantier_id = numéro du chantier dans le compte).

factureA

Détail d'une facture (lignes comprises) par son numéro dans le compte (le champ id renvoyé par la liste des factures).

depensesC

Liste les dépenses (factures de frais), filtrables par chantier (numéro du chantier dans le compte) ou catégorie.

chantiersB

Liste les chantiers, éventuellement filtrés par statut (en_cours, termine…) ou par client (client_id = numéro du client dans le compte).

chantierA

Détail d'un chantier par son numéro dans le compte (le champ id renvoyé par la liste des chantiers).

clientsA

Liste les clients, avec une recherche textuelle optionnelle.

marge_chantierB

Marge d'un chantier (par son numéro dans le compte) : chiffre d'affaires facturé moins les dépenses. Nécessite une clé avec les permissions factures + dépenses.

recap_tvaA

Récapitulatif TVA sur une période (dates AAAA-MM-JJ) : collectée, déductible, TVA nette. Nécessite la permission comptabilité.

journal_ventesB

Journal des ventes sur une période (dates AAAA-MM-JJ) : une écriture par facture et avoir. Nécessite la permission comptabilité.

journal_achatsB

Journal des achats sur une période (dates AAAA-MM-JJ) : une écriture par dépense. Nécessite la permission comptabilité.

export_fecB

Fichier des écritures comptables (FEC, texte tabulé) de l'année, à remettre à l'expert-comptable. Nécessite la permission comptabilité.

creer_devis_brouillonA

Crée un devis en BROUILLON (permission devis:write). client_id et chantier_id sont les numéros du client et du chantier dans le compte. Chaque ligne : {designation, quantite, unite, prix_unitaire_ht, taux_tva}, plus en option prestation_id (numéro de la prestation du catalogue) et nature (« bien » pour une vente, « service » sinon ; omise, elle suit la prestation du catalogue puis le réglage du compte). validite_jours : durée de validité (omis = celle réglée sur le compte, 30 jours par défaut). delai_execution : délai imprimé sur le devis (ex. « 3 semaines après acceptation »). Le devis n'est jamais envoyé automatiquement : l'artisan le relit et l'envoie dans VoxFactura. Son numero est nul tant qu'il est brouillon : le numéro définitif lui est attribué à l'envoi.

marquer_facture_payeeA

Marque une facture payée (permission payments:write). facture_id = numéro de la facture dans le compte. montant (texte, ex. « 500.00 ») pour un paiement partiel ; vide = solde le total.

ajouter_depenseC

Ajoute une dépense (permission expenses:write). Montants en texte (ex. « 240.00 »). Rattache à un chantier via chantier_id (numéro du chantier dans le compte).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 15 tools

Disambiguation4/5

Most tools target clearly distinct resources or views: factures vs facture, chantiers vs chantier, depenses vs journal_achats, etc. The singular/plural list-detail pairs and the subset relationship between factures and factures_impayees create some potential confusion, but descriptions make the boundaries usable.

Naming Consistency3/5

The set mixes bare French nouns (factures, chantiers, clients), compound nouns (marge_chantier, journal_ventes, recap_tva), and imperative verb phrases (creer_devis_brouillon, marquer_facture_payee, ajouter_depense). Singular/plural is used meaningfully for list vs detail, but there is no single predictable verb_noun convention.

Tool Count5/5

Fifteen tools sit in the upper end of the well-scoped range, but each tool has a clear role in the invoicing/accounting workflow. There is no obvious filler or redundant read-only tool.

Completeness3/5

The surface covers listing/detail reads, accounting journals, VAT summaries, FEC export, expense entry, payment marking, and draft quote creation. However, it lacks create/update/delete operations for clients, chantiers, and invoices, and the quote lifecycle stops at draft creation, which are notable gaps for an invoicing/accounting domain.

Maintenance

ActivityMaintained
ResponsivenessNo issues